Get spread history - Struct Docs

[ { "ts": 123, "position_id": "<string>", "condition_id": "<string>", "best_bid": 123, "best_ask": 123, "mid_price": 123, "spread": 123, "bid_liquidity_usd": 123, "ask_liquidity_usd": 123, "bid_levels": 123, "ask_levels": 123 } ]

Query Parameters

position_id

string

Token ID (required if condition_id / market_slug not set)

condition_id

string

Condition ID — returns spread history for all positions in this market

market_slug

string

Market slug (alternative to condition_id)

from

integer<int64>

Start timestamp (Unix milliseconds, inclusive)

integer<int64>

End timestamp (Unix milliseconds, inclusive)

min_spread

number<double>

Only return rows with spread >= this value

max_spread

number<double>

Only return rows with spread <= this value

min_liquidity

number<double>

Only return rows where total liquidity (bid + ask) >= this value

limit

integer<int64>

Number of results (default: 20, max: 200)

pagination_key

string

Cursor from previous response's pagination.pagination_key

Response

Spread time series rows, newest first. ts is Unix milliseconds.

integer<int64>

required

Unix timestamp in seconds.

position_id

string

required

Position ID.

condition_id

string

required

Condition ID.

best_bid

number<double> | null

Best bid.

best_ask

number<double> | null

Best ask.

mid_price

number<double> | null

Mid price.

spread

number<double> | null

Spread.

bid_liquidity_usd

number<double> | null

Bid liquidity in USD.

ask_liquidity_usd

number<double> | null

Ask liquidity in USD.

bid_levels

integer<int32> | null

Bid levels.

ask_levels

integer<int32> | null

Ask levels.