# PolyOrderbooks API

> Historical Polymarket order books, prices, and liquidity for crypto markets.
> Production API: https://api.polyorderbooks.com
> Developer portal: https://docs.polyorderbooks.com
> Dashboard: https://polyorderbooks.com/dashboard

## Getting started

- [Overview](/index.mdx): Design principles and quick links
- [Quickstart](/quickstart.mdx): Signup, API key, first historical query
- [Authentication](/authentication.mdx): API keys (`pob_…`), headers, security
- [Pricing & plans](/pricing.mdx): Starter / Pro / Scale limits (enforced on hosted API)
- [Rate limits](/rate-limits.mdx): Quotas, 429, Retry-After
- [Error handling](/error-handling.mdx): Status codes and response shapes

## Discovery

- [Discovery overview](/discovery/overview.mdx): Search series, events, and markets (crypto coverage)
- [List series](/api-reference/discovery/list-series): `GET /v1/series`
- [List events](/api-reference/discovery/list-events): `GET /v1/events`
- [List markets](/api-reference/discovery/list-markets): `GET /v1/markets`
- [Get market details](/api-reference/discovery/get-market-details): `GET /v1/markets/{id_or_slug}`
- [List available tags](/api-reference/discovery/list-available-tags): `GET /v1/tags`

## Historical

- [Historical overview](/historical/overview.mdx): Prices, metrics, and order books
- [Pagination](/historical/pagination.mdx): Cursor-based pagination
- [Resolutions](/historical/resolutions.mdx): Time bucket granularity and plan floors
- [Market token prices](/api-reference/history/get-market-token-prices-history): `GET /v1/markets/{id_or_slug}/prices`
- [Market metrics](/api-reference/history/get-market-metrics-history): `GET /v1/markets/{id_or_slug}/metrics`
- [Market order books](/api-reference/history/get-market-order-book-history): `GET /v1/markets/{id_or_slug}/books`
- [Token prices](/api-reference/history/get-token-price-history): `GET /v1/tokens/{token_id}/prices`
- [Token order books](/api-reference/history/get-token-order-book-history): `GET /v1/tokens/{token_id}/books`

## Reference

- [Get usage information](/api-reference/utility/get-usage-information): Plan limits and per-minute quota (API key)