Get Book

Changed on

Get book for an instrument.

get/v1/info/book

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/info/book
  • Auth: none required

Query parameters

instrument_idinteger required

Instrument ID

depth10 | 100 | 500 | 1000

Number of book levels to return

Response

Book response.

instrument_idinteger required

Instrument ID

timestampinteger required

Timestamp in milliseconds

sequenceinteger required

Sequence number

Example response

{
  "bids": [
    [
      "100.00",
      "10.00"
    ]
  ],
  "asks": [
    [
      "100.00",
      "10.00"
    ]
  ],
  "timestamp": 1767225600000,
  "sequence": 1234567890
}

Changes

  • 734bf911b1beRevision changes
    • breaking

      for the query request parameter instrument_id, the format changed from no format to int64

    • warning

      for the query request parameter instrument_id, the max was set to 4294967295.00

    • warning

      for the query request parameter instrument_id, the min was set to 0.00