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

# getTokenAccountBalance

> Gibt das Token-Guthaben eines SPL-Token-Kontos zurück.

## Anfrageparameter

<ParamField body="address" type="string" required>
  Solana SPL-Token-Kontoadresse, um Informationen zum Guthaben abzufragen, als base-58-kodierter String.
</ParamField>

<ParamField body="commitment" type="string">
  Der Verbindlichkeitsgrad für die Anfrage.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>


## OpenAPI

````yaml de/openapi/rpc-http/getTokenAccountBalance.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    Schnelle und zuverlässige API zur Abfrage von Salden von Solana SPL-Token
    für den Zugriff auf fungible Token und NFT-Salden mit korrekter
    Dezimalformatierung und menschenlesbaren Beträgen.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Mainnet-RPC-Endpunkt
  - url: https://devnet.helius-rpc.com
    description: Devnet-RPC-Endpunkt
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTokenAccountBalance
      description: >
        Abrufen von SPL-Token-Salden von jedem Solana-Token-Konto mit korrekter
        Dezimalformatierung.

        Diese wesentliche API bietet Zugriff auf fungible Token-Salden,
        NFT-Bestände und andere

        SPL-Token-Daten mit Unterstützung für token-spezifische Dezimalstellen
        für eine genaue Anzeige.

        Gibt sowohl rohe als auch formatierte Salden mit menschenlesbaren
        Beträgen zurück, was kritisch ist für

        Wallets, DeFi-Anwendungen, Börsen und jeden Dienst, der Token-Salden
        anzeigen muss.
      operationId: getTokenAccountBalance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: Die JSON-RPC-Protokollversion.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Ein eindeutiger Bezeichner für die Anfrage.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTokenAccountBalance
                  description: Der Name der RPC-Methode, die aufgerufen werden soll.
                  example: getTokenAccountBalance
                  default: getTokenAccountBalance
                params:
                  type: array
                  description: Parameter zur Abfrage des Token-Kontostandes.
                  default:
                    - 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Solana SPL-Token-Konto-Adresse zur Abfrage von
                          Saldeninformationen, als Base-58-codierter String.
                        example: 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
                      - type: object
                        description: Konfigurationsoptionen.
                        properties:
                          commitment:
                            type: string
                            description: Das Commitment-Level für die Anfrage.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
      responses:
        '200':
          description: Token-Kontostand erfolgreich abgerufen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Die JSON-RPC-Protokollversion.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Kennzeichen für die Übereinstimmung mit der Anfrage.
                    example: '1'
                  result:
                    type: object
                    description: Kontext- und Token-Kontostanddetails.
                    properties:
                      context:
                        type: object
                        description: Kontext der Antwort.
                        properties:
                          slot:
                            type: integer
                            description: Slot, in dem die Daten abgerufen wurden.
                            example: 1114
                      value:
                        type: object
                        description: Token-Kontostanddetails.
                        properties:
                          amount:
                            type: string
                            description: >-
                              Der rohe Solana-Token-Kontostand als
                              String-Integer ohne Dezimalformatierung.
                            example: '9864'
                          decimals:
                            type: integer
                            description: >-
                              Anzahl der Dezimalstellen, die durch das
                              Token-Mint für die richtige Anzeigeformulierung
                              definiert sind.
                            example: 2
                          uiAmount:
                            type: number
                            description: >-
                              Der menschenlesbare Solana-Token-Kontostand mit
                              korrekter Dezimalformatierung (veraltet).
                            example: 98.64
                          uiAmountString:
                            type: string
                            description: >-
                              Die kanonische String-Darstellung des
                              Token-Kontostands mit korrekten Dezimalstellen.
                            example: '98.64'
              examples:
                default:
                  $ref: '#/components/examples/getTokenAccountBalanceResponse'
        '400':
          description: >-
            Bad Request - Ungültige Anforderungsparameter oder fehlerhafte
            Anfrage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Ungültige Parameter
                id: '1'
        '401':
          description: Unauthorized - Ungültiger oder fehlender API-Schlüssel.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Nicht autorisiert
                id: '1'
        '429':
          description: Too Many Requests - Ratenlimit überschritten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Zu viele Anfragen
                id: '1'
        '500':
          description: Internal Server Error - Ein Fehler ist auf dem Server aufgetreten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Interner Fehler
                id: '1'
        '503':
          description: Service Unavailable - Der Dienst ist vorübergehend nicht verfügbar.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service nicht verfügbar
                id: '1'
        '504':
          description: Gateway Timeout - Die Anfrage hat ein Timeout erreicht.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway Timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  examples:
    getTokenAccountBalanceResponse:
      value:
        jsonrpc: '2.0'
        id: '1'
        result:
          context:
            slot: 1114
          value:
            amount: '9864'
            decimals: 2
            uiAmount: 98.64
            uiAmountString: '98.64'
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Die JSON-RPC-Protokollversion.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Der Fehlercode.
              example: -32602
            message:
              type: string
              description: Die Fehlermeldung.
            data:
              type: object
              description: Zusätzliche Daten über den Fehler.
        id:
          type: string
          description: Kennzeichen für die Übereinstimmung mit der Anfrage.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Ihr Helius-API-Schlüssel. Sie können einen kostenlos im
        [Dashboard](https://dashboard.helius.dev/api-keys) erhalten.

````