Account Data

Get Ledgers Info

Retrieve information about ledger entries. 50 results are returned at a time, the most recent by default. Set with_cursor to page through results with cursor.

Pass account_id to retrieve ledger entries for a specific wallet. Omit it to use the authenticated user's default wallet. Use List Wallet Accounts to obtain wallet account IDs.

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/Ledgers

Request

  • Base URL: https://api.kraken.com/0
  • URL: https://api.kraken.com/0/private/Ledgers
  • 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

aclassstring

Filter output by asset class. Deprecated, use the { asset, aclass } list form of asset instead.

type'all' | 'trade' | 'deposit' | 'withdrawal' | 'transfer' | 'margin' | 'adjustment' | 'rollover' | 'credit' | 'settled' | 'staking' | 'dividend' | 'sale' | 'nft_rebate'

Type of ledger to retrieve

startinteger

Starting unix timestamp or ledger ID of results (exclusive)

endinteger

Ending unix timestamp or ledger ID of results (inclusive)

ofsinteger

Result offset for pagination. Deprecated, use with_cursor and cursor instead. Must be absent or 0 when with_cursor is true.

with_cursorboolean

Use cursor-based pagination instead of ofs. Each page holds up to 50 ledger entries, and the response includes cursor.next when more entries are available. start and end still narrow the range. Skips the count query, so count is returned as null.

cursorstring

Opaque pagination token from cursor.next of the previous page. Requires with_cursor.

without_countboolean

If true, does not retrieve count of ledger entries (count is returned as null). Request can be noticeably faster for users with many ledger entries as this avoids an extra database query.

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,
  "type": "trade",
  "start": 1695728276,
  "end": 1695828276
}

Response

Ledgers info retrieved.

errorstring[]

Example response

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

Changes

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