Pokémon Card Price Tracking API Documentation

Welcome to the developer hub for the PokemonPriceTracker API. Our powerful REST API offers programmatic access to extensive Pokémon TCG data, including our daily updated Pokemon card API endpoints, historical Pokemon card price API lookups, and overall market trends.

Daily Price UpdatesSet InformationMarket Trends

API Overview

The PokemonPriceTracker API is a robust solution for developers seeking programmatic access to comprehensive Pokémon card pricing data, market trends, and set information. Whether you're building collection trackers, marketplace applications, or investment analysis tools, our Pokemon API for developers offers RESTful endpoints with JSON responses. We support various use-cases, including access to daily updated current prices and deep historical data, with considerations for efficient bulk Pokemon card price API queries where applicable through our standard endpoints.

Base URL

https://www.pokemonpricetracker.com/api

Authentication

How to authenticate with the Pokémon card price API using your API key

All API requests to the PokéPrice Tracker API require authentication with an API key to access Pokémon card data. API keys are used to secure your requests and track your usage limits.

You can manage your API keys in the API Keys Dashboard section of your PokéPrice Tracker account.

Authentication Method

Headers

Include your API key in the Authorization header

# Include your API key in the Authorization header
curl -X GET \
  https://www.pokemonpricetracker.com/api/prices?name=Charizard \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

Pokémon card API request limits and quotas based on your subscription plan

The PokéPrice Tracker API has rate limits to ensure fair usage and system stability. These limits vary based on your subscription plan.

Subscription Plans and Limits

Free

200

requests per day

API (Non-Commercial)

20000

requests per day

Business

200000

requests per day

Important

All plans have a limit of 60 requests per minute

This per-minute throttling helps prevent abuse and ensures fair usage of the Pokémon card price API for all users.

Rate Limit Headers

Every API response includes headers with your current rate limit status:

X-RateLimit-Daily-Limit:

200

X-RateLimit-Daily-Remaining:

199

X-RateLimit-Daily-Reset:

1621036800

X-RateLimit-Minute-Limit:

X-RateLimit-Minute-Remaining:

X-RateLimit-Minute-Reset:

1621036860

Common API Workflows

Here’s a typical workflow to find specific card prices:

Discover Sets: Use the Sets API to fetch a list of all available Pokémon TCG sets. Each set entry will include an id (e.g., "swsh4" for Vivid Voltage).
```
GET /api/sets
```
List Cards in a Set: Once you have a setId, use the Card Prices API by passing the setId as a query parameter. This will return all cards belonging to that set.
```
GET /api/prices?setId=YOUR_SET_ID
```
From this response, you can identify the unique id for each card (e.g., "swsh4-20" for Charizard from Vivid Voltage).
Get Specific Card Prices: With a specific card id, query the Card Prices API again, this time using the card's id. This will give you detailed pricing information for that single card, including TCGPlayer, CardMarket, and eBay prices (which includes graded data like PSA 10, BGS 9.5, etc., under ebay.prices).
```
GET /api/prices?id=YOUR_CARD_ID
```

This approach allows you to navigate from a broad overview of sets down to the specific pricing details of an individual card.

Card Prices API

Access daily updated and historical Pokémon card prices, including graded card data (PSA, BGS, etc.) and comprehensive market data.

GET

The Card Prices API provides detailed pricing information for Pokémon TCG cards. This includes current market prices from various sources (TCGPlayer, CardMarket), historical trends, and data for graded cards (such as PSA, BGS, CGC) primarily sourced from eBay sales. This endpoint allows you to search and filter cards by various parameters.

Graded card prices (e.g., PSA 10, BGS 9.5) can be found within the ebay.prices object in the response, keyed by the grade (e.g., "PSA10", "BGS9.5").

You can use this endpoint to list all cards in a set (using the setId parameter, obtained from the Sets API) or to get specific card details by its unique id. See the Common API Workflows section for a step-by-step guide.

/api/prices

Query Parameters

Customize your Pokémon card price API requests with these query parameters. For example, use setId to list cards in a set, or id to fetch a specific card:

Query Parameters

Parameter	Type	Description	Example
name	string	Filter Pokémon cards by name (case-insensitive)	Charizard
setId	string	Filter cards by set ID (e.g., 'swsh4')	sv4
number	string	Filter by card number within a set	20
id	string	Get a specific card by its unique ID	swsh4-20
includeHistory	boolean	Include comprehensive price history data (default: false). Warning: Large response size.	true
limit	integer	Number of results per page (default: 50)	100
page	integer	Page number for pagination (default: 1)	2

Price History API

