Account Data

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

Request

  • Base URL: https://api.kraken.com/0
  • URL: https://api.kraken.com/0/private/QueryLedgers
  • Auth: API key in header API-Key and API key in header API-Sign

Query parameters

account_idstring

Public wallet account ID. Omit to use the authenticated user's default wallet. See List Wallet Accounts.

Request body

nonceinteger required

Nonce used in construction of API-Sign header

idstring required

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

tradesboolean

Whether or not to include trades related to position in output. Deprecated, do not rely on this parameter.

rebase_multiplier'rebased' | 'base' nullable

Optional parameter for viewing xStocks data.

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

Example request

{
  "nonce": 1695828490,
  "id": "LUI2RA-CJFLB-EN5I4P, L2QE42-IGSZ3-WEVTLK"
}

Response

Ledgers info retrieved.

resultobject
errorstring[]

Example response

{
  "error": [
    "EGeneral:Invalid arguments"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.