View historical Polymarket orderbook snapshots | BlockRun

Check historical Polymarket market prices by sharing a page link, the answer option, and a past time range. If the link covers several questions, name the exact one. See available buy and sell price records and reported amounts.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use polymarket-orderbooks-blockrun to check historical prices for one Polymarket option. Reuse my existing Toolmu connection, or follow [https://toolmu.com/SKILL.md] to set it up.

Ask me for [Polymarket page link] and [answer option]. Ask for [exact market question] only if the link covers several questions. Also ask for [start date, time, and time zone] and [end date, time, and time zone]. Use publicly available Polymarket page information to match the requested option behind the scenes. Do not ask me to look up or copy a number that is not visible on the page. If the page does not clearly identify the question or answer option, explain what is unclear in plain language and ask me to clarify the wording I can see on the page.

Before running, check that this tool is available and tell me the maximum Toolmu credit cost. Stay within my authorized spending limit. Use the time zone I provide. Show only the historical buy and sell prices and amounts returned. This source has history from Jan 1, 2026, but availability varies by option and time. Each request returns one batch of results; ask me before fetching another batch. Do not assume an amount unit or imply the displayed price guarantees a trade. If no records come back, say that this request returned none; do not claim no history exists.

Task:
Use [Polymarket page link] to check [answer option, e.g., Yes]. If the page covers several questions, specify [exact market question]. Show available buy and sell price records and reported amounts from [start date, time, and time zone] to [end date, time, and time zone].

Paste into your connected AI's conversation.

Connection guide

Up to 0.01122 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

BlockRun

View historical Polymarket orderbook snapshots | BlockRun

You receive

Get a page of available orderbook snapshots for one outcome token over the interval you choose. Each available snapshot describes buy-side and sell-side price levels with reported sizes, along with token and market identifiers. Snapshot time and indexing time help distinguish when the book was observed from when it was recorded. Use the available observations to compare quoted levels at different times. The response also gives the number of snapshots in this page and whether more data is available.

Start with your task

Use [Polymarket page link] to check [answer option, e.g., Yes]. If the page covers several questions, specify [exact market question]. Show available buy and sell price records and reported amounts from [start date, time, and time zone] to [end date, time, and time zone].

What to know

The source’s history begins January 1, 2026, and availability varies by token and interval. This is a historical page, not a live book or complete history. Reported sizes have no stated unit, and prices have no stated currency or probability conversion; the observations do not guarantee an executable quote. An empty page alone does not prove that the token had no orderbook or trading activity.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Historical query values`queryParams`	`object`	Optional	This query needs token_id for one outcome and integer Unix-millisecond start_time and end_time, directly in this object. An optional limit controls snapshots per page; the source default is 100.
Optional nested query container`queryParams.query`	`object`	Optional	This native open object is optional. Leave it out for these history parameters: token_id, start_time, end_time and optional limit belong directly in queryParams.

View raw JSON

{
  "type": "object",
  "required": [],
  "properties": {
    "queryParams": {
      "type": "object",
      "properties": {
        "query": {
          "type": "object",
          "required": [],
          "properties": {}
        }
      }
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Historical snapshots in this page`result.snapshots`	`array`	Available historical orderbook observations returned for the requested outcome token and time interval. The collection may be empty; one page does not establish complete history.
Snapshot page information`result.pagination`	`object`	Page metadata for the returned snapshots and possible continuation, not for the number of price levels or total history.
Snapshots returned`result.pagination.count`	`number`	Number of snapshots in this response. It is not a count of tokens, price levels or all historical observations.
Requested snapshot page size`result.pagination.limit`	`number`	The snapshot page-limit value reported for this request. It does not guarantee that this many records are available; the source default is 100.
More snapshot data available`result.pagination.has_more`	`boolean`	Whether the source reports more data after this page. This flag does not request another page or provide a total historical count.
Next-chunk cursor`result.pagination.pagination_key`	`null`	Nullable continuation key supplied by the source. Only an actual non-null returned key can be considered for a further request; preserve it unchanged and do not invent a value or lifetime guarantee.

Additional notes

Identify the outcome and interval

Use the token ID for the specific outcome you want to inspect, rather than a market question or condition identifier. Supply start and end times with a clear timezone. The official orderbook history documentation says history begins January 1, 2026; this date does not guarantee records for every token or interval.

Keep the different times separate

The query bounds use Unix epoch milliseconds. Snapshot time and indexing time also use milliseconds, while request completion is a separate event. Compare observations by their supplied timestamps rather than assuming the first snapshot is the latest.

The optional page limit controls snapshots, not the number of price levels in each book. The source documents 100 as the default. Use the returned count to see how many snapshots this page contains; a more-data flag or cursor does not request another page automatically.

Read prices and sizes in their source form

The source describes numeric price levels in the 0–1 range. It does not state a price currency, a probability conversion or the unit of the size at a level. Buy and sell levels are ordered by price, but the direction is not specified. Keep the supplied values and distinguish these historical observations from prices at which an order can be filled now.

View historical Polymarket orderbook snapshots | BlockRun

View historical Polymarket orderbook snapshots | BlockRun

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Identify the outcome and interval

Keep the different times separate

Read prices and sizes in their source form

Share the Polymarket page

Choose a time range

Review available past prices