Everything you need to integrate Pokemon TCG pricing data into your application
The Pokemon TCG Market Intelligence API provides programmatic access to real-time pricing data for over 75,000 Pokemon cards. Get started in minutes with our simple REST API.
https://api.tradebinder.gg/v1All API requests require authentication using an API key. Include your API key in the Authorization header:
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.tradebinder.gg/v1/cards
Note: Keep your API keys secure and never commit them to public repositories. You can generate and manage your API keys from your dashboard.
/cardsRetrieve a list of Pokemon cards with current pricing data.
| name | Filter by card name (e.g., "Charizard") |
| set | Filter by set name (e.g., "Base Set") |
| limit | Number of results to return (default: 20, max: 100) |
| offset | Number of results to skip for pagination |
fetch('https://api.tradebinder.gg/v1/cards?name=Charizard&limit=10', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(res => res.json())
.then(data => console.log(data));{
"data": [
{
"id": 1,
"name": "Charizard",
"set": "Base Set",
"card_number": "4",
"variant": "Holo",
"current_price": 324.99,
"price_change_1d": 5.00,
"price_change_1d_pct": 1.57,
"price_change_7d": -12.50,
"price_change_7d_pct": -3.70,
"tcgplayer_id": "12345",
"image_url": "https://..."
}
],
"pagination": {
"total": 156,
"limit": 10,
"offset": 0
}
}/cards/:idGet detailed information about a specific card including full price history.
fetch('https://api.tradebinder.gg/v1/cards/1', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})/price-moversGet cards with the biggest price changes over different time periods.
| period | Time period: "1d", "7d", or "30d" (default: "1d") |
| direction | Movement direction: "up" or "down" (default: "up") |
| limit | Number of results (default: 20, max: 100) |
Track and value your Pokemon card collections programmatically. Perfect for portfolio management and AI-powered recommendations via MCP.
/collections-apiList all your collections with card counts.
fetch('https://api.tradebinder.gg/functions/v1/collections-api', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(res => res.json())
.then(data => console.log(data));{
"collections": [
{
"id": 1,
"name": "My Collection",
"description": "Your main card collection",
"is_default": true,
"total_cards": 145,
"unique_cards": 89,
"created_at": "2026-01-06T12:00:00Z"
}
]
}/collections-api/:idGet detailed information about a specific collection including all cards.
fetch('https://api.tradebinder.gg/functions/v1/collections-api/1', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})/collections-api/:id/valueCalculate the current market value of a collection with profit/loss tracking.
fetch('https://api.tradebinder.gg/functions/v1/collections-api/1/value', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(res => res.json())
.then(data => console.log(data));{
"collection_id": 1,
"collection_name": "My Collection",
"total_cards": 145,
"unique_cards": 89,
"total_value": 4523.50,
"total_cost": 3200.00,
"profit_loss": 1323.50,
"profit_loss_pct": 41.36,
"items": [
{
"card_name": "Charizard [Holo] #4",
"base_name": "Charizard",
"set_name": "Base Set",
"quantity": 1,
"current_price": 324.99,
"purchase_price": 250.00,
"current_value": 324.99,
"purchase_cost": 250.00,
"profit_loss": 74.99
}
]
}AI Integration: This endpoint is perfect for MCP queries like "What's my collection worth?" or "Which cards in my collection have increased the most in value?"
Rate limits vary by plan:
| Plan | Requests/Month | Rate Limit |
|---|---|---|
| Free | 1,000 | 10 req/min |
| Pro | 100,000 | 100 req/min |
| Enterprise | Unlimited | Custom |
The API uses standard HTTP status codes and returns error details in JSON format:
{
"error": {
"code": "invalid_api_key",
"message": "The API key provided is invalid or has been revoked",
"status": 401
}
}Connect your TradeBinder account to Claude, ChatGPT or any other MCP client and ask about your cards in plain English. It covers every game on TradeBinder: Pokémon, Magic: The Gathering and Sorcery.
MCP (Model Context Protocol) is how AI assistants use outside tools. Once connected, your assistant can read your collection, look up prices and add cards for you. For example:
There's nothing to install and no API key to copy. You add TradeBinder by URL and sign in with your normal TradeBinder account.
In Claude, go to Settings → Connectors → Add custom connector. In ChatGPT, add a new connector. Paste this URL:
https://www.tradebinder.gg/mcp
Your assistant opens a TradeBinder sign-in page. Log in and approve access. Use the same account you use on tradebinder.gg, or the assistant will see a different (likely empty) collection.
Try “What collections do I have?”. If it lists your collections, you're set. No restart needed.
Clients configured with a JSON file use the same URL:
{
"mcpServers": {
"tradebinder": {
"url": "https://www.tradebinder.gg/mcp"
}
}
}You don't call these yourself. Your assistant picks the right one from your question. They're listed so you know what it can do.
search_cardsSearch cards by name, set, game or price range.
get_cardDetails and current price for one card, plus gameplay data (colors, types, legality) for Magic and Sorcery.
get_bulk_card_metadataGameplay data for up to 100 cards at once.
get_card_variantsEvery variant of a card (Normal, Reverse Holo, Foil, Master Ball…) with prices.
get_bulk_card_variantsVariants for up to 100 cards at once.
get_price_historyA card's price history.
get_moversCards with the biggest recent price changes.
list_setsEvery set, across all games.
get_setOne set and all its cards.
list_collectionsYour collections.
get_collectionA collection's cards and value, with filters (game, set, color, price, storage location).
create_collectionCreate a collection.
add_to_collectionAdd a card to a collection.
batch_add_to_collectionAdd many cards in one go.
get_wantlistCards you're looking for, with current prices.
get_trade_binderCards you're offering for trade.
list_storage_containersYour binders, boxes and decks, with how many cards each holds.
get_storage_containerEverything filed in one binder, box or deck.
create_storage_containerCreate a binder, box or deck.
store_cardsRecord which binder, box or deck cards are in.