Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

hdk_sk_live_v1_… or hdk_sk_test_v1_…

Headers

X-Max-Credits
integer

Refuse (free) if the request could cost more.

X-Credit-Price-Version
integer

Expected price version; 409 price_changed if it differs.

Query Parameters

by
enum<string>
default:segment

segment (per bucket) or market (window totals; window ≤ 7 days, default 7 days).

Available options:
segment,
market
segment
string

One segment (omit for all).

Pattern: ^(core|spot|outcome|dex:[a-z0-9]{1,16})$
coin
string

One market (omit for all).

Pattern: ^[A-Za-z0-9:_\-/@.]{1,40}$
interval
enum<string>
default:1d

Bucket size.

Available options:
1h,
1d
start_time
integer

Start, epoch ms (inclusive). Default: end_time − 1 day (1h) / 7 days (1d). Range ≤ 7 days.

end_time
integer

End, epoch ms (exclusive). Default: now. Clamped to the data (meta.as_of).

Response

OK

data
object[]
required
has_more
boolean
required
next_cursor
string | null
required
meta
object
required