API_Reference

Documentation

Complete API reference for accessing Pokemon card pricing data.

Base URL: api.poketrace.com/v1 · Auth: X-API-Key · Free tier: 500 requests/day · Pro: 100,000 requests/month

Quick Start

01

Get API Key

Get a free key from the pricing section

02

Add Header

Include X-API-Key

03

Query Data

Access endpoints

quick_start
# Get your API key from the pricing section on the homepage
# Then use your key to query cards
curl -H "X-API-Key: pc_your_key" \
  https://api.poketrace.com/v1/cards/cz_9921
Response 200 OK
{
"data": {
"id": "cz_9921",
"name": "Mega Charizard X ex",
"details": {
"cardNumber": "101/108",
"expansion": "Crown Zenith",
"setSlug": "pokemon-crown-zenith"
},
"tcgplayerId": "98765",
"image": "https://api.poketrace.com/public/images/cz_9921",
"lastUpdatedAt": "2025-01-17T12:00:00Z",
"period": "all",
"tiers": {
"PSA_10": {
"tier": "PSA_10",
"pricing": { "current": 1250.00, "low": 1180.00, "high": 1320.00, "median": 1250.00, "mean": 1245.00, "currency": "USD" },
"confidence": "high",
"confidencePercentage": 85,
"trend": "up",
"volatility": "2.4%",
"saleCount": 12,
"lastSaleDate": "2025-01-15",
"history": [{ "date": "2025-01-15", "price": 1280.00, "currency": "USD", "source": "eBay", "url": "https://..." }],
"historyTotal": 12,
"historyLocked": 7
}
}
}
}

LLM Integration

Use this prompt to help AI assistants integrate with the Poketrace API:

llm_integration_prompt

Health

Authentication

API keys are free (Hobbyist plan). Rate limits are enforced per key. Free plan resets daily at midnight UTC, Pro resets every 31 days.

Plans & Rate Limits

  • Free (Hobbyist)500/day
  • Pro Trader100,000/month

Free resets at midnight UTC. Pro resets 31 days from key issue.

Response Headers

  • X-RateLimit-Limit500
  • X-RateLimit-Remaining499
  • X-RateLimit-Reset2025-01-18T00:00:00Z
  • X-PlanFree

Cards

Sets

Prices & Listings

Webhooks

Receive real-time notifications when card prices change. Requires Enterprise plan.

Limits

  • EnterpriseUnlimited

Events

  • price.changed
  • price.spike
  • price.drop

Webhook Payload

webhook_payload
# Example webhook payload sent to your endpoint
Response 200 OK
{
"event": "price.spike",
"timestamp": "2025-01-17T12:00:00Z",
"card": {
"id": "bs_4",
"name": "Charizard",
"tier": "PSA_10"
},
"price": {
"previous": 1100.00,
"current": 1350.00,
"change": 22.7
}
}

Error Codes

CodeDescription
200Success
400Bad request
401Unauthorized - Invalid API key
403Forbidden
404Not found
429Rate limit exceeded

Tier Reference

Tier format: COMPANY_GRADE (e.g., PSA_10, BGS_9_5). Half grades use underscore (9.5 → 9_5).

Grading Companies & Grades

PSA
PSA_1PSA_1_5PSA_2PSA_2_5PSA_3PSA_3_5PSA_4PSA_4_5PSA_5PSA_5_5PSA_6PSA_6_5PSA_7PSA_7_5PSA_8PSA_8_5PSA_9PSA_9_5PSA_10
BGS
BGS_1BGS_1_5BGS_2BGS_2_5BGS_3BGS_3_5BGS_4BGS_4_5BGS_5BGS_5_5BGS_6BGS_6_5BGS_7BGS_7_5BGS_8BGS_8_5BGS_9BGS_9_5BGS_10
CGC
CGC_1CGC_1_5CGC_2CGC_2_5CGC_3CGC_3_5CGC_4CGC_4_5CGC_5CGC_5_5CGC_6CGC_6_5CGC_7CGC_7_5CGC_8CGC_8_5CGC_9CGC_9_5CGC_10
SGC
SGC_1SGC_1_5SGC_2SGC_3SGC_4SGC_5SGC_6SGC_7SGC_7_5SGC_8SGC_8_5SGC_9SGC_9_5SGC_10
ACE
ACE_1ACE_4ACE_5ACE_6ACE_7ACE_8ACE_9ACE_10
TAG
TAG_1TAG_1_5TAG_2_5TAG_3TAG_3_5TAG_4TAG_4_5TAG_5TAG_5_5TAG_6TAG_6_5TAG_7TAG_7_5TAG_8TAG_8_5TAG_9TAG_10

Ungraded / Raw

MINTNEAR_MINTLIGHTLY_PLAYEDMODERATELY_PLAYEDHEAVILY_PLAYEDDAMAGED