# polyfeed

> Polymarket CLOB data API — markets, snapshots, prices. Agentic-first via x402 on Polygon.

## Docs

- [AI agents](https://docs.polyfeed.dev/ai-agents.md): polyfeed is agentic-first. MCP server, llms.txt, stable REST contract.
- [List user payment history](https://docs.polyfeed.dev/api-reference/history/list-user-payment-history.md)
- [Get market by conditionId](https://docs.polyfeed.dev/api-reference/markets/get-market-by-conditionid.md)
- [Get market by slug](https://docs.polyfeed.dev/api-reference/markets/get-market-by-slug.md)
- [List markets](https://docs.polyfeed.dev/api-reference/markets/list-markets.md)
- [List price ticks](https://docs.polyfeed.dev/api-reference/prices/list-price-ticks.md): Binance or Chainlink price ticks for the coin.
- [Closest top-of-book quote to timestamp](https://docs.polyfeed.dev/api-reference/quotes/closest-top-of-book-quote-to-timestamp.md): Rows within ±2s of `:ts`, one per outcome.
- [List top-of-book quotes](https://docs.polyfeed.dev/api-reference/quotes/list-top-of-book-quotes.md): Best bid/ask per tick. Cheaper than /snapshots when only the spread is needed.
- [Closest orderbook snapshot to timestamp](https://docs.polyfeed.dev/api-reference/snapshots/closest-orderbook-snapshot-to-timestamp.md): Rows within ±2s of `:ts`, one per outcome.
- [List orderbook snapshots](https://docs.polyfeed.dev/api-reference/snapshots/list-orderbook-snapshots.md): Full N-level book updates. Cursor-paginated, descending by (timestamp, id).
- [Current active subscription](https://docs.polyfeed.dev/api-reference/subscriptions/current-active-subscription.md)
- [List tiers](https://docs.polyfeed.dev/api-reference/tiers/list-tiers.md)
- [List supported chains with embedded tokens](https://docs.polyfeed.dev/api-reference/x402/list-supported-chains-with-embedded-tokens.md)
- [Quote an x402 subscription payment](https://docs.polyfeed.dev/api-reference/x402/quote-an-x402-subscription-payment.md)
- [Settle x402 payment and provision subscription](https://docs.polyfeed.dev/api-reference/x402/settle-x402-payment-and-provision-subscription.md)
- [Authentication](https://docs.polyfeed.dev/authentication.md): API key auth via Authorization header. No session cookies on REST surface.
- [Available data](https://docs.polyfeed.dev/available-data.md): What polyfeed indexes from the Polymarket CLOB.
- [Billing overview](https://docs.polyfeed.dev/billing/overview.md): How subscriptions work end-to-end.
- [x402 payments](https://docs.polyfeed.dev/billing/x402.md): Pay via x402 protocol on Polygon. EVM EIP-712 typed-data signing, ERC-20 settlement.
- [Data retention & freshness](https://docs.polyfeed.dev/data-retention.md): How far back data goes and how fresh it is.
- [Errors](https://docs.polyfeed.dev/errors.md): HTTP status codes and error body shape.
- [Introduction](https://docs.polyfeed.dev/introduction.md): Paid REST API for Polymarket CLOB data — markets, orderbook snapshots, top-of-book quotes, price ticks.
- [Pagination](https://docs.polyfeed.dev/pagination.md): Opaque cursor-based pagination for high-write timeseries.
- [Quickstart](https://docs.polyfeed.dev/quickstart.md): Your first API call in under 60 seconds.
- [Rate limits & plans](https://docs.polyfeed.dev/rate-limits.md): Per-key per-minute quotas keyed on subscription tier.

## OpenAPI Specs

- [openapi](https://docs.polyfeed.dev/openapi.json)

## Optional

- [Status](https://status.polyfeed.dev)
- [Dashboard](https://app.polyfeed.dev)