Skip to documentation
Developers
DOCUMENTATIONAPI referenceProductsGet market prices
PRODUCTS / V1

Get market prices

Read price observations for each SKU with its condition, variant, and language attached.

GET/v1/products/{productId}/prices
Bearer key requiredJSON response

A missing market observation is null, never zero. Price amounts are US dollars.

Example requestv1
curl --request GET \  --url 'https://pokepos-market-api.vercel.app/v1/products/704860/prices' \  --header 'Authorization: Bearer YOUR_API_KEY'
Response illustrative JSON
{  "source": "tcgplayer-public-site",  "productId": 704860,  "currency": "USD",  "fetchedAt": "2026-09-29T12:30:00.000Z",  "cacheHit": false,  "prices": [    {      "skuId": 123,      "condition": "Near Mint",      "variant": "Holofoil",      "language": "English",      "marketPrice": 5.45,      "lowSalePrice": 3,      "highSalePrice": 20.16,      "sampleSize": 2832,      "calculatedAt": "2026-09-29T12:30:00.000Z"    }  ]}
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.

RESPONSE

Response object

Per-SKU USD prices. The root schema is PricesResult.

sourcestring

Name of the market data source.

productIdinteger

Numeric ID for the exact catalog product.

currencystring

Always USD.

fetchedAtstring

Time this section was fetched, in ISO 8601 format.

cacheHitboolean

Whether the response used a cached observation.

pricesPrice[]

Market price observations grouped by SKU.

SCHEMAS

Related objects

Expand a type to inspect its fields.

Price9 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.

marketPricenumber | null

US dollars. Null means no observation is available.

lowSalePricenumber | null

US dollars. Null means no observation is available.

highSalePricenumber | null

US dollars. Null means no observation is available.

sampleSizeinteger | null

Number of observations used by the source calculation.

calculatedAtstring | null

Time the source calculated this price.

HTTP

Status codes

200

Per-SKU USD prices.

400

Invalid parameter or request body.

404

Product, route, or image not found.

502

An upstream market source is unavailable.

Errors use the error.code and error.message shape. Keep the x-request-id response header for support and tracing.

PREVIOUSGet product detailsNEXTGet price history