API Documentation

Everything you need to integrate Pokemon TCG pricing data into your application

Getting Started

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.

Base URL
https://api.tradebinder.gg/v1

Authentication

All 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.

Endpoints

GET/cards

Retrieve a list of Pokemon cards with current pricing data.

Query Parameters

nameFilter by card name (e.g., "Charizard")
setFilter by set name (e.g., "Base Set")
limitNumber of results to return (default: 20, max: 100)
offsetNumber of results to skip for pagination
Example Request
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));
Example Response
{
  "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
  }
}
GET/cards/:id

Get detailed information about a specific card including full price history.

Example Request
fetch('https://api.tradebinder.gg/v1/cards/1', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
GET/price-movers

Get cards with the biggest price changes over different time periods.

Query Parameters

periodTime period: "1d", "7d", or "30d" (default: "1d")
directionMovement direction: "up" or "down" (default: "up")
limitNumber of results (default: 20, max: 100)

Collections API

Track and value your Pokemon card collections programmatically. Perfect for portfolio management and AI-powered recommendations via MCP.

GET/collections-api

List all your collections with card counts.

Example Request
fetch('https://api.tradebinder.gg/functions/v1/collections-api', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(res => res.json())
.then(data => console.log(data));
Example Response
{
  "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"
    }
  ]
}
GET/collections-api/:id

Get detailed information about a specific collection including all cards.

Example Request
fetch('https://api.tradebinder.gg/functions/v1/collections-api/1', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
GET/collections-api/:id/value

Calculate the current market value of a collection with profit/loss tracking.

Example Request
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));
Example Response
{
  "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

Rate limits vary by plan:

PlanRequests/MonthRate Limit
Free1,00010 req/min
Pro100,000100 req/min
EnterpriseUnlimitedCustom

Error Handling

The API uses standard HTTP status codes and returns error details in JSON format:

401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Something went wrong
Error Response Format
{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has been revoked",
    "status": 401
  }
}

MCP / AI Integration

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.

What you can ask

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:

  • “What's my collection worth today?”
  • “Which of my cards went up the most this month?”
  • “What's in Box 2?”
  • “Which cards on my want list are under $10 right now?”
  • “Find every Charizard under $50”
  • “Add three Lightning Bolts from Alpha to my collection”

Setup (about a minute)

There's nothing to install and no API key to copy. You add TradeBinder by URL and sign in with your normal TradeBinder account.

  1. 1

    Add the connector

    In Claude, go to Settings → Connectors → Add custom connector. In ChatGPT, add a new connector. Paste this URL:

    https://www.tradebinder.gg/mcp
  2. 2

    Sign in and approve

    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.

  3. 3

    Ask a question

    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"
    }
  }
}

Troubleshooting

The sign-in page never opened
Check the URL is exactly https://www.tradebinder.gg/mcp, with the www and no trailing slash. Then remove the connector and add it again.
It connected, but says I have no collections
You probably signed in with a different account than the one you use on the site. Disconnect, add the connector again, and sign in with the account that holds your cards.
It worked before and now says I'm not authorized
Sign-ins expire. Reconnect TradeBinder in your assistant's connector settings and sign in again.
A card I own isn't found
Ask for it by name and set (“Umbreon VMAX from Evolving Skies”). Names alone can match several printings. If it still can't find it, contact us and tell us which card.
How do I remove its access?
Remove or disconnect the TradeBinder connector in your assistant's settings. That ends its access to your account.

Available tools

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.

Cards and prices

search_cards

Search cards by name, set, game or price range.

get_card

Details and current price for one card, plus gameplay data (colors, types, legality) for Magic and Sorcery.

get_bulk_card_metadata

Gameplay data for up to 100 cards at once.

get_card_variants

Every variant of a card (Normal, Reverse Holo, Foil, Master Ball…) with prices.

get_bulk_card_variants

Variants for up to 100 cards at once.

get_price_history

A card's price history.

get_movers

Cards with the biggest recent price changes.

Sets

list_sets

Every set, across all games.

get_set

One set and all its cards.

Your collection

list_collections

Your collections.

get_collection

A collection's cards and value, with filters (game, set, color, price, storage location).

create_collection

Create a collection.

add_to_collection

Add a card to a collection.

batch_add_to_collection

Add many cards in one go.

get_wantlist

Cards you're looking for, with current prices.

get_trade_binder

Cards you're offering for trade.

Where your cards are kept

list_storage_containers

Your binders, boxes and decks, with how many cards each holds.

get_storage_container

Everything filed in one binder, box or deck.

create_storage_container

Create a binder, box or deck.

store_cards

Record which binder, box or deck cards are in.

Ready to get started?

Create an account and get your API key in seconds

Get Your API Key