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

# getTokenAccountBalance

> Returns balance + decimals + UI amount for an SPL-token account address (not the wallet — the token account itself).




## OpenAPI

````yaml openapi-spec/solana-rpc/getTokenAccountBalance.yaml post /
openapi: 3.0.3
info:
  title: Raze Solana RPC — getTokenAccountBalance
  description: >
    Get an SPL-token account balance.


    Returns balance + decimals + UI amount for an SPL-token account address (not
    the wallet — the token account itself).


    Sent as JSON-RPC 2.0 over HTTPS to any regional gateway (`POST /`). The
    gateway

    proxies to a load-balanced pool of upstream validators with method-aware
    hedging.
  version: 1.0.0
servers:
  - url: https://rpc.raze.bot
    description: Raze global RPC edge — GeoDNS routes to the nearest region automatically
security: []
paths:
  /:
    post:
      summary: getTokenAccountBalance
      description: >
        Returns balance + decimals + UI amount for an SPL-token account address
        (not the wallet — the token account itself).
      operationId: getTokenAccountBalance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Request'
            examples:
              default:
                summary: Get an SPL-token account balance.
                value:
                  jsonrpc: '2.0'
                  id: 1
                  method: getTokenAccountBalance
                  params:
                    - DhzDoryP2a4rMK2bcWwJxrE2uW6ir81mSFWbdkPVtQB
      responses:
        '200':
          description: |
            JSON-RPC response. Inspect `result` (success) or `error` (failure).
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - $ref: '#/components/schemas/ErrorResponse'
              examples:
                success:
                  summary: Successful response
                  value:
                    jsonrpc: '2.0'
                    id: 1
                    result:
                      context:
                        slot: 418263080
                      value:
                        amount: '1000000000'
                        decimals: 6
                        uiAmount: 1000
                        uiAmountString: '1000'
                methodNotFound:
                  summary: No upstream supports this method
                  value:
                    jsonrpc: '2.0'
                    id: 1
                    error:
                      code: -32601
                      message: Method not found
components:
  schemas:
    Request:
      type: object
      required:
        - jsonrpc
        - method
        - params
      properties:
        jsonrpc:
          type: string
          enum:
            - '2.0'
          example: '2.0'
        id:
          oneOf:
            - type: integer
            - type: string
          example: 1
        method:
          type: string
          enum:
            - getTokenAccountBalance
          example: getTokenAccountBalance
        params:
          type: array
          description: |
            `[token_account, commitment?]`
          items: {}
          example:
            - DhzDoryP2a4rMK2bcWwJxrE2uW6ir81mSFWbdkPVtQB
    SuccessResponse:
      type: object
      required:
        - jsonrpc
        - result
      properties:
        jsonrpc:
          type: string
          example: '2.0'
        result: {}
        id:
          oneOf:
            - type: integer
            - type: string
          example: 1
    ErrorResponse:
      type: object
      required:
        - jsonrpc
        - error
      properties:
        jsonrpc:
          type: string
          example: '2.0'
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: integer
              description: |
                JSON-RPC error code. Common values:
                - `-32601` — Method not found (no upstream supports it)
                - `-32602` — Invalid params
                - `-32603` — Upstream error / all endpoints failed
                - `-32005` — Rate limited
            message:
              type: string
        id:
          oneOf:
            - type: integer
            - type: string
          example: 1

````