> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ledger.nxos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Balance History for an Account and Asset



## OpenAPI

````yaml ledger-openapi get /v1/ledger/{ledger_key}/account/{account_key}/asset/{asset_code}/balance/history
openapi: 3.0.0
info:
  title: Ledger API
  version: 0.0.0
servers:
  - url: https://api.sandbox.nxos.io
    description: single server endpoint
    variables: {}
security: []
tags: []
paths:
  /v1/ledger/{ledger_key}/account/{account_key}/asset/{asset_code}/balance/history:
    get:
      summary: List Balance History
      operationId: Accounts_listBalanceHistory
      parameters:
        - $ref: '#/components/parameters/BasicAuthHeader'
        - $ref: '#/components/parameters/PaginationQuery.cursor'
        - $ref: '#/components/parameters/PaginationQuery.limit'
        - $ref: '#/components/parameters/LedgerKey'
        - $ref: '#/components/parameters/AccountKey'
        - $ref: '#/components/parameters/AssetCode'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AccountBalanceHistory'
components:
  parameters:
    BasicAuthHeader:
      name: Authorization
      in: header
      required: true
      description: |-
        The Basic Authentication header.
        Format: "Basic {base64(orgID:apiKey)}"
      schema:
        type: string
    PaginationQuery.cursor:
      name: cursor
      in: query
      required: false
      description: >-
        The cursor for the next set of results.

        This is an opaque string representing the starting point for the next
        page.

        For the first request, this should be omitted or set to null.
      schema:
        type: string
    PaginationQuery.limit:
      name: limit
      in: query
      required: false
      description: |-
        The number of items to be returned per page.
        Determines the page size for the paginated results.
        Default value: 25
        Maximum value: 100 (to prevent excessive load on the server)
      schema:
        type: integer
        format: int32
        default: 25
    LedgerKey:
      name: ledger_key
      in: path
      required: true
      description: |-
        The key of the ledger. 
        Examples: 
        - "123e4567-e89b-12d3-a456-426614174000"
        - "id:123e4567-e89b-12d3-a456-426614174000"
        - "ref:ledger:customer_a"
      schema:
        type: string
    AccountKey:
      name: account_key
      in: path
      required: true
      description: |-
        The key of the account. 
        Examples: 
        - "123e4567-e89b-12d3-a456-426614174000"
        - "id:123e4567-e89b-12d3-a456-426614174000"
        - "ref:internal:revenue:fx"
      schema:
        type: string
    AssetCode:
      name: asset_code
      in: path
      required: true
      description: |-
        The code of the asset.
        Examples:
        - "USD"        (US Dollar)
        - "EUR"        (Euro)
        - "AAPL"       (Apple Inc. stock)
        - "BTC"        (Bitcoin)
        - "USD/2"      (Custom USD variant)
        - "USD/4"      (Another USD variant)
        - "GOLD_OZ"    (Gold per ounce)
        - "LOYALTY_PTS" (Custom loyalty points)
      schema:
        type: string
  schemas:
    AccountBalanceHistory:
      type: object
      required:
        - account_id
        - account_ref
        - asset_code
        - old_balance
        - new_balance
        - balance_updated_at
      properties:
        account_id:
          type: string
          format: uuid
          description: The internally generated Id of the account (uuid)
        account_ref:
          type: string
          minLength: 1
          description: The account reference
        asset_code:
          type: string
          minLength: 1
        old_balance:
          type: integer
          format: int64
        new_balance:
          type: integer
          format: int64
        balance_updated_at:
          type: string
          format: date-time

````