> ## 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.
# getTokenAccountsByDelegate
> Devuelve todas las cuentas de tokens SPL por delegado aprobado.
## Parámetros de la solicitud
Dirección de Solana (clave pública) del delegado autorizado para administrar cuentas de tokens.
Dirección de acuñación específica para filtrar las cuentas delegadas por un tipo de token determinado.
ID específico del programa de tokens (normalmente, el programa SPL Token) para filtrar las cuentas delegadas.
El nivel de confirmación de la solicitud.
* `confirmed`
* `finalized`
* `processed`
El 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 desde el que se comenzará a leer.
Formato de codificación de los datos de la cuenta.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
## OpenAPI
````yaml es/openapi/rpc-http/getTokenAccountsByDelegate.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API avanzada de Solana para consultar autorizaciones de tokens delegadas.
Permite que las aplicaciones recuperen todas las cuentas de tokens SPL que
hayan otorgado permisos específicos a direcciones de terceros.
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: getTokenAccountsByDelegate
description: >
Recupera todas las cuentas de tokens SPL que hayan delegado autoridad a
una dirección específica de Solana.
Esta potente API identifica todas las cuentas de tokens que hayan
otorgado permisos de gasto o administración
a aplicaciones de terceros, billeteras u otras direcciones delegadas. Es
esencial
para supervisar la seguridad, hacer seguimiento de delegaciones y
desarrollar aplicaciones que necesiten descubrir qué
cuentas de tokens tienen permiso para administrar o desde cuáles pueden
gastar. Admite filtros por tipos específicos
de tokens y niveles de autorización de delegación, con datos analizados
para facilitar la integración.
operationId: getTokenAccountsByDelegate
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:
- getTokenAccountsByDelegate
description: El nombre del método RPC que se invocará.
example: getTokenAccountsByDelegate
default: getTokenAccountsByDelegate
params:
type: array
description: Parámetros para consultar cuentas de tokens por delegado.
default:
- 4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Dirección de Solana (clave pública) del delegado
autorizado para administrar cuentas de tokens.
example: 4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
- type: object
description: >-
Configuración de filtros para limitar los resultados a
tipos de tokens o programas específicos.
properties:
mint:
type: string
description: >-
Dirección de acuñación específica para filtrar las
cuentas delegadas por un tipo concreto de token.
example: 3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E
programId:
type: string
description: >-
ID de un programa de tokens específico
(normalmente, el programa de tokens SPL) para
filtrar las cuentas delegadas.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Objeto de configuración.
properties:
commitment:
type: string
description: El nivel de confirmación de la solicitud.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
La ranura mínima en la que se puede evaluar la
solicitud.
example: 1000
dataSlice:
type: object
description: Solicita una secció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 cual se
empezará 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
responses:
'200':
description: Las cuentas de tokens por delegado se recuperaron 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: Detalles del contexto y de la cuenta.
properties:
context:
type: object
description: Contexto de la respuesta.
properties:
slot:
type: integer
description: Ranura en la que se obtuvieron los datos.
example: 1114
value:
type: array
description: Lista de cuentas de tokens.
items:
type: object
properties:
pubkey:
type: string
description: >-
Clave pública de la cuenta como cadena
codificada en base 58.
example: 28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp
account:
type: object
description: Detalles de la cuenta de tokens.
properties:
lamports:
type: integer
description: Cantidad de lamports asignados a la cuenta.
example: 1726080
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:
tokenAmount:
type: object
description: Detalles de la cantidad de tokens.
properties:
amount:
type: string
description: Saldo sin procesar y sin decimales.
example: '1'
decimals:
type: integer
description: Cantidad de decimales.
example: 1
uiAmount:
type: number
description: Saldo en un formato fácil de leer.
example: 0.1
uiAmountString:
type: string
description: Saldo como cadena.
example: '0.1'
delegate:
type: string
description: >-
La dirección de Solana a la que se
otorgó autorización de delegado para
gastar o administrar tokens.
example: >-
4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
delegatedAmount:
type: object
description: >-
La cantidad de tokens que el delegado
está autorizado a gastar en nombre del
propietario.
properties:
amount:
type: string
description: Saldo sin procesar y sin decimales.
example: '1'
decimals:
type: integer
description: Cantidad de decimales.
example: 1
uiAmount:
type: number
description: Saldo en un formato fácil de leer.
example: 0.1
uiAmountString:
type: string
description: Saldo como cadena.
example: '0.1'
state:
type: string
description: Estado de la cuenta de tokens.
example: initialized
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: >-
3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E
owner:
type: string
description: >-
Clave pública del propietario de la
cuenta.
example: >-
CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD
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á volver a
pagar renta.
example: 4
space:
type: integer
description: Tamaño de los datos de la cuenta.
example: 165
examples:
response:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 1114
value:
- pubkey: 28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp
account:
lamports: 1726080
owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
program: spl-token
parsed:
info:
tokenAmount:
amount: '1'
decimals: 1
uiAmount: 0.1
uiAmountString: '0.1'
delegate: 4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
delegatedAmount:
amount: '1'
decimals: 1
uiAmount: 0.1
uiAmountString: '0.1'
state: initialized
isNative: false
mint: 3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E
owner: CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD
type: account
space: 165
executable: false
rentEpoch: 4
space: 165
'400':
description: >-
Solicitud incorrecta: los parámetros de la solicitud no son válidos
o la solicitud tiene un formato incorrecto.
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: ocurrió 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:
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).
````