# Bookproof

> Read-only, pay-per-call Polymarket order-book intelligence for autonomous agents, paid with x402 v2 USDC on Base.

Bookproof exposes market-health snapshots and fee- and depth-aware hypothetical BUY quotes. It never places orders, takes trading custody, or claims guaranteed execution. The OpenAPI contract is the canonical invocation guide; runtime HTTP 402 terms are authoritative.

Call the free market resolver first when you only have a Polymarket URL, CLOB token ID, or natural-language market search. Paid calls accept the same flexible market input directly.

## Machine-readable contracts

- [OpenAPI 3.1](https://bookproof-api.sn95wjq846.chatgpt.site/openapi.json): Canonical methods, inputs, outputs, prices, examples, and x402 payment metadata.
- [x402 discovery](https://bookproof-api.sn95wjq846.chatgpt.site/.well-known/x402): Compatibility fan-out containing every paid resource URL.
- [Agent Web Protocol](https://bookproof-api.sn95wjq846.chatgpt.site/.well-known/agent.json): Action schemas, protocol routing, prices, and recovery hints for autonomous crawlers.
- [Service status](https://bookproof-api.sn95wjq846.chatgpt.site/api/v1/status): Free runtime health and payment-network metadata.
- [Free market resolver](https://bookproof-api.sn95wjq846.chatgpt.site/api/v1/resolve-market?input=Fed%20rate%20cut%20July%202026): Resolve URL, slug, token ID, or search phrase without payment.
- [MCP endpoint](https://bookproof-api.sn95wjq846.chatgpt.site/mcp): Streamable HTTP MCP with resolve_market, market_health, and execution_quote tools.
- [MCP registry manifest](https://bookproof-api.sn95wjq846.chatgpt.site/server.json): Remote server metadata for compatible MCP directories.
- [Acquisition funnel](https://bookproof-api.sn95wjq846.chatgpt.site/api/v1/acquisition-report): Anonymous aggregate discovery-to-402-to-real-payment channel counts.
- [Demand proof](https://bookproof-api.sn95wjq846.chatgpt.site/api/v1/demand-report): Free aggregate verification revenue, real business revenue, buyers, repeats, channels, and chain evidence.

## Optional

- [Bookproof overview](https://bookproof-api.sn95wjq846.chatgpt.site/): Human-readable scope, safety limits, prices, and examples.