> ## Documentation Index > Fetch the complete documentation index at: https://docs.kraken.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://support.kraken.com/hc/en-us/articles/360039879471-What-is-Asset-S-and-Asset-M-) 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` ## OpenAPI ````yaml /openapi/spot-rest.yaml post /private/Ledgers openapi: 3.0.0 info: title: REST API version: 1.1.0 description: '' servers: - url: https://api.kraken.com/0 description: Production Server security: - API-Key: [] API-Sign: [] tags: - name: Market Data - name: Account Data - name: Trading - name: Funding - name: Subaccounts description: >- Subaccounts are currently only available to institutional clients. Please contact your Account Manager for more details. - name: Earn description: > The earn API allows interacting with all of Kraken's yield generating products. It replaces the old `/staking` part of the API. The different available earn products are represented by earn strategies. This corresponds to the legacy `Staking/Assets`. `Stake`/`Unstake` are replaced by `Allocate`/`Deallocate`. ### Overview of the available endpoints under `/Earn`: - `Strategies` - list all earn strategies for which you are eligible or have a balance. - `Allocations` - lists the balance in your earn account for each strategy. Requires the `Query Funds` API key permission. - `Allocate`/`Deallocate` - allocate/deallocate to an earn strategy through an async operation. Requires the `Earn Funds` API key permission. - `AllocateStatus`/`DeallocateStatus` - verifies the state of the last allocation/deallocation. Requires the `Earn Funds` or `Query Funds` API key permission. ### Example usage: ### Determine which funds are earning rewards: 1. Call `Strategies` to obtain information about the relevant strategy. The `lock_type` field shows whether bonding/unbonding funds are earning yield. The relevant fields are `bonding_rewards`/`unbonding_rewards`. 2. Call `Allocations` for the relevant strategy. From the previous step, for strategies where bonding/unbonding does not earn yield, substract these balances from `amount_allocated.total` to determine which balances are currently earning. ### Get allocatable balance: Call `/0/private/BalanceEx`, subtract `hold_trading` amount. Remaining balance is available for allocation to a strategy. ### Geo restrictions: Some earn strategies are not available in all geographic regions. `Strategies` will return only strategies available to the caller. - name: Transparency paths: /private/Ledgers: post: tags: - Account Data summary: Get Ledgers Info description: > 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](https://support.kraken.com/hc/en-us/articles/360039879471-What-is-Asset-S-and-Asset-M-) 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` operationId: getLedgers requestBody: $ref: '#/components/requestBodies/info' responses: '200': description: Ledgers info retrieved. content: application/json: schema: $ref: '#/components/schemas/info-3' example: 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 components: requestBodies: info: required: true content: application/json: schema: title: Get Ledgers Info Request Body required: - nonce type: object properties: nonce: $ref: '#/components/schemas/nonce' asset: description: Filter output by asset or comma delimited list of assets type: string default: all aclass: description: Filter output by asset class type: string default: currency type: description: Type of ledger to retrieve type: string default: all enum: - all - trade - deposit - withdrawal - transfer - margin - adjustment - rollover - credit - settled - staking - dividend - sale - nft_rebate start: description: Starting unix timestamp or ledger ID of results (exclusive) type: integer end: description: Ending unix timestamp or ledger ID of results (inclusive) type: integer ofs: description: Result offset for pagination type: integer without_count: description: >- 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. type: boolean default: false rebase_multiplier: $ref: '#/components/schemas/rebase_multiplier' example: nonce: 1695828490 type: trade start: 1695728276 end: 1695828276 schemas: info-3: type: object properties: result: title: LedgersInfo description: Ledgers Info type: object properties: ledger: type: object additionalProperties: $ref: '#/components/schemas/ledger' x-additionalPropertiesName: ledger_id count: description: Amount of available ledger info matching criteria type: integer error: $ref: '#/components/schemas/error' nonce: description: Nonce used in construction of `API-Sign` header type: integer format: int64 rebase_multiplier: type: string enum: - rebased - base default: rebased nullable: true description: | Optional parameter for viewing xstocks data. - `rebased`: Display in terms of underlying equity. - `base`: Display in terms of SPV tokens. ledger: title: LedgerEntry description: Ledger Entry type: object properties: refid: description: >- Reference Id of the parent transaction (trade, deposit, withdrawal, etc.) that caused the ledger entry. type: string time: description: Unix timestamp of ledger type: number type: description: Type of ledger entry type: string enum: - none - trade - deposit - withdrawal - transfer - margin - adjustment - rollover - spend - receive - settled - credit - staking - reward - dividend - sale - conversion - nfttrade - nftcreatorfee - nftrebate - custodytransfer subtype: description: Additional info relating to the ledger entry type, where applicable type: string aclass: description: Asset class type: string asset: description: Asset type: string amount: description: Transaction amount type: string fee: description: Transaction fee type: string balance: description: Resulting balance type: string error: type: array items: description: Kraken API error type: string example: EGeneral:Invalid arguments securitySchemes: API-Key: type: apiKey description: The "API-Key" header should contain your API key. name: API-Key in: header API-Sign: type: apiKey description: >- Authenticated requests should be signed with the "API-Sign" header, using a signature generated with your private key, nonce, encoded payload, and URI path. name: API-Sign in: header ````