Skip to main content
GET
Get card prices
Every printing gets its own price history, and inside a printing you get one USD history per grade tier. A holo Charizard returns an ungraded series alongside a psa10 one for that same printing rather than a single history. See the card object for what separates a printing from a grade. ungraded is the tier to chart for a raw card. There is no condition axis: an ungraded price folds every condition into one figure, so nothing here asks what state a copy is in. The window defaults to the last 90 days. Pass from and to as YYYY-MM-DD for a different one, up to 366 days wide. A window that is malformed, inverted, or wider than that is a 400, not an empty result. The full history stays reachable one bounded window at a time.

Charting a range

Pass range instead of from and to to get a series ready to plot. Each preset ends today. A series starts at its first observation, so a printing first priced part way through the window returns fewer points than the table shows. Read the count off the response rather than assuming it. range and from/to are alternatives. Sending both is a 400.

Filling the gaps

A price is recorded only on the days it moved, so a printing that held steady all month has one underlying reading rather than thirty. Plotted directly that reads as missing data even though the price is known for every day. The response carries one point per day regardless: a day the price did not move carries the last price observed before it. A printing that has not moved inside the window is still a full series rather than dropping out of the response.

Where a series starts

A series begins on its own first observation and never earlier, even when from reaches further back. A price is not carried backwards to fill a window that starts before this printing was first seen: a flat line across days nothing was ever observed on reads as a market that did not move, which is a different claim from having no reading at all. That start date is the field to check when a chart looks shorter than the window asked for. Two tiers of the same printing can start on different days: a raw copy sells often enough to be priced continuously, while a graded one may first appear months later.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Query Parameters

from
string
to
string
range
string

A window ending today: 1W, 1M, 3M, 6M or 1Y. An alternative to from and to, and sending both is a 400.

Response

Card price history

data
object
required
error
object | null
required