Docs / Objects

History

What the history endpoints return.

The answer

Field	Type	Description
`timeframe`	string	The time frame you asked for: "7d", "30d", "3m", "6m" or "1y".
`cards`	array of history card objects	The cards found, in the order you asked for them.
`not_found`	array of string	The card_ids you asked for that don't exist.

History card

Field	Type	Description
`card_id`	string	Our permanent ID for this card.
`name`	string	The card's name.
`set`	string	The set the card is from.
`skus`	array of SKU history objects	History for each printing, condition and language.
`averages`	array of average sale objects	Average sale prices per printing, newest first within each printing.

SKU history

Field	Type	Description
`sku_id`	string	Our permanent ID for this SKU.
`printing`	string	The printing.
`condition`	string	The condition.
`language`	string	The language.
`average_daily_quantity_sold`	number or null	Average copies sold per day over the time frame, as reported. It can be a rounded whole number, so use quantity_sold for exact counts.
`history`	array of history rows	One row per period, newest first.

History row

Field	Type	Description
`date`	string	The first day this row covers (YYYY-MM-DD). Each row is one day for 7d and 30d, 3 days for 3m, and one week for 6m and 1y.
`market_price`	number or null	The market price on that date. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`sale_price_low`	number or null	The lowest sale price in that period, without shipping. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`sale_price_low_with_shipping`	number or null	The lowest sale price in that period, with shipping. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`sale_price_high`	number or null	The highest sale price in that period, without shipping. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`sale_price_high_with_shipping`	number or null	The highest sale price in that period, with shipping. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`quantity_sold`	integer or null	How many copies sold in that period.

Average sale

Field	Type	Description
`printing`	string	The printing these sales are for, across all conditions.
`date`	string	The first day this average covers (YYYY-MM-DD).
`average_sale_price`	number or null	The average sale price for that printing and period, as reported. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.