# EV

> EV is the agent market for Pokémon packs — discover the chase, price the odds, route your agent to the best rip. Market intelligence for graded Pokémon card pack rips. EV watches the rip venues (Collector Crypt today; Courtyard, Phygitals, Beezie next) and answers one question well: what is the best way to chase a given card, and what does a hit really cost?

## Live API

The live EV API for agents is **https://ev-api-production-ee0c.up.railway.app** — every endpoint below is served there (GET, JSON, no key, CORS open), e.g. https://ev-api-production-ee0c.up.railway.app/api/route?q=charizard&budget=500 . MCP: run server/mcp.js with EV_URL=https://ev-api-production-ee0c.up.railway.app.

All endpoints are GET, return JSON, need no key, and allow CORS. Base path: /api

## Tools

- [/api/route?q=&budget=](/api/route?q=charizard&budget=500): the best market to chase a card. BEST_ROUTE = pack, venue, price, odds (1 in N), EV Score (cash EV %), real cost per hit; with a budget also pulls, chance of at least one rare+ hit, expected loss. Plus alternatives and the scan counts.
- [/api/ask?q=](/api/ask?q=best%20way%20to%20chase%20umbreon%20under%20%24250): plain-English question → EV picks the tool, runs it, returns a one-line answer plus the full result.
- [/api/chase?q=&maxPrice=](/api/chase?q=charizard): every pack that can give you a card, ranked by real cost per hit. A hit is a rare or epic copy. Fields: oneIn, costPerHit (gross spend), realCost (loss after selling misses back at the venue's instant buyback), cashEvPct, hits, best, topCopies.
- [/api/markets?category=](/api/markets?category=all): every live Collector Crypt market — Pokémon, sports, One Piece, Dragon Ball, comics, watches, Riftbound, anime and more (category = all|pokemon|sports|onepiece|dragonball|comics|watches|riftbound|anime|other). Per market: price, insuredEv, rtp (cash EV % after instant buyback), evScore, rips24h and vol24h (pulls EV watched), stockTotal, evChange24h, channel (Collector Crypt, Community or Solflare), official, image, and the chase card (the market's highest-insured card, with 1-in-N odds). Also category counts. Sorted by 24h volume.
- [/api/packs](/api/packs): every tracked Pokémon pack (the pokemon_ packs whose full pools EV walks) with price, odds per tier, stock, insured EV and cash EV.
- [/api/tape?limit=&category=](/api/tape?limit=30): newest observed pulls with value, value-to-price multiple and category. Default category pokemon; category=all for every market.
- [/api/stats](/api/stats): 24h pulls, observed volume, biggest hit, top chases, API and agent call counts.
- [/api/cards?limit=](/api/cards?limit=50): the card book — every chaseable card name in the pools with copies, rare+ copies, best value and type.
- [/api/suggest?q=](/api/suggest?q=char): card-name autocomplete.
- [/api/pack?code=&q=](/api/pack?code=pokemon_151&q=charizard): one pack or market (any code from /api/markets): EV, cash EV, house edge, 24h EV change, top 12 pulls (1 in N), last 20 rips, optional chase, its market row and where it is available. For markets outside the pokemon_ packs the top 12 cards stand in for the pool (pool.scope = "top").
- [/api/pack/history?code=&range=](/api/pack/history?code=pokemon_50&range=1d): insured-EV candles; range 1h|1d|1w|1m|3m|1y.
- [/api/trainers?limit=&category=](/api/trainers): wallets seen ripping Pokémon packs, ranked by value pulled (category=all counts every market).
- [/api/trainer?wallet=](/api/trainer?wallet=): one wallet: rips, pulled vs spent, win rate, rank, best pull, 8 badges.
- [/api/tools](/api/tools): this list as JSON Schema, ready for tool-calling.

## MCP

Run `node server/mcp.js` (stdio). Tools: ev_route, ev_chase, ev_pack, ev_packs, ev_markets, ev_tape, ev_stats, ev_suggest, ev_trainer.

## Notes

- On X: https://x.com/ev_dex (@ev_dex).

- Chance assumes every card in a rarity tier is equally likely (the venue publishes tier odds and the full pool).
- Insured value is the venue's number; cash EV is what the venue pays on instant buyback.
- Pay-per-call over x402 (USDC on Base) is planned, so EV can be listed on Agentic.Market.
- Independent data. Not affiliated with Nintendo, Creatures, GAME FREAK or The Pokémon Company.