Returns all 12 supported TCGs with card count, set count and price stats.

Query Params

Response

{ "items": [{ "id": 1, "name": "Pokémon TCG", "slug": "pokemon", "total_cards": 20543, "total_sets": 187 }], "total": 12 }

Returns a single TCG. slug is one of: pokemon, mtg, yugioh, onepiece, lorcana, fab, digimon, starwars, grandarc, dragonball.

Query Params

Response

{ "items": [{ "id": 1, "name": "Base Set", "code": "BASE1", "release_date": "1999-01-09", "total_cards": 102 }], "total": 187 }

Returns a single set including metadata and total card count.

Response

{ "set_id": 1, "set_name": "Base Set", "total_cards": 102, "cards_with_prices": 102, "avg_market_price": 24.50, "total_set_value": 2499.00, "most_valuable_card": { "id": 3782, "name": "Charizard", "market_price": 185.50 } }

Query Params

Response

{ "items": [{ "id": 3782, "name": "Charizard", "number": "4", "rarity": "Holo Rare", "card_type": "Pokémon", "image_url": "https://images.pokemontcg.io/base1/4_hires.png", "set": { "id": 1, "name": "Base Set" }, "market_price": 185.50 }], "total": 102 }

Full card detail including attributes JSON (hp, types, subtypes, etc.), set, TCG, and local image URL.

{ "tcgplayer": "https://tcgplayer.com/...", "cardmarket": "https://cardmarket.com/...", "cardtrader": "https://cardtrader.com/..." }

Pass up to 3 comma-separated card IDs. Returns an array of card objects with prices for comparison.

GET /api/compare?ids=3782,3783,3784

{ "total_cards": 127945, "total_sets": 1582, "total_prices": 1231433, "total_tcgs": 12, "ebay_graded_records": 68964, "last_price_update": "2026-05-05T12:00:00Z" }

Sources: tcgplayer, cardmarket, cardtrader, scryfall (MTG only), ebay_graded (array of grades).

{
  "card_id": 3782,
  "card_name": "Charizard",
  "tcgplayer": { "low_price": 120.00, "market_price": 185.50, "high_price": 250.00, "currency": "USD", "variant": "holofoil", "updated_at": "2026-05-05T12:00:00Z" },
  "cardmarket": { "low_price": 105.00, "market_price": 162.00, "high_price": 220.00, "currency": "EUR", "updated_at": "2026-05-05T10:00:00Z" },
  "cardtrader":  { "market_price": 178.00, "currency": "USD", "updated_at": "2026-05-05T11:30:00Z" },
  "ebay_graded": [
    { "grading_company": "PSA", "grade": "10",  "market_price": 4250.00, "sample_size": 47 },
    { "grading_company": "PSA", "grade": "9",   "market_price": 850.00,  "sample_size": 134 },
    { "grading_company": "BGS", "grade": "9.5", "market_price": 1800.00, "sample_size": 23 },
    { "grading_company": "CGC", "grade": "10",  "market_price": 2100.00, "sample_size": 31 }
  ]
}

{
  "card_id": 3782,
  "snapshots": [
    { "date": "2026-05-05", "source": "tcgplayer", "market_price": 185.50, "low_price": 120.00, "high_price": 250.00 },
    { "date": "2026-05-04", "source": "tcgplayer", "market_price": 179.00, "low_price": 118.00, "high_price": 240.00 }
  ],
  "analysis": { "change_7d": 3.6, "change_30d": 12.1, "change_90d": 28.4, "volatility": 0.08, "trend": "bullish" }
}

{
  "gainers":       [{ "id": 3782, "name": "Charizard", "tcg": "pokemon", "market_price": 185.50, "change_7d": 12.3, "change_30d": 28.1 }],
  "losers":        [...],
  "most_volatile": [...]
}

Cards where prices differ significantly between TCGPlayer and CardMarket. Useful for identifying underpriced listings.

{ "total_cards_tracked": 127945, "avg_change_7d": 0.8, "biggest_gainer": { "name": "...", "change_7d": 45.2 }, "biggest_loser": { "name": "...", "change_7d": -22.1 } }

Returns per-TCG price coverage, average prices, and last update timestamps.

{
  "results": [{ "id": 3782, "name": "Charizard", "number": "4", "rarity": "Holo Rare", "image_url": "...", "set_name": "Base Set", "tcg_slug": "pokemon", "market_price": 185.50, "change_7d": 3.6 }],
  "total": 42,
  "page": 1,
  "per_page": 20
}

Score Interpretation

Response

{ "score": 78, "label": "Buy Opportunity", "color": "#22c55e", "signals": ["📈 Rising +12% (7d)", "💎 Near 30-day low"] }

Returns price data with confidence scores and FX-converted values across all sources.

Individual listings from all sources before aggregation.

Historical snapshots of correlated prices. Use for charting.

{ "from": "USD", "to": "EUR", "rate": 0.921, "updated_at": "2026-05-05T12:00:00Z" }

Search raw price listings across all sources with filtering by source, date range, and price range.

Returns all active price sources with listing counts and last update times.

Forces a re-correlation of price data for a card across all sources. Returns the updated intelligence object.

