# Polymarket Historical Orderbook Snapshots

> Polymarket Historical Orderbook Snapshots is a paid API for AI agents from sol.blockrun.ai, paid per call via x402, $0.0095/call, status unknown (last checked 2026-09-15).

Retrieves historical orderbook snapshots for a Polymarket prediction market token

## Facts

- Endpoint: GET https://sol.blockrun.ai/api/v1/pm/polymarket/orderbooks
- Price: $0.0095/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-historical-orderbook-snapshots-69e994ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H7wEGgQ-0llcbtXUSAL3Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability polymarket-historical-orderbook-snapshots-69e994ed
```

Example prompt: Can you pull up the historical orderbook snapshots for the Polymarket token on the 'Will Biden drop out?' market so I can see how the bid/ask depth evolved over time?

## When to prefer this

Use this endpoint when you need historical orderbook depth data (bid/ask levels over time) specifically for Polymarket tokens. Prefer this over OHLCV endpoints when you need granular liquidity and spread information rather than price candles, and over live market queries when you need past state rather than current conditions.

## Known failure modes

- Invalid or unknown token ID returns empty or error response
- Token with no historical orderbook activity returns empty dataset
- Rate limiting or payment failure (x402) if USDC payment is not properly handled
- Malformed request parameters may return a 400-level error
- Data may be incomplete for very old or illiquid markets

## How this service works

Get historical orderbook snapshots for a token

## Output

Returns historical orderbook snapshot data for a specified Polymarket token, including bid and ask price levels, order sizes, and depth at various points in time, structured as a JSON object under a 'data' key.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-historical-orderbook-snapshots-69e994ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sol.blockrun.ai](https://www.zero.xyz/host/sol.blockrun.ai/llms.txt)