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.cardguide.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.cardguide.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.cardguide.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.cardguide.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://csygyaqftcsiphxsqjpj.supabase.co/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://csygyaqftcsiphxsqjpj.supabase.co/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://csygyaqftcsiphxsqjpj.supabase.co/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 Pokemon TCG collections to Claude for AI-powered portfolio analysis, price insights, and natural language queries about your cards.
The Model Context Protocol (MCP) allows AI assistants like Claude to securely access external data and tools. By connecting your CardGuide account, you can ask Claude questions like:
Go to your Dashboard and generate an API key if you haven't already.
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"pokemon-tcg": {
"command": "npx",
"args": ["@cardguide/mcp-server"],
"env": {
"CARDGUIDE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Fully quit and restart Claude Desktop. You should see the CardGuide tools available in your conversation.
search_cardsSearch for Pokemon cards by name, set, or other criteria
get_card_detailsGet detailed information and current price for a specific card
get_price_moversFind cards with the biggest price increases or decreases
get_collectionsList all your card collections
get_collection_valueCalculate the current market value of a collection with profit/loss tracking
add_card_to_collectionAdd a card to one of your collections
Pro tip: Your API key gives Claude secure access to your personal collections. Never share your API key publicly, and you can revoke it anytime from your dashboard.