Query Ledgers
POST/private/QueryLedgers
Retrieve information about specific ledger entries.
Note on Staking/Earn assets: We have begun to migrate assets from our legacy Staking system over to a new Earn system. As such, the following assets may appear in your balances and ledger. Please see our Support article for more details. Note that these assets are "read-only", to interact with your balances in them please use the base asset (e.g.
USDT
to transact with yourUSDT
andUSDT.F
balances).
.B
, which represents balances in new yield-bearing products, similar to.S
(staked) and.M
(opt-in rewards) balances.F
, which represents balances earning automatically in Kraken Rewards
API Key Permissions Required: Data - Query ledger entries
Request
- application/json
Body
required
Nonce used in construction of API-Sign
header
Comma delimited list of ledger IDs to query info about (20 maximum)
Whether or not to include trades related to position in output
Responses
- 200
Ledgers info retrieved.
- application/json
- Schema
- Example (from schema)
Schema
result object
property name* LedgerEntry
Ledger Entry
Reference Id of the parent transaction (trade, deposit, withdrawal, etc.) that caused the ledger entry.
Unix timestamp of ledger
Possible values: [none
, trade
, deposit
, withdrawal
, transfer
, margin
, adjustment
, rollover
, spend
, receive
, settled
, credit
, staking
, reward
, dividend
, sale
, conversion
, nfttrade
, nftcreatorfee
, nftrebate
, custodytransfer
]
Type of ledger entry
Additional info relating to the ledger entry type, where applicable
Asset class
Asset
Transaction amount
Transaction fee
Resulting balance
{
"error": [],
"result": {
"L4UESK-KG3EQ-UFO4T5": {
"refid": "TJKLXF-PGMUI-4NTLXU",
"time": 1688464484.1787,
"type": "trade",
"subtype": "",
"aclass": "currency",
"asset": "ZGBP",
"amount": "-24.5000",
"fee": "0.0490",
"balance": "459567.9171"
}
}
}