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

# Get Polymarket token spreads

`POST /polymarket/tokens/spreads`

## Request

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

Returns public CLOB spreads 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

- PolymarketBatchTokenSpreadsOption
  - `token_ids` string[], required

## Response `200`

OK

- PolymarketBatchTokenSpreadsResponseDoc
  - `code` integer
  - `data` PolymarketBatchTokenSpreadsResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `missing` string[]: Requested token ids for which no spread was returned.
    - `source_url` string: URL the data was read from.
    - `spreads` PolymarketBatchTokenSpread[]: Spreads for the requested tokens, one item per token found.
      - `spread` number: Spread between the best bid and best ask for the token.
      - `token_id` string: Token id of the outcome.
    - `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/028417aa35bb?raw)