# Prediction Market Friction Tracker

> Structured KYC, fee, and withdrawal data across prediction market venues,
> plus a change feed for when those terms move. Built for agents that need
> to check execution friction before routing a trade.

Disclaimer: informational only, not financial or legal advice. Verify
directly with the venue before acting on any figure returned here.

## Endpoints

- `GET /friction/venues` — current snapshot of every tracked venue. Free.
  Optional `?confidence=verified|stale|unconfirmed` filter.
- `GET /friction/venue/{slug}` — single venue's current data. Free.
- `GET /friction/changes?since=<ISO8601>` — append-only log of every
  detected fee/KYC/withdrawal/API change since a timestamp. This is the
  time-sensitive product. Paid via the x402 protocol (HTTP 402):
  $0.05 USDC per call on Base. Unpaid requests get a 402 response with a
  payment challenge; pay it and retry with the signed payment header per
  the x402 spec (https://x402.org).

## MCP

- `/mcp/` (note the trailing slash) — streamable-HTTP MCP server exposing
  `list_venues`, `get_venue`, `recommend_venue`, and `get_changes_info` as
  tools. Point any MCP-compatible client at this URL directly.
- `recommend_venue(query)` answers free-text "which venue is best for X"
  questions, reasoned over the current dataset.

## Machine-readable schema

- OpenAPI spec: `/openapi.json`
- Interactive docs: `/docs`

## Notes for agents

- Every record carries a `confidence` field: `verified` (spot-checked or
  high-confidence extraction), `stale` (source was unreachable, showing a
  cached value), or `unconfirmed` (LLM extraction was ambiguous). Treat
  `unconfirmed` as a lead to verify against the venue directly, not a fact
  to trade on.
- Fee/KYC/withdrawal figures are extracted from each venue's own policy
  pages on a recurring schedule, not hand-maintained.