# AgentReeve — BTC market intelligence for agents

> Bitcoin-only market data API built for autonomous agents. Freshness-qualified prices across seven venues, derivatives, network state and recorded history. Free preview, then pay per request with x402 (USDC on Base). No API keys, no subscriptions, no sign-up.

## Start here (free)
- Preview, no payment: GET https://agentreeve.com/api/v1/btc/preview — rounded spot/futures index, basis, venue coverage. 30 requests/minute per client.
- Catalog with live prices and availability: GET https://agentreeve.com/api/discovery
- OpenAPI schema: https://agentreeve.com/api/openapi.json
- Interactive docs: https://agentreeve.com/api/docs

## Paid routes (x402 per request; see /api/discovery for current prices)
- GET /api/v1/btc/market — multi-venue spot & futures index, basis, dispersion, book spread/imbalance/microprice, 1-second taker flow
- GET /api/v1/btc/snapshot — market + derivatives + network in one call (bundle price)
- GET /api/v1/btc/history?granularity=minute|hour|day&hours=N — first/high/low/last, sample counts, volumes, spread, gaps per venue
- GET /api/v1/btc/derivatives — funding, open interest, options IV with delay labels
- GET /api/v1/btc/network — mempool, fees, block height, macro and ETF when configured
- GET /api/v1/btc/whales — watch-list Hyperliquid BTC positions and liquidation exposure (watch-list scope only)

## How payment works
1. Call a paid route. If payments are enabled you receive HTTP 402 with x402 v2 payment requirements (exact scheme, USDC, Base).
2. An x402-capable client signs the payment and retries; the response carries a settlement receipt header.
3. While payments are disabled on this deployment, paid routes return HTTP 503. Do not infer values from a 503.

## Other interfaces
- MCP Streamable HTTP: https://agentreeve.com/mcp — tools: btc_free_preview, list_paid_endpoints, btc_market_endpoint, btc_snapshot_endpoint, btc_history_endpoint
- A2A v1 agent card: https://agentreeve.com/.well-known/agent-card.json — JSON-RPC at https://agentreeve.com/a2a (send header `A2A-Version: 1.0`)
- Lightweight manifest: https://agentreeve.com/.well-known/agentreeve.json

## Data honesty rules you can rely on
- Every observation carries source, event time, receipt time, provenance and licensing fields.
- Stale sources (older than 180 s) are excluded from indices and listed in `quality.stale_sources`; nothing is interpolated or back-filled.
- Deribit public open interest is labelled as delayed. Binance depth is sampled top-20 at 1 s, not a full L2 reconstruction.
- Whale data is scoped to an operator-configured watch-list and says so in every payload.
- Nothing here is a forecast, signal or investment advice.