Skip to documentation
DOCUMENTATIONAPI referenceProductsGet market prices
PRODUCTS / V1

Get market prices

Read per-SKU observations with condition, variant and language. Missing observations never become invented zero prices.

GET/v1/products/{productId}/prices
Bearer key requiredJSON response
Example requestv1
curl --request GET --max-time 35 \  --url 'https://pokepos-market-api.vercel.app/v1/products/704860/prices' \  --header "Authorization: Bearer $CARDCOUNTER_API_KEY"
Response illustrative JSON
{  "source": "tcgplayer-public-site",  "fetchedAt": "2026-10-04T12:30:00.000Z",  "cacheHit": false,  "productId": 704860,  "currency": "USD",  "prices": [    {      "skuId": 123,      "condition": "Near Mint",      "variant": "Holofoil",      "language": "English",      "marketPrice": 5.45,      "lowSalePrice": 3,      "highSalePrice": 8,      "sampleSize": 25,      "calculatedAt": "2026-10-04T12:30:00.000Z"    }  ],  "priceCoverage": {    "requestedSkuIds": [      123    ],    "missingSkuIds": []  }}
Example values can change with the source.
REQUEST

Parameters

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

productIdintegerrequiredpath

Positive numeric TCGplayer product ID, up to ten digits. Range: 1–9999999999. Example: 704860.

RESPONSE

Response object

Get market prices The root schema is PricesResult.

sourcestringrequired

Always tcgplayer-public-site.

fetchedAtstringrequired

Time this section was fetched, in ISO 8601 format.

cacheHitbooleanrequired

Whether a cached observation was served. Read fetchedAt and stale together.

staleboolean

Always true.

codestring

Machine-readable status or error code.

upstreamStatusinteger | null

HTTP status reported by an upstream source, when known.

productIdintegerrequired

Numeric ID for the exact catalog product.

currencystringrequired

Always USD.

pricesPrice[]required

Market price observations grouped by SKU.

priceCoveragePriceCoverage | nullrequired

Requested and missing SKU IDs; missing rows are not authoritative zero-price observations.

SCHEMAS

Related objects

Expand a type to inspect its fields.

Price9 fields
skuIdintegerrequired

Numeric ID of one condition and variant combination.

conditionstring | nullrequired

Card condition associated with this SKU or offer.

variantstring | nullrequired

Printing finish or variant associated with this SKU or offer.

languagestring | nullrequired

Language associated with this SKU or offer.

marketPricenumber | nullrequired

USD decimal dollars. Null means no usable observation, not zero.

lowSalePricenumber | nullrequired

USD decimal dollars. Null means no usable observation, not zero.

highSalePricenumber | nullrequired

USD decimal dollars. Null means no usable observation, not zero.

sampleSizeinteger | nullrequired

Number of observations used by the source calculation.

calculatedAtstring | nullrequired

Time the source calculated this price.

PriceCoverage2 fields
requestedSkuIdsinteger[]required

SKU IDs requested for this product.

missingSkuIdsinteger[]required

Requested SKU IDs for which the source returned no row.

HTTP

Status codes

200

Get market prices

400

Check route parameters or the JSON body.

401

Account-backed key is invalid, inactive, expired or revoked.

404

Unknown route.

405

Use the method published for this route.

429

Quota or admission limit; inspect error.code and Retry-After.

500

Request failed; preserve x-request-id for support.

502

The source returned an error. Source 404 may map to API 404.

503

Account access store is unavailable or misconfigured.

504

Source request exceeded its budget.

Errors use error.code and error.message. Keep x-request-id for tracing. Read the error code catalog and examples.

Response headers

x-request-id

Request ID for tracing and support.

x-plan

Plan for admitted account-backed requests.

x-ratelimit-limit

Account allowance per UTC minute.

x-ratelimit-remaining

Remaining requests in the UTC minute.

x-monthly-limit

Account allowance per UTC month.

x-monthly-remaining

Remaining requests in the UTC month.

Retry-After

Nonnegative seconds until retry is useful for quota, cooldown or admission failures.

