Get Ledgers Info

Retrieve information about ledger entries. 50 results are returned at a time, the most recent by default.

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

Get Ledgers Info

cURL

curl --request POST \
  --url https://api.kraken.com/0/private/Ledgers \
  --header 'API-Key: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nonce": 1695828490,
  "type": "trade",
  "start": 1695728276,
  "end": 1695828276
}
'

200

{
  "error": [],
  "result": {
    "ledger": {
      "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"
      },
      "LMKZCZ-Z3GVL-CXKK4H": {
        "refid": "TBZIP2-F6QOU-TMB6FY",
        "time": 1688444262.8888,
        "type": "trade",
        "subtype": "",
        "aclass": "currency",
        "asset": "ZUSD",
        "amount": "0.9852",
        "fee": "0.0010",
        "balance": "52732.1132"
      }
    },
    "count": 2
  }
}

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

asset · string · default: all

Filter output by asset or comma delimited list of assets

aclass · string · default: currency

Filter output by asset class

type · enum<string> · default: all

Type of ledger to retrieve

Available options: all, trade, deposit, withdrawal, transfer, margin, adjustment, rollover, credit, settled, staking, dividend, sale, nft_rebate

start · integer

Starting unix timestamp or ledger ID of results (exclusive)

end · integer

Ending unix timestamp or ledger ID of results (inclusive)

ofs · integer

Result offset for pagination

without_count · boolean · default: false

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

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 · LedgersInfo · object

Ledgers Info

Show child attributes

error · string[]

Kraken API error