CLI npm global Homebrew

CLI Tool

Live trading card prices in your terminal. Search, lookup, price history, ASCII sparklines, and JSON output for pipe-friendly scripting.

install via npm npm 
$ npm install -g tcglookup
install via Homebrew brew 
$ brew tap TCG-Price-Lookup/tcg
$ brew install tcglookup

Key Features

ASCII Tables

Beautiful table output for search results with prices per condition.

ASCII Sparklines

Price history as sparkline + percentage delta in your terminal.

JSON Mode

--json flag on every command for pipe-friendly scripting.

All 8 Games

Pokemon, MTG, Yu-Gi-Oh!, Lorcana, One Piece, and more.

Auth Management

tcglookup auth login / status / logout.

Dual Install

npm global install or Homebrew tap โ€” your choice.

Commands

tcglookup search Search cards with ASCII table output 
$ tcglookup search "charizard" --game pokemon --limit 3

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Name                         โ”‚ Set                โ”‚ NM     โ”‚ Condition  โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ Charizard ex                 โ”‚ Obsidian Flames    โ”‚ $4.25  โ”‚ 5 listed   โ”‚
โ”‚ Charizard ex (Special)       โ”‚ Obsidian Flames    โ”‚ $18.50 โ”‚ 5 listed   โ”‚
โ”‚ Charizard VMAX               โ”‚ Darkness Ablaze    โ”‚ $12.00 โ”‚ 5 listed   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
tcglookup get <uuid> Full card details with all conditions and graders 
$ tcglookup get 019535a1-d5d0-7c12-a3e8-b7f4c6d8e9a2

Charizard ex ยท Obsidian Flames ยท Pokemon

Raw Prices (TCGPlayer)
  Near Mint      $4.25
  Lightly Played $3.82
  Played         $2.98

Graded Prices (PSA)  Trader+
  PSA 10         $42.00
  PSA 9          $18.00
tcglookup history <uuid> --period 30d Trader+ required 
$ tcglookup history 019535a1-d5d0-7c12-a3e8-b7f4c6d8e9a2 --period 30d

Charizard ex ยท Near Mint ยท 30 days

  โ–โ–‚โ–‚โ–ƒโ–ƒโ–„โ–„โ–„โ–…โ–…โ–„โ–„โ–ƒโ–„โ–„โ–…โ–…โ–†โ–†โ–‡โ–‡โ–†โ–…โ–…โ–„โ–„โ–„โ–ƒโ–ƒโ–„
  $3.10 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ $4.25
  +37.1% over 30 days
tcglookup sets <game> List sets for a game 
$ tcglookup sets pokemon
$ tcglookup sets mtg --limit 10
tcglookup games List all supported games 
$ tcglookup games

  pokemon ยท mtg ยท yugioh ยท lorcana ยท onepiece ยท digimon ยท union-arena ยท flesh-and-blood
tcglookup auth Manage your API key 
$ tcglookup auth login    # prompts for API key, saves to ~/.tcglookuprc
$ tcglookup auth status   # show current key + plan info
$ tcglookup auth logout   # remove saved key

JSON Output & Scripting

Every command supports --json for pipe-friendly output. Combine with jq for powerful one-liners.

scripting examples
# Get market price of the first Charizard result
$ tcglookup search charizard --game pokemon --json | jq '.data[0].prices.raw.near_mint.tcgplayer.market'
4.25

# Extract all PSA 10 prices from a batch
$ tcglookup search charizard --game pokemon --json | jq '[.data[].prices.graded.psa."10".ebay.avg_7d]'

# Get card and save to file
$ tcglookup get 019535a1-d5d0-7c12-a3e8-b7f4c6d8e9a2 --json > card.json

# List set names only
$ tcglookup sets pokemon --json | jq '[.data[].name]'

# Monitor a card price in a loop
$ while true; do
    tcglookup get <uuid> --json | jq '.prices.raw.near_mint.tcgplayer.market'
    sleep 3600
  done

Configuration

environment & config file
# Option 1: environment variable
$ export TCG_API_KEY=tlk_live_...
$ tcglookup search pikachu

# Option 2: auth login (saves to ~/.tcglookuprc)
$ tcglookup auth login
Enter your API key:  tlk_live_...
โœ“ Saved to ~/.tcglookuprc

Links

npm
tcglookup
npm global package
GitHub
tcglookup-cli
Source code & issues
docs
API Reference
Full endpoint docs

Start using the CLI

Get your free API key and query card prices from your terminal.

Get Free API Key Read the Docs