Get market prices
Read per-SKU observations with condition, variant and language. Missing observations never become invented zero prices.
/v1/products/{productId}/pricescurl --request GET --max-time 35 \ --url 'https://pokepos-market-api.vercel.app/v1/products/704860/prices' \ --header "Authorization: Bearer $CARDCOUNTER_API_KEY"{ "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": [] }}Parameters
Pass path parameters in the URL and query parameters after ?.
productIdintegerrequiredpathPositive numeric TCGplayer product ID, up to ten digits. Range: 1–9999999999. Example: 704860.
Response object
Get market prices The root schema is PricesResult.
sourcestringrequiredAlways tcgplayer-public-site.
fetchedAtstringrequiredTime this section was fetched, in ISO 8601 format.
cacheHitbooleanrequiredWhether a cached observation was served. Read fetchedAt and stale together.
stalebooleanAlways true.
codestringMachine-readable status or error code.
upstreamStatusinteger | nullHTTP status reported by an upstream source, when known.
productIdintegerrequiredNumeric ID for the exact catalog product.
currencystringrequiredAlways USD.
pricesPrice[]requiredMarket price observations grouped by SKU.
priceCoveragePriceCoverage | nullrequiredRequested and missing SKU IDs; missing rows are not authoritative zero-price observations.
Related objects
Expand a type to inspect its fields.
Price9 fields
skuIdintegerrequiredNumeric ID of one condition and variant combination.
conditionstring | nullrequiredCard condition associated with this SKU or offer.
variantstring | nullrequiredPrinting finish or variant associated with this SKU or offer.
languagestring | nullrequiredLanguage associated with this SKU or offer.
marketPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
lowSalePricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
highSalePricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
sampleSizeinteger | nullrequiredNumber of observations used by the source calculation.
calculatedAtstring | nullrequiredTime the source calculated this price.
PriceCoverage2 fields
requestedSkuIdsinteger[]requiredSKU IDs requested for this product.
missingSkuIdsinteger[]requiredRequested SKU IDs for which the source returned no row.
Status codes
Get market prices
Check route parameters or the JSON body.
Account-backed key is invalid, inactive, expired or revoked.
Unknown route.
Use the method published for this route.
Quota or admission limit; inspect error.code and Retry-After.
Request failed; preserve x-request-id for support.
The source returned an error. Source 404 may map to API 404.
Account access store is unavailable or misconfigured.
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-idRequest ID for tracing and support.
x-planPlan for admitted account-backed requests.
x-ratelimit-limitAccount allowance per UTC minute.
x-ratelimit-remainingRemaining requests in the UTC minute.
x-monthly-limitAccount allowance per UTC month.
x-monthly-remainingRemaining requests in the UTC month.
Retry-AfterNonnegative 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."
}
}