CLOB Read (Public)

Get Prices Batch

Get prices for multiple tokens in one request.

Public endpoint — no authentication required.

Two body shapes are accepted (audit P0-2, PR #1309):

PolySim {"token_ids": ["TOKEN_A", "TOKEN_B"]} → returns {"TOKEN_A": "0.52", "TOKEN_B": "0.74"}.
Polymarket [{"token_id": "TOKEN_A", "side": "BUY"}, ...] (py-clob-client / clob-rust shape) → returns {"TOKEN_A": {"BUY": "0.52"}, "TOKEN_B": {"BUY": "0.74"}}.

The PM-shape response shape mirrors PM exactly (per docs.polymarket.com/trading/orderbook §Batch Requests). The simulator returns the cached outcome price for both BUY and SELL — separate bid/ask aren’t held in the price cache, so PM porters get the correct response shape (no more 422) but the BUY/SELL values are the same midpoint. Use single-token GET /v1/price?token_id=...&side=... when you need a true best-bid / best-ask off the live book.

POST

prices

Get Prices Batch

curl --request POST \
  --url https://api.polysimulator.com/v1/prices \
  --header 'Content-Type: application/json' \
  --data '
{
  "token_ids": [
    "<string>"
  ]
}
'

{}

Body

application/json

BatchTokenPriceRequest · object
PmBatchPriceItem · object[]

Accepts BOTH shapes: (1) PolySim {"token_ids": ["..."]} → returns {token_id: price_str}; (2) Polymarket [{"token_id": "...", "side": "BUY|SELL"}, ...] → returns {token_id: {SIDE: price_str}} (mirrors py-clob-client.get_prices()). Both shapes cap at 500 items per request.

token_ids

string[]

required

Required array length: 1 - 500 elements

Response

Successful Response

Response Getprices
Response Getprices

{key}

string

Get MidpointGet the order-book midpoint for a single token. Public endpoint — no authentication required. Mirrors Polymarket's `GET /midpoint?token_id=...`.

Get Prices Batch

curl --request POST \
  --url https://api.polysimulator.com/v1/prices \
  --header 'Content-Type: application/json' \
  --data '
{
  "token_ids": [
    "<string>"
  ]
}
'

{}