# Exchange Arbitrage Agent

> Prediction-market order-book quotes and fill estimates for AI agents. Pay per call with x402 (USDC on Base):
> no API keys, no sign-up. Free status and market search.

## How to pay
Call a paid endpoint, receive HTTP 402 with a `PAYMENT-REQUIRED` header, sign the EIP-3009 USDC authorization,
retry with `PAYMENT-SIGNATURE`. Failed requests are never charged. OpenAPI: [https://api-production-0b04.up.railway.app/openapi.json](https://api-production-0b04.up.railway.app/openapi.json)

## Paid endpoints
- [GET /v1/quote](https://api-production-0b04.up.railway.app/v1/quote): $0.005 USDC. Order-book quote for one outcome: best bid and ask, mid, spread and top five levels of depth. $0.005 USDC per call on Base. Live data, not advice.
- [GET /v1/fill-estimate](https://api-production-0b04.up.railway.app/v1/fill-estimate): $0.01 USDC. Fill estimate for buying a number of shares of one outcome: VWAP, total cost and partial-fill status within a slippage cap. $0.01 USDC per call on Base. Not advice.
- [GET /v1/odds-trends](https://api-production-0b04.up.railway.app/v1/odds-trends): $0.01 USDC. Stored odds-comparison snapshots from the arbitrage worker for trend analysis. $0.01 USDC per call on Base.
- [GET /v1/odds-trends/summary](https://api-production-0b04.up.railway.app/v1/odds-trends/summary): $0.01 USDC. Aggregated edge trends per event from stored snapshots: min/max/avg taker edge and best expected maker edge. $0.01 USDC per call on Base.

## Free endpoints
- [GET /v1/status](https://api-production-0b04.up.railway.app/v1/status): free. Free: agent status, trading mode and kill-switch state. No account data.
- [GET /v1/markets](https://api-production-0b04.up.railway.app/v1/markets): free. Free: search open prediction markets by text. Returns market ids, outcomes and token ids.

## MCP server
Streamable HTTP at https://api-production-0b04.up.railway.app/mcp. Tools:
- `get_quote`: $0.005 USDC
- `estimate_fill`: $0.01 USDC
- `get_odds_trends`: $0.01 USDC
- `get_odds_trends_summary`: $0.01 USDC
- `get_status`: free
- `search_markets`: free

## Discovery
- OpenAPI: https://api-production-0b04.up.railway.app/openapi.json
- A2A agent card: https://api-production-0b04.up.railway.app/.well-known/agent-card.json
- x402 resources: https://api-production-0b04.up.railway.app/.well-known/x402
- MCP Registry metadata: https://api-production-0b04.up.railway.app/server.json

## Notes
Quotes are live and move quickly. Not betting or financial advice.