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.

Path Parameters

address
string
required

Wallet, 0x + 40 hex.

Pattern: ^0x[0-9a-fA-F]{40}$

Query Parameters

coin
string

One market, e.g. BTC, xyz:TSLA (case-insensitive).

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

long or short (omit for both).

Available options:
long,
short
result
enum<string>

win (net PnL > 0) or loss (net PnL < 0); omit for all.

Available options:
win,
loss
min_notional
enum<string>

Minimum notional (|size| × entry price, USD): 1000, 10000, 100000 or 1000000.

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

Sort column (ties: 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 (same filters, sort and limit).

Response

OK

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