Skip to main content
GET
Get OHLCV bars for a market

Authorizations

X-API-KEY
string
header
required

Per-user API key. Create and revoke keys from your SOAR account settings. A revoked key stops working within 60 seconds.

Path Parameters

market_id
string
required

The market's ticker or its event_market_id UUID. Tickers are case-insensitive.

Pattern: ^[A-Za-z0-9.](?:[A-Za-z0-9.-]*[A-Za-z0-9.])?$
Example:

"ANTHROPIC-VALUATION-26Q3-1.05T"

Query Parameters

interval
enum<string>
default:1m

Bar width. 30s, 1m, 1h and 1d are stored rollups; 4h and 12h are re-aggregated from the hourly rollup at query time and cost slightly more. There is deliberately no other value: an interval with no backing rollup would return an empty series, and you could not tell that from a quiet market — so anything else is 400 naming the set.

Available options:
30s,
1m,
1h,
4h,
12h,
1d
from
string<date-time>

RFC3339 start of the window. Defaults to 24 hours ago.

to
string<date-time>

RFC3339 end of the window. Defaults to now. A from after to is 400 invalid_parameter, not an empty series — you cannot tell a mistyped range from a quiet market, and one of those you can fix.

Response

The bar series.

ticker
string
required
market_id
string<uuid>
required
interval
enum<string>
default:1m
required

Bar width. 30s, 1m, 1h and 1d are stored rollups; 4h and 12h are re-aggregated from the hourly rollup at query time and cost slightly more. There is deliberately no other value: an interval with no backing rollup would return an empty series, and you could not tell that from a quiet market — so anything else is 400 naming the set.

Available options:
30s,
1m,
1h,
4h,
12h,
1d
candles
object[]
required

Oldest first. [] when nothing traded in the window — never null.