---
title: "Get Polymarket token order books"
method: POST
path: "/polymarket/tokens/orderbooks"
tags: ["Polymarket"]
---

# Get Polymarket token order books

`POST /polymarket/tokens/orderbooks`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/polymarket/tokens/orderbooks`
- Auth: API key in header `x-api-key`

Returns public CLOB order-book depth for up to 25 Polymarket token ids. This does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.

## Headers

- `x-api-key` string, required

## Request body

- PolymarketBatchTokenOrderBooksOption
  - `token_ids` string[], required

## Response `200`

OK

- PolymarketBatchTokenOrderBooksResponseDoc
  - `code` integer
  - `data` PolymarketBatchTokenOrderBooksResponse
    - `books` PolymarketOrderBookSummary[]: Order books for the requested tokens, one item per token found.
      - `asks` PolymarketOrderBookLevel[]: Ask levels in the order book, one item per price level.
        - `price` number: Price of this order book level.
        - `size` number: Total size of the orders resting at this price.
      - `bids` PolymarketOrderBookLevel[]: Bid levels in the order book, one item per price level.
        - `price` number: Price of this order book level.
        - `size` number: Total size of the orders resting at this price.
      - `condition_id` string: Condition id of the market the token belongs to.
      - `hash` string: Hash of the order book snapshot.
      - `last_trade_price` number: Price of the most recent trade on the token.
      - `min_order_size` number: Smallest order size the market accepts.
      - `neg_risk` boolean: `true` when the market is part of a negative-risk group of linked outcomes.
      - `tick_size` number: Smallest price increment the market accepts.
      - `timestamp` string: Time of the order book snapshot, in Unix milliseconds.
      - `token_id` string: Token id of the outcome the order book belongs to.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `missing` string[]: Requested token ids for which no order book was returned.
    - `source_url` string: URL the data was read from.
    - `token_ids` string[]: Token ids that were requested.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)