{ "card_id": 3782, "current_price": 185.50, "predicted_7d": 192.00, "predicted_30d": 210.00, "confidence": 0.72, "trend": "bullish", "model": "linear_regression", "data_points": 90 }

Returns cards where the model predicts the largest price change in the next 7–30 days.

Returns all cards in the authenticated user's collection with current market prices.

{ "total_value": 2450.00, "total_cards": 87, "change_7d_pct": 3.2, "change_7d_abs": 76.00, "biggest_gainer": { "name": "Charizard", "change_7d": 12.3 }, "biggest_loser": { "name": "Blastoise", "change_7d": -4.1 }, "by_tcg": [{ "tcg": "pokemon", "cards": 45, "value": 1800.00 }], "by_rarity": [{ "rarity": "Holo Rare", "cards": 12, "value": 890.00 }] }

Top 10 cards by (market_price × quantity). Useful for portfolio overview.

[{ "set_id": 1, "set_name": "Base Set", "owned": 94, "total": 102, "pct": 92.2 }]

{ "rising_cards": { "count": 5, "card_ids": [3782, 891] }, "cards_without_alert": { "count": 12 }, "almost_complete_sets": { "count": 2, "set_ids": [1, 4] } }

Detailed analytics including price timeline, value distribution by TCG, and performance rankings.

{ "card_id": 3782, "quantity": 1, "variant": "holofoil", "condition": "NM", "price_paid": 150.00, "graded": false }

Returns 204 No Content.

Returns all wishlist cards with current price vs target price delta.

{ "card_id": 3782, "max_price": 150.00 }

Returns 204 No Content.

{ "on_wishlist": true, "entry_id": 42, "max_price": 150.00 }

Alert Types

{ "card_id": 3782, "alert_type": "target_price", "target_price": 150.00, "condition": "below" }

Triggered alerts sorted by most recent. Includes read/unread status.

{ "unread_count": 3 }

Returns 200 with {"marked": N}.

Browse public decks from all users. Sortable by popularity, value, date.

{ "pokemon": ["Standard", "Expanded", "Unlimited"], "mtg": ["Standard", "Modern", "Legacy", "Vintage", "Commander", "Pioneer", "Pauper"] }

Returns all decks owned by the authenticated user.

{ "name": "My Charizard Deck", "tcg": "pokemon", "format": "Standard", "is_public": true, "description": "Charizard-based aggro" }

Full deck including card list with counts and current market prices per card.

{ "deck_id": 12, "total_value": 450.00, "currency": "USD", "most_expensive_card": { "name": "Charizard", "value": 185.50 } }

Checks each card in the deck against MTG format legality rules. Returns card-by-card legality + overall deck status.

Parse a plaintext deck list and resolve card IDs. Supports PTCGO, Arena, and plain-text formats.

{ "text": "4 Charizard ex\n2 Pidgeot ex\n4 Rare Candy\n4 Ultra Ball" }

Creates a copy of an existing deck (yours or a public deck) under a new name.

{ "card_id": 3782, "quantity": 1, "slot": "main" }

Returns 204 No Content.

{ "card_id": 3782, "variant": "holofoil", "condition": "NM", "language": "EN", "price": 175.00, "quantity": 1, "description": "PSA ready, perfect centering", "photo_url": "https://..." }

Update price, quantity, condition or description. Only the owner can update.

Returns 204. Only the owner can delete.

Upload your CardMarket export CSV (multipart/form-data, field: file) to bulk-import all your listings at once.

Upload a TCGPlayer inventory export CSV to bulk-import listings.

Upload a listing photo (multipart/form-data, field: file). Returns {"url": "https://..."}. Max 5MB, JPEG/PNG/WebP.

Returns messages sorted newest first. Includes read/unread status.

{ "to_username": "collector42", "subject": "Your Charizard listing", "body": "Hi, is this still available?" }

{ "unread_count": 2 }

Returns 204. Only the sender or recipient can delete.

Returns all forum categories with thread and post counts.

Paginated thread list for a specific forum category. Sorted by most recent reply.

Returns the full thread with all replies in chronological order.

Returns pinned announcements from the CollectorsStashMarket team.

{ "title": "Base Set Charizard price prediction 2027?", "body": "With the upcoming sets..." }

{ "body": "I think..." }

[{ "id": 1, "key_prefix": "csm_a3f9...", "name": "My App", "is_active": true, "created_at": "2026-05-01T12:00:00Z", "last_used_at": "2026-05-05T09:30:00Z", "request_count": 842, "daily_limit": 1000, "requests_today": 156 }]

The full key is shown only once. Store it immediately. Maximum 5 keys per account.

// Request:  { "name": "My Price Tracker" }
// Response: { "id": 2, "key": "csm_a3f9...(full)", "key_prefix": "csm_a3f9", "name": "My Price Tracker" }

{ "name": "Production App" }

Permanently deactivates the key. Cannot be undone. Returns 204.

{ "status": "healthy", "database": "connected", "total_cards": 127945, "total_prices": 1231433, "last_price_update": "2026-05-05T12:00:00Z" }

Card counts, price coverage %, and last update time broken down per TCG and per source.