New

Price Trends

See how a card's price moves over time — daily, weekly, or monthly candles with the high, low, median, and mean of real listings, kept separate for raw and graded copies

What This Does

Rolls a card's listings into daily, weekly, or monthly candles, each with mean, median, high, low, and listing count
Keeps raw (ungraded) and graded prices in separate series — graded results are grouped by company and grade — so a PSA 10 never blends into the raw line
Splits every candle by listing type: auction candles summarize completed sales (bid), Buy It Now candles summarize asking prices (ask)
Filter to a single parallel variant or grade, choose how far back to look, and pin the window to any past date
Echoes the values it actually applied and reports how many listings the outlier filter removed

When To Use This

Drawing a price chart on a card page without crunching individual listings yourself
Showing the bid/ask spread over time, or how a graded copy trends against a raw one
Tracking a numbered parallel separately from the base card
Powering "up X% over 90 days" style stats from the first and last candles

Real Example

Scenario

You want weekly price candles for the last 12 weeks of Shohei Ohtani's 2018 Topps Update rookie card

Sample Request

GET

/v1/pricing/23084701-7511-4aa3-8831-8dbddf4c2c8d/timeseries?interval=weekly&periods=12

What You Get Back

{
  "card": {
    "card_id": "23084701-7511-4aa3-8831-8dbddf4c2c8d",
    "name": "Shohei Ohtani",
    "number": "US1",
    "set": {
      "set_id": "...",
      "name": "Base Set",
      "year": "2018",
      "release": "2018 Topps Update"
    }
  },
  "query": {
    "interval": "weekly",
    "periods": 12,
    "as_of_date": "2026-09-10",
    "listing_type": "both"
  },
  "raw": {
    "candles": [
      {
        "period_start": "2026-08-24",
        "types": {
          "auction": {
            "mean": 14.2,
            "median": 13.5,
            "high": 22,
            "low": 9.99,
            "count": 11
          },
          "fixed": {
            "mean": 19.75,
            "median": 18.99,
            "high": 29.99,
            "low": 14.99,
            "count": 6
          }
        }
      },
      {
        "period_start": "2026-08-31",
        "types": {
          "auction": {
            "mean": 15.1,
            "median": 14,
            "high": 24.5,
            "low": 10.5,
            "count": 9
          }
        }
      }
    ],
    "totals": {
      "auction": {
        "total_count": 20,
        "filtered_count": 2
      },
      "fixed": {
        "total_count": 6,
        "filtered_count": 0
      }
    }
  },
  "graded": [
    {
      "company_name": "PSA",
      "company_id": "...",
      "grades": [
        {
          "grade_value": "10",
          "grade_id": "...",
          "candles": [
            {
              "period_start": "2026-08-31",
              "types": {
                "auction": {
                  "mean": 92.5,
                  "median": 90,
                  "high": 110,
                  "low": 80,
                  "count": 4
                }
              }
            }
          ],
          "totals": {
            "auction": {
              "total_count": 4,
              "filtered_count": 0
            }
          }
        }
      ]
    }
  ]
}