Get Prediction Spread History

Get historical bid/ask spread evolution for a specific outcome. This is a time-series of spread data, not a live order book (see Market Order Book for live bids/asks).

GET /2/pm/market/spread-history

Get Prediction Spread History

cURL

curl --request GET \
  --url https://pm-api-prod-eu.mobula.io/api/2/pm/market/spread-history

200

{
  "data": [
    {}
  ]
}

Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

Query Parameters

platform · enum<string> · required

Prediction market platform. Today only polymarket is supported; any other value returns 400.

Available options: polymarket

Example:

"polymarket"

outcomeId · string · required

Polymarket outcome / token ID — uint256 decimal string (the ERC-1155 token id of the YES/NO/etc. side).

Pattern: ^[0-9]+$

Example:

"59855952379545476461266875939089074481171378466995213858930892770855011813551"

period · enum<string> · default: 5m

Candle resolution.

Available options: 1m, 5m, 15m, 1h, 4h, 1d

limit · integer · default: 100

Page size (1-500).

Required range: 1 <= x <= 500

offset · integer · default: 0

Pagination offset.

Required range: x >= 0

Response

200 - application/json

Spread history

data · object[]