> ## 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
> Devuelve el saldo de tokens de una cuenta de tokens SPL.
## Parámetros de la solicitud
Dirección de la cuenta de tokens SPL de Solana cuyo saldo quieres consultar, como una cadena codificada en base 58.
El nivel de confirmación de la solicitud.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml es/openapi/rpc-http/getTokenAccountBalance.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API rápida y confiable para consultar saldos de tokens SPL de Solana y
acceder a saldos de tokens fungibles y NFT con el formato decimal correcto y
cantidades legibles.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountBalance
description: >
Consulta saldos de tokens SPL desde cualquier cuenta de tokens de Solana
con el formato decimal correcto.
Esta API esencial proporciona acceso a saldos de tokens fungibles,
tenencias de NFT y otros
datos de tokens SPL, con compatibilidad para las posiciones decimales
específicas de cada token y una visualización precisa.
Devuelve saldos sin procesar y con formato, con cantidades legibles,
algo esencial para
billeteras, aplicaciones DeFi, plataformas de intercambio y cualquier
servicio que necesite mostrar
saldos de tokens a los usuarios.
operationId: getTokenAccountBalance
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenAccountBalance
description: El nombre del método RPC que se invocará.
example: getTokenAccountBalance
default: getTokenAccountBalance
params:
type: array
description: Parámetros para consultar el saldo de la cuenta de tokens.
default:
- 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
items:
oneOf:
- type: string
description: >-
Dirección de la cuenta de tokens SPL de Solana cuyo
saldo se consultará, como una cadena codificada en
base 58.
example: 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
- type: object
description: Opciones de configuración.
properties:
commitment:
type: string
description: El nivel de compromiso para la solicitud.
enum:
- confirmed
- finalized
- processed
example: finalized
responses:
'200':
description: El saldo de la cuenta de tokens se consultó correctamente.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
result:
type: object
description: Contexto y detalles del saldo de la cuenta de tokens.
properties:
context:
type: object
description: Contexto de la respuesta.
properties:
slot:
type: integer
description: Slot en el que se obtuvieron los datos.
example: 1114
value:
type: object
description: Detalles del saldo de la cuenta de tokens.
properties:
amount:
type: string
description: >-
El saldo sin procesar del token de Solana como una
cadena de enteros sin formato decimal.
example: '9864'
decimals:
type: integer
description: >-
Número de posiciones decimales definidas por la
acuñación del token para mostrarlo con el formato
correcto.
example: 2
uiAmount:
type: number
description: >-
El saldo legible del token de Solana con el
formato decimal correcto (obsoleto).
example: 98.64
uiAmountString:
type: string
description: >-
La representación canónica en cadena del saldo del
token con las posiciones decimales correctas.
example: '98.64'
examples:
default:
$ref: '#/components/examples/getTokenAccountBalanceResponse'
'400':
description: >-
Solicitud incorrecta: los parámetros de la solicitud no son válidos
o la solicitud está mal formada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Parámetros no válidos
id: '1'
'401':
description: 'No autorizado: la clave de API no es válida o no se proporcionó.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: No autorizado
id: '1'
'429':
description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Demasiadas solicitudes
id: '1'
'500':
description: 'Error interno del servidor: se produjo un error en el servidor.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Error interno
id: '1'
'503':
description: >-
Servicio no disponible: el servicio no está disponible
temporalmente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Servicio no disponible
id: '1'
'504':
description: >-
Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
de espera de la solicitud.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tiempo de espera de la puerta de enlace agotado
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: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: El código de error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````