Success, empty, partial, stale and error examples
200 · success
{
  "source": "tcgplayer-public-site",
  "fetchedAt": "2026-10-04T12:30:00.000Z",
  "cacheHit": false,
  "productId": 704860,
  "currency": "USD",
  "prices": [
    {
      "skuId": 123,
      "condition": "Near Mint",
      "variant": "Holofoil",
      "language": "English",
      "marketPrice": 5.45,
      "lowSalePrice": 3,
      "highSalePrice": 8,
      "sampleSize": 25,
      "calculatedAt": "2026-10-04T12:30:00.000Z"
    }
  ],
  "priceCoverage": {
    "requestedSkuIds": [
      123
    ],
    "missingSkuIds": []
  }
}
200 · empty
{
  "source": "tcgplayer-public-site",
  "fetchedAt": "2026-10-04T12:30:00.000Z",
  "cacheHit": false,
  "productId": 704860,
  "currency": "USD",
  "prices": [],
  "priceCoverage": {
    "requestedSkuIds": [
      123
    ],
    "missingSkuIds": [
      123
    ]
  }
}
400 · INVALID_INPUT
{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Check route parameters or the JSON body."
  }
}
401 · INVALID_API_KEY
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Account-backed key is invalid, inactive, expired or revoked."
  }
}
401 · UNAUTHORIZED
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The optional local single-key credential is missing or invalid."
  }
}
404 · NOT_FOUND
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Unknown route."
  }
}
404 · IMAGE_NOT_AVAILABLE
{
  "error": {
    "code": "IMAGE_NOT_AVAILABLE",
    "message": "No source image is available for this product."
  }
}
405 · METHOD_NOT_ALLOWED
{
  "error": {
    "code": "METHOD_NOT_ALLOWED",
    "message": "Use the method published for this route."
  }
}
429 · RATE_LIMITED
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Minute allowance exhausted; use Retry-After."
  }
}
429 · MONTHLY_QUOTA_EXCEEDED
{
  "error": {
    "code": "MONTHLY_QUOTA_EXCEEDED",
    "message": "Monthly allowance exhausted; retry after the next UTC month."
  }
}
429 · AUTH_RATE_LIMITED
{
  "error": {
    "code": "AUTH_RATE_LIMITED",
    "message": "Authentication admission limit reached."
  }
}
429 · DIAGNOSTIC_RATE_LIMITED
{
  "error": {
    "code": "DIAGNOSTIC_RATE_LIMITED",
    "message": "Usage diagnostic rate limit reached."
  }
}
500 · INTERNAL_ERROR
{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Request failed; preserve x-request-id for support."
  }
}
502 · UPSTREAM_HTTP_status
{
  "error": {
    "code": "UPSTREAM_HTTP_503",
    "message": "The source returned an error. Source 404 may map to API 404."
  }
}
502 · UPSTREAM_INVALID_RESPONSE
{
  "error": {
    "code": "UPSTREAM_INVALID_RESPONSE",
    "message": "Source data failed response or identity validation."
  }
}
502 · UPSTREAM_RESPONSE_TOO_LARGE
{
  "error": {
    "code": "UPSTREAM_RESPONSE_TOO_LARGE",
    "message": "Source or aggregate API response exceeds the byte limit."
  }
}
502 · UPSTREAM_NETWORK_ERROR
{
  "error": {
    "code": "UPSTREAM_NETWORK_ERROR",
    "message": "Source transport failed."
  }
}
502 · UPSTREAM_CANCELED
{
  "error": {
    "code": "UPSTREAM_CANCELED",
    "message": "Source work was canceled."
  }
}
503 · ACCESS_STORE_UNAVAILABLE
{
  "error": {
    "code": "ACCESS_STORE_UNAVAILABLE",
    "message": "Account access store is unavailable or misconfigured."
  }
}
503 · USAGE_UNAVAILABLE
{
  "error": {
    "code": "USAGE_UNAVAILABLE",
    "message": "Usage diagnostics require account-backed mode."
  }
}
503 · SERVICE_BUSY
{
  "error": {
    "code": "SERVICE_BUSY",
    "message": "Service admission capacity exhausted; use Retry-After."
  }
}
503 · ACCESS_BUSY
{
  "error": {
    "code": "ACCESS_BUSY",
    "message": "Database authorization capacity exhausted; use Retry-After."
  }
}
503 · UPSTREAM_BUSY
{
  "error": {
    "code": "UPSTREAM_BUSY",
    "message": "Source queue is full; use Retry-After."
  }
}
503 · OCR_BUSY
{
  "error": {
    "code": "OCR_BUSY",
    "message": "Photo recognition queue is full; use Retry-After."
  }
}
503 · OCR_UNAVAILABLE
{
  "error": {
    "code": "OCR_UNAVAILABLE",
    "message": "Photo recognition is unavailable."
  }
}
504 · UPSTREAM_TIMEOUT
{
  "error": {
    "code": "UPSTREAM_TIMEOUT",
    "message": "Source request exceeded its budget."
  }
}
504 · OCR_TIMEOUT
{
  "error": {
    "code": "OCR_TIMEOUT",
    "message": "Photo recognition exceeded its processing budget."
  }
}
504 · REQUEST_DEADLINE_EXCEEDED
{
  "error": {
    "code": "REQUEST_DEADLINE_EXCEEDED",
    "message": "Total request deadline exceeded."
  }
}