ASasksurf
Prediction Market

Polymarket Orderbook History

Historical orderbook snapshots for a Polymarket token. Returns raw bid/ask depth levels. Timestamps in milliseconds.

Data refresh: ~5 minutes

get/gateway/v1/prediction-market/polymarket/orderbooks

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

token_idstring required

Token identifier

Example:73662070458561467734997715458900555626841827840002814944742182699282770895284
start_timeinteger

Start time in Unix milliseconds. 0 means 7 days ago.

end_timeinteger

End time in Unix milliseconds. 0 means current time.

limitinteger

Maximum number of snapshots to return

pagination_keystring

Base64 cursor for pagination

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/V2OrderbooksResponse.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.