Markets

Batch market flow

Changed on

Returns each market's flow and top positions for 1-25 raw provider condition_id values. Results preserve request order, duplicate inputs return duplicate rows, and each item is charged one batch item unit before execution. Do not pass prefixed mkt_ IDs; use market.condition_id from search or explore.

post/api/v1/markets/flow/batch

Request

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Request body

condition_idsstring[] required

Market condition IDs to resolve in input order.

timeframe'1h' | '4h' | '24h' | '7d'

Lookback window used for flow and trade-count context.

Response

Ordered batch market-flow results

object'market_flow_batch' required

Changes