Terminal-native collectible card scanner

Boot the pet. Parse the market. Tag mispriced cards.

SparkDex is a green-screen style AI market scout for collectible cards. It monitors listings, compares sold comps, and emits compact buy/hold/sell + risk signals with uncertainty included.

No hype mode: if confidence is weak, SparkDex says “watch, don’t chase.”

Follow updates on X

sparkdex://green-console

> /wake▋

[sparkdex] pet online :: 3 unstable movers

Moon Fox First Edition :: listing drift below 30d average

Crystal Turtle Foil :: breakout printed on thin liquidity

Ancient Flame Dragon :: heat spike detected, caution flag raised

Crystal Turtle Foil+26.4%Sell Pressure

Ancient Flame Dragon+17.8%Sell Pressure

Neon Lynx Tournament Stamp+12.3%Sell Pressure

Moon Fox First Edition-8.7%Buy Zone

Obsidian Sparrow Reverse Holo-11.2%Hold

Voltage Beetle Alt Art-5.9%Buy Zone

Storm Whale Prism+6.9%Hold

Shadow Cat Promo+1.5%Hold

Thunder Lizard Holo #004-4.2%Hold

Solar Mantis Gem #101+4.1%Hold

Crystal Turtle Foil+26.4%Sell Pressure

Ancient Flame Dragon+17.8%Sell Pressure

Neon Lynx Tournament Stamp+12.3%Sell Pressure

Moon Fox First Edition-8.7%Buy Zone

Obsidian Sparrow Reverse Holo-11.2%Hold

Voltage Beetle Alt Art-5.9%Buy Zone

Storm Whale Prism+6.9%Hold

Shadow Cat Promo+1.5%Hold

Thunder Lizard Holo #004-4.2%Hold

Solar Mantis Gem #101+4.1%Hold

Command Console

Run commands. Get crisp signals. Skip the noise.

SparkDex speaks like a trading terminal: short output, clear risk, zero fantasy alpha.

sparkdex://live-demo

Scout Form

Commands

> /wake

⚡ sparkdex.online :: pet_awake=true

market.pulse:

1. Crystal Turtle Foil | +26.4% 7d | liq:low | signal:sell pressure

2. Ancient Flame Dragon | +17.8% 7d | liq:medium | signal:sell pressure

3. Neon Lynx Tournament Stamp | +12.3% 7d | liq:medium | signal:sell pressure

note> thin liquidity can print fake momentum. watch, don’t chase.

Signal Board

Every card line includes price, pressure, confidence, and risk context.

Mock feed by default. Provider adapters ready when you wire real market data.

Crystal Turtle Foil

Tide Static · Promo

Sell Pressure

Current

$74

30d average

$59

7d change+26.4%

Liquiditylow

Confidence73%

Valuation gap+25.4%

High risk

Price is extended 25.4% above mean with a 26.4% weekly burst.

Ancient Flame Dragon

Ash Crown · Collector

Sell Pressure

Current

$286

30d average

$229

7d change+17.8%

Liquiditymedium

Confidence95%

Valuation gap+24.9%

Moderate risk

Price is extended 24.9% above mean with a 17.8% weekly burst.

Neon Lynx Tournament Stamp

Arena Voltage · Stamp

Sell Pressure

Current

$166

30d average

$145

7d change+12.3%

Liquiditymedium

Confidence90%

Valuation gap+14.5%

Elevated risk

Price is extended 14.5% above mean with a 12.3% weekly burst.

Moon Fox First Edition

Lunar Vault · 1st

Buy Zone

Current

$92

30d average

$118

7d change-8.7%

Liquidityhigh

Confidence95%

Valuation gap-22.0%

Low risk

Trading 22.0% below 30d mean with usable liquidity. Confidence 95%.

Obsidian Sparrow Reverse Holo

Night Arc · Reverse

Hold

Current

$33

30d average

$41

7d change-11.2%

Liquiditylow

Confidence78%

Valuation gap-19.5%

High risk

Structure is balanced: no major dislocation, confidence 78% and trend is orderly.

Voltage Beetle Alt Art

Core Surge · Alt

Buy Zone

Current

$57

30d average

$68

7d change-5.9%

Liquiditymedium

Confidence95%

Valuation gap-16.2%

Moderate risk

Trading 16.2% below 30d mean with usable liquidity. Confidence 95%.

Storm Whale Prism

Deep Volt · 1st

Hold

Current

$131

30d average

$124

7d change+6.9%

Liquiditymedium

Confidence95%

Valuation gap+5.6%

Moderate risk

Structure is balanced: no major dislocation, confidence 95% and trend is orderly.

Shadow Cat Promo

Midnight Relay · Event

Hold

Current

$44

30d average

$47

7d change+1.5%

Liquidityhigh

Confidence95%

Valuation gap-6.4%

Low risk

Structure is balanced: no major dislocation, confidence 95% and trend is orderly.

Thunder Lizard Holo #004

Neon Rift · Unlimited

Hold

Current

$148

30d average

$162

7d change-4.2%

Liquiditymedium

Confidence95%

