> ## 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
> Returns the token balance of an SPL Token account.
## Request Parameters
Solana SPL token account address to query for balance information, as a base-58 encoded string.
The commitment level for the request.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml openapi/rpc-http/getTokenAccountBalance.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Fast and reliable Solana SPL token balance retrieval API for accessing
fungible token and NFT balances with proper decimal formatting and
human-readable amounts.
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 endpoint
- url: https://devnet.helius-rpc.com
description: Devnet RPC endpoint
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountBalance
description: >
Retrieve SPL token balances from any Solana token account with proper
decimal formatting.
This essential API provides access to fungible token balances, NFT
holdings, and other
SPL token data with support for token-specific decimal places for
accurate display.
Returns both raw and formatted balances with human-readable amounts,
critical for
wallets, DeFi applications, exchanges, and any service that needs to
display
token balances to users.
operationId: getTokenAccountBalance
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The JSON-RPC protocol version.
example: '2.0'
default: '2.0'
id:
type: string
description: A unique identifier for the request.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenAccountBalance
description: The name of the RPC method to invoke.
example: getTokenAccountBalance
default: getTokenAccountBalance
params:
type: array
description: Parameters for querying the token account balance.
default:
- 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
items:
oneOf:
- type: string
description: >-
Solana SPL token account address to query for balance
information, as a base-58 encoded string.
example: 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
- type: object
description: Configuration options.
properties:
commitment:
type: string
description: The commitment level for the request.
enum:
- confirmed
- finalized
- processed
example: finalized
examples:
default:
$ref: '#/components/examples/getTokenAccountBalanceRequest'
responses:
'200':
description: Successfully retrieved the token account balance.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: The JSON-RPC protocol version.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identifier matching the request.
example: '1'
result:
type: object
description: Context and token account balance details.
properties:
context:
type: object
description: Context of the response.
properties:
slot:
type: integer
description: Slot in which the data was fetched.
example: 1114
value:
type: object
description: Token account balance details.
properties:
amount:
type: string
description: >-
The raw Solana token balance as a string integer
without decimal formatting.
example: '9864'
decimals:
type: integer
description: >-
Number of decimal places defined by the token's
mint for proper display formatting.
example: 2
uiAmount:
type: number
description: >-
The human-readable Solana token balance with
proper decimal formatting (deprecated).
example: 98.64
uiAmountString:
type: string
description: >-
The canonical string representation of the token
balance with proper decimal places.
example: '98.64'
examples:
default:
$ref: '#/components/examples/getTokenAccountBalanceResponse'
'400':
description: Bad Request - Invalid request parameters or malformed request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Unauthorized - Invalid or missing API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Too Many Requests - Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Internal Server Error - An error occurred on the server.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Service Unavailable - The service is temporarily unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Gateway Timeout - The request timed out.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
examples:
getTokenAccountBalanceRequest:
value:
jsonrpc: '2.0'
id: '1'
method: getTokenAccountBalance
params:
- 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
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: The JSON-RPC protocol version.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: The error code.
example: -32602
message:
type: string
description: The error message.
data:
type: object
description: Additional data about the error.
id:
type: string
description: Identifier matching the request.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Your Helius API key. You can get one for free in the
[dashboard](https://dashboard.helius.dev/api-keys).
````