# TCGPlayer Card Price Search API

> TCGPlayer Card Price Search API is a paid API for AI agents from marketplace-price-api-production.up.railway.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Search TCGPlayer for trading card market prices by card name, with optional filters for price range and result count.

## Facts

- Endpoint: GET https://marketplace-price-api-production.up.railway.app/tcg/search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tcgplayer-card-price-search-api-724191f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__H346LskNLMP-pQCvdOeb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tcgplayer-card-price-search-api-724191f2
```

Example prompt: Can you look up the current TCGPlayer market price for 'Charizard Base Set' and show me the top 5 results?

## When to prefer this

Use this endpoint when you need real-time trading card market prices from TCGPlayer specifically, especially for Pokemon, Magic the Gathering, or Yu-Gi-Oh cards. Prefer this over general web search when you need structured, machine-readable price data with optional price range filtering rather than scraped HTML. Ideal for collection valuation, price comparison before buying/selling, or building price-aware card recommendation agents.

## Known failure modes

- No cards found matching the search query — returns empty results array
- Invalid or missing 'q' query parameter — returns 400 error
- minPrice or maxPrice filters too restrictive — returns empty results
- TCGPlayer upstream service unavailable — returns 502 or 503 error
- Rate limiting or payment failure — returns 402 or 429 error

## How this service works

Search TCGPlayer for trading card prices (Pokemon, Magic, Yu-Gi-Oh, etc.) by card name. Returns matching cards with market prices as JSON.

## Output

A JSON array of matching trading cards from TCGPlayer, each containing the card name, market price in USD, and associated card metadata. Results are ranked by relevance to the search query and can be filtered by price range.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search query"
      },
      "limit": {
       "type": "string",
       "description": "Max results (default 25)"
      },
      "maxPrice": {
       "type": "string",
       "description": "Maximum price filter (USD)"
      },
      "minPrice": {
       "type": "string",
       "description": "Minimum price filter (USD)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tcgplayer-card-price-search-api-724191f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from marketplace-price-api-production.up.railway.app](https://www.zero.xyz/host/marketplace-price-api-production.up.railway.app/llms.txt)