# BlockRun.AI Polymarket Historical Orderbook Snapshots

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

Retrieves historical orderbook snapshots for a specific Polymarket prediction market token

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/orderbooks
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-2e324e09
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AaXpPhXBWdCgtFZtEaDpc

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 blockrun-ai-2e324e09
```

Example prompt: Can you pull the historical orderbook snapshots for the Polymarket token for the 'Will Trump win 2024?' market so I can analyze how the bid-ask spread evolved over time?

## When to prefer this

Choose this endpoint when you need historical orderbook depth and bid/ask snapshot data specifically from Polymarket prediction markets. It is distinct from live orderbook feeds and is best suited for backtesting, liquidity analysis, or studying how market sentiment evolved over time on a specific outcome token.

## Known failure modes

- Invalid or unknown token identifier returns empty or error response
- Token not tracked by BlockRun.AI returns no data
- Rate limiting or payment failure (x402) if USDC micropayment not processed
- Malformed request parameters result in API error
- Historical data may be unavailable for very old or inactive markets

## How this service works

Get historical orderbook snapshots for a token

## Output

Returns historical orderbook snapshot data for the specified Polymarket token, including bid and ask price levels, order sizes, and timestamps of snapshots captured over time.

## Example request

```json
{
 "end_time": 1730505600,
 "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
 "start_time": 1730419200
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "query": {
     "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/blockrun-ai-2e324e09/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)