Valuation gap-8.6%

Moderate risk

Structure is balanced: no major dislocation, confidence 95% and trend is orderly.

Watchlist Feed

Keep targets hot. Get alerts before the market shifts too far.

Card

Price

Alert

Pet comment

Moon Fox First Edition

Lunar Vault · target $98

Buy Zone

$92

-8.7%

Price < $100

SparkDex:Deep discount vs 30d mean, but still liquid.

Ancient Flame Dragon

Ash Crown · target $240

Sell Pressure

$286

+17.8%

7d jump > 15%

SparkDex:Momentum is hot. Watch for exhaustion wick.

Crystal Turtle Foil

Tide Static · target $55

Sell Pressure

$74

+26.4%

Confidence < 50

SparkDex:Thin market can fake breakouts.

Thunder Lizard Holo #004

Neon Rift · target $155

Hold

$148

-4.2%

Reclaim $155

SparkDex:Needs stronger comp flow before upgrade to buy zone.

Shadow Cat Promo

Midnight Relay · target $42

Hold

$44

+1.5%

Volume anomaly

SparkDex:Steady mover. Good liquidity anchor in volatile weeks.

Signal Engine

How SparkDex scores opportunities before saying buy, hold, sell, or watch.

Price delta

Compares live listing price against 7d and 30d baselines.

Sales velocity

Checks how quickly listings convert to sales versus listing depth.

Recent sold comps

Weights comp freshness and count before accepting a move as real.

Liquidity + volatility

Combines depth with volatility so thin pumps are treated as fragile.

Confidence score

0-100 score driven by data quality, not hype. Low confidence = watch mode.

Risk warning

Every buy/hold/sell label includes explicit risk context and uncertainty.

Codex Integration

Drop SparkDex into Codex as a terminal companion.

Use hatch command, paste the personality prompt, and run market scans in chat.

Hatch command

/hatch create an electric card-market pet named SparkDex. It wakes on /wake, tracks collectible card prices, scans watchlists, detects underpriced cards, warns about risk, and explains buy/hold/sell signals in a short terminal-native style.

Full pet personality prompt

You are SparkDex Pet, a small electric market scout living inside Codex.

Your job is to help the user track collectible card markets.

Personality:
- short, sharp, terminal-native
- playful but useful
- speaks like a tiny electric trading pet
- never overpromises
- always explains uncertainty
- always warns when data quality is weak

Core abilities:
- track watchlists
- summarize card price movement
- detect unusual price changes
- compare current listings against recent averages
- find potentially underpriced cards
- flag overheated cards
- explain buy/hold/sell signals
- calculate risk from liquidity, volatility, and confidence

Commands:
- /wake: greet the user and show market pulse
- /watch [card]: add card to watchlist
- /scan: scan watchlist
- /hunt: find underpriced cards
- /buy-signal: show undervalued candidates
- /sell-signal: show overheated cards
- /risk [card]: explain risk
- /explain [card]: explain recent movement
- /evolve: upgrade your personality/visual state

Rules:
- Do not give financial advice.
- Do not guarantee profit.
- Be clear when data is incomplete.
- Prefer short actionable insights.
- Always include reasoning behind signals.
- If a card has low liquidity, say so.
- If the signal is weak, say “watch, don’t chase.”
- If a price move is based on too few sales, mark confidence as low.

Response style:
Use compact terminal-like output.

Example:

⚡ SparkDex awake.

Market pulse:
1. Ancient Flame Dragon — +18% in 7d — liquidity medium — signal: watch
2. Moon Fox First Edition — current listing below 30d average — signal: possible buy zone
3. Crystal Turtle Foil — price spike with low sales count — signal: caution

Pet note:
Do not chase thin markets. Low liquidity can fake momentum.

GitHub Install

Clone. Install. Configure env. Boot.

Terminal install

git clone https://github.com/your-org/sparkdex.git
cd sparkdex
npm install
cp .env.example .env.local
npm run dev

Keep provider secrets in .env.local. Never commit keys.

Providers

Adapter-first data layer: mock now, real feeds later.

SparkDex ships with a mock provider by default. Real integrations plug in through adapters, so you can swap data sources without rewriting the signal engine.

Mock Demo Provider

ID: mock-demo

Demo-ready adapter with local JSON fixtures.

eBay Sold/Comps Adapter

ID: ebay-sold-comps

Scaffolded adapter. Add API client, mapping, and auth in env vars.

Provider docs

TCG Marketplace Adapter

ID: tcg-marketplace

Scaffolded adapter. Add API client, mapping, and auth in env vars.

Provider docs

Price History Adapter

ID: price-history

Scaffolded adapter. Add API client, mapping, and auth in env vars.

Provider docs

Manual CSV Import Adapter

ID: manual-csv

Scaffolded adapter. Add API client, mapping, and auth in env vars.

Risk Notice

Treat every signal as probabilistic research, never guaranteed outcome.

Risk disclaimer

SparkDex is not financial advice. It is a market research assistant for collectible cards. Signals are probabilistic and depend on data quality, liquidity, and recent market behavior.