Access comprehensive historical price data for Pokémon cards, including PSA graded price history and raw card price trends from TCGPlayer and CardMarket.

Get Card with Full Price History

/api/cards/{cardId}

Returns complete card data including all price history (PSA graded prices, TCGPlayer, and CardMarket historical data).

curl -X GET \
  "https://www.pokemonpricetracker.com/api/cards/base1-4" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get PSA Price History Only

/api/cards/{cardId}/history?type=psa

Returns only PSA graded price history with sales velocity and anomaly detection data. Returns 404 if no PSA data exists for the card.

curl -X GET \
  "https://www.pokemonpricetracker.com/api/cards/base1-4/history?type=psa" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Raw Price History Only

/api/cards/{cardId}/history?type=raw

Returns only TCGPlayer and CardMarket price history for ungraded cards.

curl -X GET \
  "https://www.pokemonpricetracker.com/api/cards/base1-4/history?type=raw" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Price History with Date Range

/api/cards/{cardId}/history?startDate=2025-01-10&endDate=2025-01-17&type=psa|raw|all

Filter price history by date range and data type. Supports type parameter: psa, raw, or all.

curl -X GET \
  "https://www.pokemonpricetracker.com/api/cards/base1-4/history?startDate=2025-01-10&endDate=2025-01-17&type=all" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Bulk Price History (POST)

/api/cards/bulk-history

Get price history for multiple cards in a single request. Maximum 50 cards per request.

curl -X POST \
  "https://www.pokemonpricetracker.com/api/cards/bulk-history" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cardIds": ["base1-4", "base1-6", "jungle-1"],
    "type": "all",
    "startDate": "2025-01-10",
    "endDate": "2025-01-17"
  }'

Price History Data Structure

PSA Price History: Uses date-keyed objects with multiple grades per date, includes sales velocity and anomaly detection.

Raw Price History: Uses arrays of date-price objects, organized by condition (normal, holofoil, etc.) and price type (low, mid, high, market).

Anomaly Detection: PSA prices may include priceAdjusted, adjustmentReason, and originalValue fields when price anomalies are detected and corrected.

Error Responses

404 Not Found

The API returns 404 status codes in the following cases:

Card not found: When requesting a card ID that doesn't exist in our database
No data available: When requesting specific data types (e.g., PSA history) that don't exist for a card
Missing endpoints: When accessing non-existent API routes

Example 404 responses:

{"error": "Card not found"}

{"error": "No psa price history data available for this card"}

{"error": "No raw price history data available for this card"}

400 Bad Request

Invalid request parameters or malformed request body:

{"error": "cardIds array is required and must not be empty"}

{"error": "Maximum 50 cards can be requested at once"}

401 Unauthorized

Missing or invalid API key:

{"error": "Invalid API key"}

{"error": "API key required"}

Sets API

Retrieve information about Pokémon TCG card sets.

GET

The Sets API provides access to information about Pokémon TCG card sets. Currently, this endpoint returns a list of sets with their ID (e.g., "sv4") and name (e.g., "Scarlet & Violet—Paradox Rift").

You can use the id obtained from this endpoint with the Card Prices API (using its setId parameter) to list all cards within a specific set. See the Common API Workflows section for a step-by-step guide.

Note: The API currently returns a minimal set object. Future enhancements may include more detailed information per set, such as release dates, card counts, and images, directly from this endpoint.

/api/sets

Query Parameters

Customize your Pokémon TCG sets API requests with these parameters:

Query Parameters

Parameter	Type	Description	Example
name	string	Filter Pokémon card sets by name (case-insensitive)	Scarlet & Violet
sortBy	string	Sort by field (default: 'releaseDate', options: 'name', 'releaseDate')	releaseDate
sortOrder	string	Sort order (default: 'desc', options: 'asc', 'desc')	desc

Developer Support

Need help integrating our Pokémon card price API into your application? Our development team is here to help!

Contact Developer Support

Pokémon Card Price Tracking API Documentation

API Overview

Base URL

Authentication

Authentication Method

Authentication Examples in Multiple Languages

Rate Limits

Subscription Plans and Limits

Rate Limit Headers

Handling Rate Limits in Your Application

Common API Workflows

Card Prices API

Query Parameters

Query Parameters

Example API Requests for Pokémon Card Prices

Example Response with Card Price Data

Price History API

Get Card with Full Price History

Get PSA Price History Only

Get Raw Price History Only

Get Price History with Date Range

Get Bulk Price History (POST)

Price History Data Structure

Error Responses

Sets API

Query Parameters

Query Parameters

Example API Requests for Pokémon TCG Sets

Example Response with Set Data

Developer Support