API_Reference

Documentation

One API for TCGPlayer, eBay, and CardMarket prices. Query US + EU, raw + graded tiers, and history data from one schema built for apps, dashboards, alerts, and AI workflows.

Cards

Search cards with TCGPlayer market prices, eBay sold listings, CardMarket trends, graded tiers, and history data.

Sets

Navigate release metadata, card counts, and set slugs for catalog and cards queries.

Auth

See plan access, request limits, and API key setup for Free, Pro, and Scale.

LLM

Use structured market data in assistants, agents, enrichment jobs, and trading workflows.

Base URL: api.poketrace.com/v1 · Auth: X-API-Key · Free: 250/day (US, Raw) · Pro: 10k/day (+ EU, Graded) · Scale: 100k/day

Quick Start

Get up and running with the PokeTrace API in under 5 minutes. Access real-time pricing data for over 60,000 Pokemon cards including PSA, BGS, and CGC graded values from US and EU markets. Check API status at status.poketrace.com.

approxSaleCount tells you whether a source uses an approximate sale count. This is useful for unstable sold-listing sources such as ebay, where revoked, removed, or reclassified listings can change the visible count after the initial sale. Stable marketplace sources return approxSaleCount: false.

Get API Key

Add Header

Include X-API-Key in requests

Query Data

Access cards, sets, and pricing

quick_start

# Get your API key from the dashboard
# Then use your key to query cards
curl -H "X-API-Key: YOUR_KEY" \
  https://api.poketrace.com/v1/cards/019bff77-befa-771d-bab0-f5909f0a78c9

Response 200 OK

// US Card Example
{
  "data": {
    "id": "019bff77-befa-771d-bab0-f5909f0a78c9",
    "name": "Charizard ex",
    "cardNumber": "101/108",
    "set": { "slug": "obsidian-flames", "name": "Obsidian Flames" },
    "variant": "Holofoil",
    "rarity": "Ultra Rare",
    "game": "pokemon",
    "market": "US",
    "currency": "USD",
    "refs": { "tcgplayerId": "123456", "cardmarketId": null },
    "prices": {
      "ebay": {
        "PSA_10": { "avg": 1250, "low": 1180, "high": 1320, "saleCount": 12, "approxSaleCount": true, "avg1d": 1240, "avg7d": 1220, "avg30d": 1180 },
        "NEAR_MINT": { "avg": 180, "low": 150, "high": 220, "saleCount": 45, "approxSaleCount": true, "avg1d": 178, "avg7d": 175, "avg30d": 170 }
      },
      "tcgplayer": {
        "NEAR_MINT": { "avg": 165, "low": 140, "high": 195, "saleCount": 89, "approxSaleCount": false, "avg1d": 162, "avg7d": 160, "avg30d": 155 }
      }
    },
    "gradedOptions": ["PSA_10", "PSA_9", "CGC_9_5"],
    "conditionOptions": ["NEAR_MINT", "LIGHTLY_PLAYED"],
    "topPrice": 1250,
    "totalSaleCount": 146,
    "hasGraded": true,
    "lastUpdated": "2026-01-29T12:00:00Z"
  }
}
 
// EU Card Example
{
  "data": {
    "id": "eu_273550",
    "name": "Charizard ex",
    "cardNumber": "101/108",
    "set": { "slug": "obsidian-flames", "name": "Obsidian Flames" },
    "rarity": "Ultra Rare",
    "game": "pokemon",
    "market": "EU",
    "currency": "EUR",
    "refs": { "tcgplayerId": null, "cardmarketId": "273550" },
    "prices": {
      "cardmarket": { "avg": 145, "avg1d": 142, "avg7d": 140, "avg30d": 138 },
      "cardmarket_unsold": {
        "PSA_10": { "avg": 980, "low": 850, "high": 1200, "saleCount": 8, "approxSaleCount": false, "country": { "DE": { "avg": 950 }, "FR": { "avg": 1020 } } },
        "NEAR_MINT": { "avg": 165, "low": 120, "high": 280, "saleCount": 95, "approxSaleCount": false, "country": { "DE": { "avg": 155 }, "FR": { "avg": 175 }, "IT": { "avg": 160 } } }
      }
    },
    "gradedOptions": ["PSA_10", "CGC_9_5"],
    "conditionOptions": ["NEAR_MINT", "EXCELLENT"],
    "topPrice": 980,
    "totalSaleCount": 103,
    "hasGraded": true,
    "lastUpdated": "2026-01-29T12:00:00Z"
  }
}