Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Your API key, sent as Bearer hdk_sk_live_v1_….

Path Parameters

address
string
required

Wallet address: 0x followed by 40 hex characters.

Query Parameters

coin
string

One market, for example BTC or xyz:TSLA. Not case-sensitive.

side
enum<string>

long or short. Leave it out for both.

Available options:
long,
short
result
enum<string>

win is a net PnL above 0 and loss is a net PnL below 0. Leave it out for all trades.

Available options:
win,
loss
min_notional
enum<string>

Minimum notional in USD, which is absolute size times entry price: 1000, 10000, 100000 or 1000000.

Available options:
1000,
10000,
100000,
1000000
sort
enum<string>
default:close_time

Sort column. Ties are ordered newest close first.

Available options:
close_time,
net_pnl,
notional,
duration,
entry_px,
exit_px,
funding_pnl,
coin,
side
order
enum<string>
default:desc

Sort order.

Available options:
desc,
asc
limit
integer
default:100

Trades per page.

Required range: 1 <= x <= 200
cursor
string

Opaque cursor from next_cursor. Keep the same filters, sort and limit.

Response

OK

data
object[]
required

Result rows.

has_more
boolean
required

true when another page follows.

next_cursor
string | null
required

Cursor for the next page, passed as cursor. null on the last page.

meta
object
required

Response metadata. Its keys depend on the endpoint and are described above.