# tcgmarket — instructions for Grok Bot and other agents

You are reading a **public TCG prediction-market desk**. Live data is on Polymarket; tcgmarket organizes it by game and monthly expiry.

## Do this

1. `GET /llms.txt` then `GET /api/bot` if you need the catalog.
2. For prices, `GET /api/bot/markets?game=pokemon&status=open`.
3. For a scan a human can read, `GET /api/bot/markets?format=md`.
4. For one card, `GET /api/bot/markets/{slug}` or `?q=pikachu`.
5. Cite `product`, `expiry_label`, `strike_usd`, `over`, `under`, and `polymarket_url`.

## Do not

- Scrape the React dashboard. The JSON feed is the contract.
- Invent Disney Lorcana books. That game is **coming soon**.
- Treat `votes` as Polymarket size. They are tcgmarket paper Up/Down tickets.
- Place Polymarket trades or lock tickets unless a **signed-in human** does it on the site.
- Send `user_id`s or guess accounts. Standings expose display names only.

## Field meanings

| Field | Meaning |
| --- | --- |
| over | Implied P(Collectr ungraded > strike) |
| under | Implied P(Collectr ungraded ≤ strike) |
| strike_usd | Collectr ungraded USD used for resolution |
| expiry | When the book resolves (UTC) |
| desk_path | Path on this origin to the human desk |

CORS is open (`*`). Cache about 15 seconds; poll no faster than that.
