Skip to content

TCG-Price-Lookup/awesome-tcg

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
LICENSE
LICENSE
 
 
README.md
README.md
 
 

Repository files navigation

Awesome TCG Awesome

The complete TCG Price Lookup developer ecosystem — APIs, SDKs, CLIs, and learning resources for building with live trading card prices across Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece TCG, Star Wars: Unlimited, and Flesh and Blood.

Powered by TCG Price Lookup License: MIT

One API. Every major trading card game. TCGPlayer market prices, eBay sold averages, and PSA / BGS / CGC graded comps — all in one place. This list indexes everything you need to build with the TCG Price Lookup API, from official SDKs in 5 languages to learning material and reference apps.

Contents

The API

  • TCG Price Lookup API — One REST API for every major trading card game. TCGPlayer market prices, eBay sold averages, and graded card comps from PSA, BGS, CGC, SGC, ACE, and TAG.
    • Free tier: 10,000 requests/month, TCGPlayer market prices
    • Trader plan and above: eBay sold averages, full graded prices, 1-year price history
    • Endpoints: /cards/search, /cards/{id}, /cards/{id}/history, /sets, /games
    • Auth: API key via X-API-Key header
    • Get a key: https://tcgpricelookup.com/tcg-api

Official SDKs

Native client libraries for every major language. Each SDK is a thin wrapper over the REST API with idiomatic conventions, typed errors, automatic batch chunking, and rate-limit headers.

  • tcglookup-js — JavaScript / TypeScript SDK. Native fetch, ESM + CJS, zero runtime dependencies. Works in Node 18+, browsers, Bun, Deno, Cloudflare Workers.
  • tcglookup-py — Python SDK built on httpx. Python 3.9+, sync API, context manager support.
  • tcglookup-go — Go SDK with stdlib net/http. Functional options for configuration, typed error wrappers, no third-party dependencies.
    • Module: github.com/TCG-Price-Lookup/tcglookup-go
  • tcglookup-rs — Async Rust SDK built on reqwest + tokio. Builder pattern, typed error enum, fully documented on docs.rs.
  • tcglookup-php — PHP 8.1+ SDK built on Guzzle. PSR-4 autoloading, typed exception hierarchy.

Command-Line Tools

  • tcglookup CLI — Terminal client for the TCG Price Lookup API. Search, lookup, and price-check cards from your shell. Built on the JS SDK.
    • npm: tcglookup — npm i -g tcglookup
    • Homebrew: homebrew-tcg — brew tap TCG-Price-Lookup/tcg && brew install tcglookup

Code Examples & API Specs

  • tcg-api-examples — Runnable code samples for the API in 8 languages: JavaScript, Python, Go, Rust, PHP, Ruby, Java, and C#. Each example covers search + get + rate-limit handling + typed error handling.
  • tcg-api-openapi — Hand-written OpenAPI 3.1 specification for every endpoint. Use with Swagger UI, Redoc, Stoplight, Postman, or openapi-generator to scaffold a client in any language.
  • tcg-api-postman — Official Postman collection + environment template. Drop into Postman, set your API key, hit Send. Works with Newman for CI runs.

Bots & Integrations

  • tcg-discord-bot — Self-hosted Discord bot with slash commands for live trading card prices. /price <card> [game], /card <id>, /games, /help. Built on discord.js v14 + the JS SDK. Dockerfile included, deploys in 5 minutes on Railway / Render / fly.io / your own VPS.

Game Catalogs

Live searchable catalogs for each supported game, backed by the same data the API returns.

Tools

Learning Resources

The TCG Price Lookup blog covers tutorials, market insights, rarity guides, and game-specific reference content. Everything below is a free, in-depth article on tcgpricelookup.com.

Tutorials

Hands-on guides for developers building with the API and collectors learning to value cards.

Reference Guides

Definitive references on rarity, condition, and grading across the major TCGs.

Market Insights

Analysis of game-specific markets, trends, and price drivers.

Game-Specific Price Guides

Comprehensive 2026 price guides for each major TCG.

Listicles

Lists of the most valuable cards in each game with real sale data.

Supported Games

The TCG Price Lookup API supports all major trading card games. Use these slugs in the game parameter of any API call:

Slug Game Catalog
pokemon Pokemon TCG (English) pokemon
pokemon-jp Pokemon TCG (Japanese) pokemon-japan
mtg Magic: The Gathering mtg
yugioh Yu-Gi-Oh! yugioh
lorcana Disney Lorcana lorcana
onepiece One Piece TCG one-piece-card-game
swu Star Wars: Unlimited star-wars-unlimited
fab Flesh and Blood flesh-and-blood

Quickstart Examples

JavaScript / TypeScript

import { TcgLookupClient } from "@tcgpricelookup/sdk";

const client = new TcgLookupClient({ apiKey: "tlk_live_..." });
const results = await client.cards.search({ q: "charizard", game: "pokemon", limit: 5 });

Python

from tcglookup import TcgLookupClient

client = TcgLookupClient(api_key="tlk_live_...")
results = client.cards.search(q="charizard", game="pokemon", limit=5)

Go

import "github.com/TCG-Price-Lookup/tcglookup-go/tcglookup"

client := tcglookup.NewClient("tlk_live_...")
results, _ := client.Cards.Search(ctx, &tcglookup.CardSearchParams{
    Q: "charizard", Game: "pokemon", Limit: 5,
})

Rust

use tcglookup::{Client, CardSearchParams};

let client = Client::new("tlk_live_...");
let results = client.cards().search(CardSearchParams {
    q: Some("charizard".into()),
    game: Some("pokemon".into()),
    limit: Some(5),
    ..Default::default()
}).await?;

PHP

use TcgPriceLookup\Client;

$client = new Client('tlk_live_...');
$results = $client->cards->search(['q' => 'charizard', 'game' => 'pokemon', 'limit' => 5]);

CLI

tcglookup search "charizard" --game pokemon --limit 5

Get Started

  1. Get a free API key at tcgpricelookup.com/tcg-api
  2. Pick your SDK from the Official SDKs section
  3. Run the quickstart for your language above
  4. Build something — see the Tutorials section for ideas

License

This list is licensed under MIT. All linked resources are owned and maintained by TCG Price Lookup.

Built and maintained by TCG Price Lookup. Get a free API key at tcgpricelookup.com/tcg-api.

About

Curated list of the TCG Price Lookup ecosystem — REST API, 5 SDKs (JS/Python/Go/Rust/PHP), CLI, code examples in 8 languages, blog tutorials. Live trading card prices for Pokemon, MTG, Yu-Gi-Oh, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood.

tcgpricelookup.com/tcg-api

Topics

tcg pokemon-tcg awesome mtg awesome-list trading-card-game yugioh tcgplayer card-prices one-piece-tcg lorcana star-wars-unlimited flesh-and-blood

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors