Query Ledgers

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 your USDT and USDT.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

POST /private/QueryLedgers

Query Ledgers

cURL

curl --request POST \
  --url https://api.kraken.com/0/private/QueryLedgers \
  --header 'API-Key: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nonce": 1695828490,
  "id": "LUI2RA-CJFLB-EN5I4P, L2QE42-IGSZ3-WEVTLK",
  "trade": false
}
'

200

{
  "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"
    }
  }
}

Authorizations

API-Key · string · header · required

The "API-Key" header should contain your API key.

API-Sign · string · header · required

Authenticated requests should be signed with the "API-Sign" header, using a signature generated with your private key, nonce, encoded payload, and URI path.

Body

application/json

nonce · integer<int64> · required

Nonce used in construction of API-Sign header

id · string · required

Comma delimited list of ledger IDs to query info about (20 maximum)

trades · boolean · default: false

Whether or not to include trades related to position in output

rebase_multiplier · enum<string> | null · default: rebased

Optional parameter for viewing xstocks data.

• rebased: Display in terms of underlying equity.
• base: Display in terms of SPV tokens.

Available options: rebased, base

Response

200 - application/json

Ledgers info retrieved.

result · object

Show child attributes

error · string[]

Kraken API error