> ## 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.
# getTokenAccountsByOwner
> getTokenAccountsByOwner devuelve todas las cuentas de tokens SPL que pertenecen a una billetera de Solana, filtradas por acuñación o programa de tokens, con sincronizaciones incrementales mediante changedSinceSlot.
**Nueva función**: `getTokenAccountsByOwner` ahora admite el parámetro `changedSinceSlot` para actualizaciones incrementales. Cuando se especifica, el método devuelve solo las cuentas de tokens que se modificaron en el número de slot indicado o después de este. Esto es ideal para hacer un seguimiento de los cambios en los saldos de tokens y de las actualizaciones de la cartera.
## Parámetros de la solicitud
Dirección de la billetera de Solana (clave pública) del propietario de la cuenta cuyas tenencias de tokens quieres consultar, como una cadena codificada en base 58.
Dirección de acuñación específica de un token de Solana para recuperar solo las cuentas de un token o NFT determinado.
ID específico del programa de tokens de Solana (normalmente, el programa SPL Token) que creó las cuentas de tokens.
Nivel de confirmación de la solicitud.
* `confirmed`
* `finalized`
* `processed`
Slot mínimo en el que se puede evaluar la solicitud.
Solicita una sección de los datos de la cuenta.
Número de bytes que se devolverán.
Desplazamiento en bytes a partir del cual se inicia la lectura.
Formato de codificación de los datos de la cuenta.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Devuelve solo las cuentas que se modificaron en este número de slot o después de este. Resulta útil para las actualizaciones incrementales.
## OpenAPI
````yaml es/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API integral de descubrimiento de cuentas de tokens de Solana para recuperar
saldos de tokens SPL, NFT y otras tenencias de tokens asociadas con
cualquier dirección de billetera en la blockchain de Solana.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Punto de conexión RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountsByOwner
description: >
Recupera todas las cuentas de tokens SPL que pertenecen a una dirección
específica de billetera de Solana mediante potentes opciones de
filtrado.
Esta API esencial permite a los desarrolladores descubrir todas las
tenencias de tokens, incluidos los tokens fungibles y NFT,
con la capacidad de filtrar por acuñaciones de tokens específicas o
limitar los resultados a cuentas creadas por programas de tokens
concretos.
Admite datos analizados para ofrecer información legible sobre los
tokens, incluidos saldos, decimales y estado de propiedad.
Es fundamental para billeteras, rastreadores de portafolios y
aplicaciones DeFi que necesitan datos completos sobre tenencias de
tokens.
operationId: getTokenAccountsByOwner
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:
- getTokenAccountsByOwner
description: El nombre del método RPC que se invocará.
example: getTokenAccountsByOwner
default: getTokenAccountsByOwner
params:
type: array
description: >-
Parámetros para consultar las cuentas de tokens que
pertenecen a una clave pública específica.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Dirección de la billetera de Solana (clave pública)
del propietario de la cuenta cuyas tenencias de tokens
se consultarán, como una cadena codificada en base 58.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: >-
Configuración de filtros para restringir las cuentas
de tokens por dirección de acuñación o ID de programa.
properties:
mint:
type: string
description: >-
Dirección de acuñación específica de un token de
Solana para recuperar únicamente las cuentas de un
token o NFT concreto.
example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
programId:
type: string
description: >-
ID específico del programa de tokens de Solana
(normalmente el programa SPL Token) que creó las
cuentas de tokens.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Objeto de configuración con campos opcionales.
properties:
commitment:
type: string
description: El nivel de compromiso de la solicitud.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
El slot mínimo en el que se puede evaluar la
solicitud.
example: 1000
dataSlice:
type: object
description: Solicita una porción de los datos de la cuenta.
properties:
length:
type: integer
description: Cantidad de bytes que se devolverán.
example: 10
offset:
type: integer
description: >-
Desplazamiento en bytes desde el que se
comenzará a leer.
example: 0
encoding:
type: string
description: Formato de codificación de los datos de la cuenta.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
changedSinceSlot:
type: integer
description: >-
Devuelve únicamente las cuentas que se modificaron
en este número de slot o después. Es útil para
actualizaciones incrementales.
example: 464175999
responses:
'200':
description: Las cuentas de tokens se recuperaron correctamente por propietario.
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 de la cuenta.
properties:
context:
type: object
description: Contexto de la respuesta.
properties:
apiVersion:
type: string
description: Versión de la API.
example: 2.0.15
slot:
type: integer
description: Slot en el que se obtuvieron los datos.
example: 341197933
value:
type: array
description: Lista de cuentas de tokens.
items:
type: object
properties:
pubkey:
type: string
description: >-
Clave pública de la cuenta como una cadena
codificada en base 58.
example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: Detalles de la cuenta de tokens.
properties:
lamports:
type: integer
description: Cantidad de lamports asignados a la cuenta.
example: 2039280
owner:
type: string
description: >-
Clave pública del programa al que se asignó
esta cuenta.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
type: object
description: >-
Datos del estado del token asociados con la
cuenta.
properties:
program:
type: string
description: Nombre del programa.
example: spl-token
parsed:
type: object
description: Datos analizados del token.
properties:
info:
type: object
description: Información de la cuenta de tokens.
properties:
isNative:
type: boolean
description: Indica si la cuenta contiene SOL nativo.
example: false
mint:
type: string
description: Clave pública de la acuñación del token.
example: >-
2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner:
type: string
description: >-
Clave pública del propietario de la
cuenta.
example: >-
A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state:
type: string
description: Estado de la cuenta de tokens.
example: initialized
tokenAmount:
type: object
description: Detalles de la cantidad de tokens.
properties:
amount:
type: string
description: Saldo bruto sin decimales.
example: '420000000000000'
decimals:
type: integer
description: Cantidad de decimales.
example: 6
uiAmount:
type: number
description: >-
Saldo en un formato fácil de
interpretar.
example: 420000000
uiAmountString:
type: string
description: Saldo como cadena.
example: '420000000'
space:
type: integer
description: Espacio asignado a la cuenta.
example: 165
executable:
type: boolean
description: Indica si la cuenta contiene un programa.
example: false
rentEpoch:
type: integer
description: >-
Época en la que la cuenta deberá pagar el
próximo alquiler.
example: 18446744073709552000
space:
type: integer
description: Tamaño de los datos de la cuenta.
example: 165
example:
jsonrpc: '2.0'
id: '1'
result:
context:
apiVersion: 2.0.15
slot: 341197933
value:
- pubkey: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
lamports: 2039280
owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
program: spl-token
parsed:
info:
isNative: false
mint: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state: initialized
tokenAmount:
amount: '420000000000000'
decimals: 6
uiAmount: 420000000
uiAmountString: '420000000'
space: 165
executable: false
rentEpoch: 18446744073709552000
space: 165
'400':
description: >-
Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
con formato incorrecto.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: 'No autorizado: la clave de API no es válida o falta.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
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: Too many requests
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: Internal error
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: Service unavailable
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: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
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).
````