PRODUCTS / V1

Get price history

Read chronological market price and sales volume buckets for each product SKU.

GET/v1/products/{productId}/history

Bearer key requiredJSON response

Example requestv1

01curl --request GET \02  --url 'https://pokepos-market-api.vercel.app/v1/products/704860/history?range=quarter' \03  --header 'Authorization: Bearer YOUR_API_KEY'

Response illustrative JSON

01{02  "source": "tcgplayer-public-site",03  "productId": 704860,04  "range": "quarter",05  "fetchedAt": "2026-09-29T12:30:00.000Z",06  "cacheHit": false,07  "variants": [08    {09      "skuId": 123,10      "condition": "Near Mint",11      "variant": "Holofoil",12      "averageDailyQuantitySold": 31,13      "totalQuantitySold": 2832,14      "buckets": [15        {16          "date": "2026-09-01",17          "marketPrice": 7.12,18          "quantitySold": 9819        }20      ]21    }22  ]23}

Example values can change with the source.

REQUEST

Parameters

Pass path parameters in the URL and query parameters after ?.

productIdintegerrequiredpath

Numeric TCGplayer product ID. Range: 1–any. Example: 716465.

rangestringquery

One, three, six, or twelve months of recorded history. Values: month, quarter, semi-annual, annual. Default: quarter.

RESPONSE

Response object

Chronological history buckets by SKU. The root schema is HistoryResult.

sourcestring

Name of the market data source.

productIdinteger

Numeric ID for the exact catalog product.

rangestring

Requested history time window.

fetchedAtstring

Time this section was fetched, in ISO 8601 format.

cacheHitboolean

Whether the response used a cached observation.

variantsHistoryVariant[]

Per-SKU market history series.

SCHEMAS

Related objects

Expand a type to inspect its fields.

HistoryVariant7 fields

skuIdinteger

Numeric ID of one condition and variant combination.

conditionstring | null

Card condition associated with this SKU or offer.

variantstring | null

Printing finish or variant associated with this SKU or offer.

languagestring | null

Language associated with this SKU or offer.

averageDailyQuantitySoldnumber | null

Average items sold per day in this range.

totalQuantitySoldinteger | null

Total items sold in this range.

bucketsHistoryBucket[]

Chronological price and sales observations.

HistoryBucket8 fields

datestring | null

Date of this history bucket.

marketPricenumber | null