View your past ledger entries. Most recent entries are returned by default, but a timestamp can be used to retrieve time-specific data.

The endpoint returns data up to 6 years old.


Retrieve all ledgers

The currency param can be omitted to return a ledger including all currencies. The path for this call is 'v2/auth/r/ledgers/hist'.

Possible values for 'category' filter

This table shows the possible values for the 'category' body param. The table shows the filter followed by the int value that should be entered in the 'category' param to activate the filter.

FilterInt ValueFilterInt ValueFilterInt Value
exchange5cancelled withdrawal105withdrawal fee254
position modified, closed or liquidated22trading fee201withdrawal express fee255
position claim23trading rebate202miner fee258
position transfer25hidden order fee204staking payment262
position swap26otc trade fee207adjustment401
position funding cost or interest charged27swap fee222expense501
margin / swap / interest payment28claiming fee224currency conversion / computation fee905
derivatives funding event29used margin funding charge226monthly profit payment907
settlement31unused margin funding fee228losses911
transfer51earned fee / affiliate rebate241
deposit101ETHFX loyalty fee243
withdrawal104deposit fee251


IDintLedger identifier
CURRENCYStringThe symbol of the currency (ex. "BTC")
MTSDateTimestamp in milliseconds
AMOUNTfloatAmount of funds moved
BALANCEfloatNew balance
DESCRIPTIONStringDescription of ledger transaction

Ratelimit: 90 req/min