# tcgfast

> The developer resource hub for the TCG Price Lookup API — real-time trading card pricing for Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece, Star Wars: Unlimited, Flesh and Blood, and Pokemon Japan. 300,000+ cards, 5 official SDKs, free tier included.

tcgfast.com is a developer-focused documentation, tutorial, and ecosystem index site for the TCG Price Lookup API (tcgpricelookup.com). It provides comprehensive guides, SDK references, per-game documentation, and tooling around the API that serves live pricing data from TCGPlayer and eBay, plus graded card values from PSA, BGS, and CGC.

The site is available in English (default) and Japanese (/ja/).

## Key facts about TCG Price Lookup API

- **Supported games**: Pokemon, Pokemon Japan, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited, Flesh and Blood
- **Card catalog**: 300,000+ cards across all 8 games
- **Price sources**: TCGPlayer market data and eBay sold-listing averages
- **Graded values**: PSA, BGS, CGC grades 1 through 10 (Trader plan and above)
- **Price history**: 7d, 30d, 90d, 1y historical pricing (Trader plan and above)
- **Authentication**: Simple API key via `X-API-Key` header
- **Base URL**: `https://api.tcgpricelookup.com/v1`
- **Response envelope**: `{ data, total, limit, offset }`
- **Pagination**: `limit` and `offset` query parameters

## Pricing tiers

- **Free**: $0, 200 requests/day, 1 req/3s burst, TCGPlayer prices only, non-commercial use
- **Trader**: $14.99/month, 10,000 requests/day, 1 req/s burst, TCGPlayer + eBay, PSA/BGS/CGC graded, price history, commercial use
- **Business**: $89.99/month, 100,000 requests/day, 3 req/s burst, everything in Trader + priority support, custom integrations
- Annual billing: 20% discount. Daily limits reset at midnight UTC.

## Official SDKs

All SDKs are maintained by the TCG Price Lookup team and hosted under the GitHub organization `TCG-Price-Lookup`.

- **JavaScript / TypeScript**: `@tcgpricelookup/sdk` on npm. Zero runtime dependencies, native `fetch`, ESM + CJS. Works in Node 18+, browsers, Cloudflare Workers, Bun, Deno.
- **Python**: `tcglookup` on PyPI. Python 3.9+, built on httpx, typed exception hierarchy, context manager support.
- **Go**: `github.com/TCG-Price-Lookup/tcglookup-go`. Stdlib `net/http`, zero third-party dependencies, functional options, typed errors.
- **Rust**: `tcglookup` on crates.io. Async with reqwest + tokio, builder pattern, typed Error enum.
- **PHP**: `tcgpricelookup/sdk` on Packagist. PHP 8.1+, Guzzle, PSR-4, typed exception hierarchy.
- **CLI**: `tcglookup` on npm (global) or Homebrew tap. Terminal access with `--json` for scripting.

## Tooling

- **Discord Bot**: Self-hosted slash-command bot with `/price`, `/card`, `/history`, `/alerts`, `/portfolio`, `/leaderboard`. Source: github.com/TCG-Price-Lookup/tcg-discord-bot
- **Next.js Starter**: Production-ready Next.js 16 template with shadcn/ui, ISR caching, server components only. One-click deploy to Vercel. Source: github.com/TCG-Price-Lookup/nextjs-tcg-starter
- **OpenAPI Spec**: Hand-written OpenAPI 3.1 specification for client generation in any language. Source: github.com/TCG-Price-Lookup/tcg-api-openapi
- **Postman Collection**: Ready-to-import Postman collection with all endpoints. Source: github.com/TCG-Price-Lookup/tcg-api-postman
- **awesome-tcg**: Curated list of the full TCG Price Lookup ecosystem. Source: github.com/TCG-Price-Lookup/awesome-tcg

## Docs

- [Getting Started](https://tcgfast.com/docs/getting-started/): Quick-start guide to making your first API call
- [Authentication](https://tcgfast.com/docs/authentication/): API key management and security
- [Endpoints](https://tcgfast.com/docs/endpoints/): Full endpoint reference with parameters and examples
- [Response Format](https://tcgfast.com/docs/response-format/): JSON envelope, card object schema, pagination
- [Error Handling](https://tcgfast.com/docs/error-handling/): HTTP status codes, error responses, retry strategies
- [Rate Limiting](https://tcgfast.com/docs/rate-limiting/): Limits per plan, best practices, caching, exponential backoff

## SDKs

- [JavaScript / TypeScript SDK](https://tcgfast.com/docs/sdks/javascript/)
- [Python SDK](https://tcgfast.com/docs/sdks/python/)
- [Go SDK](https://tcgfast.com/docs/sdks/go/)
- [Rust SDK](https://tcgfast.com/docs/sdks/rust/)
- [PHP SDK](https://tcgfast.com/docs/sdks/php/)
- [CLI Tool](https://tcgfast.com/docs/sdks/cli/)

## Games

- [Pokemon TCG API](https://tcgfast.com/games/pokemon/): 30,000+ cards, 150+ sets
- [Magic: The Gathering API](https://tcgfast.com/games/mtg/): 100,000+ cards, 300+ sets, Reserved List included
- [Yu-Gi-Oh! API](https://tcgfast.com/games/yugioh/): 40,000+ cards, 300+ sets
- [Disney Lorcana API](https://tcgfast.com/games/lorcana/): 3,000+ cards, 6+ sets
- [One Piece TCG API](https://tcgfast.com/games/one-piece/): 6,000+ cards, 12+ sets
- [Star Wars: Unlimited API](https://tcgfast.com/games/star-wars-unlimited/): 2,500+ cards, 4+ sets
- [Flesh and Blood API](https://tcgfast.com/games/flesh-and-blood/): 8,000+ cards, 35+ sets
- [Pokemon Japan API](https://tcgfast.com/games/pokemon-japan/): 20,000+ cards, 120+ sets

## Tools

- [Discord Bot](https://tcgfast.com/tools/discord-bot/)
- [Next.js Starter Template](https://tcgfast.com/tools/nextjs-starter/)
- [OpenAPI 3.1 Specification](https://tcgfast.com/tools/openapi/)
- [Postman Collection](https://tcgfast.com/tools/postman/)
- [awesome-tcg](https://tcgfast.com/tools/awesome-tcg/)

## Blog

- [Best TCG APIs in 2026](https://tcgfast.com/blog/best-tcg-apis-2026/): Comprehensive comparison of TCG APIs for developers

## Pricing and sign-up

- [Pricing page](https://tcgfast.com/pricing/)
- Get an API key: https://tcgpricelookup.com/pricing

## Optional

- [GitHub Organization](https://github.com/TCG-Price-Lookup)
- [Parent product: TCG Price Lookup](https://tcgpricelookup.com)