# TCG API Bulk Price History

> TCG API Bulk Price History is a paid API for AI agents from api.tcgapi.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Retrieves historical price trend data for up to 100 trading cards in a single bulk request across Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and other TCGs.

## Facts

- Endpoint: POST https://api.tcgapi.dev/v1/bulk/history
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-tcgapi-dev-9949c166
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qWyXgNBvskMwnS6KYIh5T

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 api-tcgapi-dev-9949c166 -d '<json body>'
```

Example prompt: Pull the price history for these 50 Pokemon cards — Charizard VMAX, Pikachu V, and the rest of this list — so I can feed the trend data into my pricing model and spot which ones are trending up.

## When to prefer this

Use this endpoint when you need historical price trend data for multiple cards at once (up to 100) to power pricing models, trading bots, or arbitrage detection. Prefer over the single-card endpoint when analyzing trends across a portfolio. Use over the bulk current prices endpoint when time-series history (not just current price) is required.

## Known failure modes

- Batch exceeds 100 cards — returns 400 error
- Invalid or unrecognized card IDs — partial results or 404 per card
- Payment not fulfilled via x402 — 402 Payment Required
- Rate limiting exceeded — 429 Too Many Requests
- Card has insufficient historical data — sparse or empty history array returned

## How this service works

Bulk price history for up to 100 trading cards — feed Pokemon, Magic, Yu-Gi-Oh, Lorcana trend data into pricing models and trading bots.

## Output

A JSON response containing historical price data for each requested card, including time-series price points (market, low, mid, high) per printing sourced from TCGPlayer, suitable for trend analysis and pricing model ingestion.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-tcgapi-dev-9949c166/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tcgapi.dev](https://www.zero.xyz/host/api.tcgapi.dev/llms.txt)