> ## 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
> Retorna todas as contas de Token SPL pelo Delegate aprovado.
## Parâmetros da Solicitação
Endereço Solana (chave pública) do delegado autorizado a gerenciar contas de token.
Endereço específico de mint de token para filtrar contas delegadas por um tipo de token específico.
ID do programa de token específico (geralmente programa de Token SPL) para filtrar contas delegadas.
Nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
* `processed`
O slot mínimo em que a solicitação pode ser avaliada.
Solicitar um segmento dos dados da conta.
Número de bytes a retornar.
Deslocamento de bytes a partir do qual iniciar a leitura.
Formato de codificação para os dados da Conta.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getTokenAccountsByDelegate.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API avançada do Solana para consultar autorizações de delegados de tokens,
permitindo que aplicativos recuperem todas as contas de token SPL que
concederam permissões específicas para endereços de terceiros.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Ponto de extremidade RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Ponto de extremidade RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountsByDelegate
description: >
Recupere todas as contas de token SPL que delegaram autoridade para um
endereço específico do Solana.
Esta poderosa API identifica todas as contas de token que concederam
permissões de gasto ou gerenciamento
para aplicativos de terceiros, carteiras ou outros endereços delegados.
Essencial
para monitoramento de segurança, acompanhamento de delegação e
aplicativos que precisam descobrir quais
contas de token têm permissão para gerenciar ou gastar. Suporta
filtragem por tipos específicos
de token e níveis de autorização de delegação com dados analisados
para fácil integração.
operationId: getTokenAccountsByDelegate
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Um identificador exclusivo para a solicitação.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenAccountsByDelegate
description: O nome do método RPC a ser invocado.
example: getTokenAccountsByDelegate
default: getTokenAccountsByDelegate
params:
type: array
description: Parâmetros para consultar contas de token por delegado.
default:
- 4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Endereço Solana (chave pública) do delegado que foi
autorizado a gerenciar contas de token.
example: 4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
- type: object
description: >-
Configuração de filtro para restringir resultados a
tipos específicos de token ou programas.
properties:
mint:
type: string
description: >-
Endereço específico de mint de token para filtrar
contas delegadas por um tipo de token particular.
example: 3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E
programId:
type: string
description: >-
ID específico do programa de token (tipicamente
programa de Token SPL) para filtrar contas
delegadas.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Objeto de configuração.
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
O slot mínimo em que a solicitação pode ser
avaliada.
example: 1000
dataSlice:
type: object
description: Solicitar um corte dos dados da conta.
properties:
length:
type: integer
description: Número de bytes a serem retornados.
example: 10
offset:
type: integer
description: >-
Deslocamento em bytes a partir do qual começar
a leitura.
example: 0
encoding:
type: string
description: Formato de codificação para dados da conta.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
responses:
'200':
description: Contas de token recuperadas com sucesso pelo delegado.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
result:
type: object
description: Contexto e detalhes da conta.
properties:
context:
type: object
description: Contexto da resposta.
properties:
slot:
type: integer
description: Slot no qual os dados foram obtidos.
example: 1114
value:
type: array
description: Lista de contas de token.
items:
type: object
properties:
pubkey:
type: string
description: >-
Chave pública da conta como uma string
codificada em base-58.
example: 28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp
account:
type: object
description: Detalhes da conta do token.
properties:
lamports:
type: integer
description: Número de lamports atribuídos à conta.
example: 1726080
owner:
type: string
description: >-
Chave pública do programa ao qual esta conta
foi atribuída.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
type: object
description: Dados de estado do token associados à conta.
properties:
program:
type: string
description: Nome do programa.
example: spl-token
parsed:
type: object
description: Dados de token analisados.
properties:
info:
type: object
description: Informações da conta do token.
properties:
tokenAmount:
type: object
description: Detalhes do montante de token.
properties:
amount:
type: string
description: Saldo bruto sem decimais.
example: '1'
decimals:
type: integer
description: Número de decimais.
example: 1
uiAmount:
type: number
description: >-
Saldo em formato amigável para o
usuário.
example: 0.1
uiAmountString:
type: string
description: Saldo como uma string.
example: '0.1'
delegate:
type: string
description: >-
O endereço Solana que recebeu
autorização para delegar a gestão ou
gasto de tokens.
example: >-
4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T
delegatedAmount:
type: object
description: >-
A quantidade de tokens que o delegado
foi autorizado a gastar em nome do
proprietário.
properties:
amount:
type: string
description: Saldo bruto sem decimais.
example: '1'
decimals:
type: integer
description: Número de decimais.
example: 1
uiAmount:
type: number
description: >-
Saldo em formato amigável para o
usuário.
example: 0.1
uiAmountString:
type: string
description: Saldo como uma string.
example: '0.1'
state:
type: string
description: Estado da conta do token.
example: initialized
isNative:
type: boolean
description: Indica se a conta possui SOL nativo.
example: false
mint:
type: string
description: Chave pública do mint do token.
example: >-
3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E
owner:
type: string
description: Chave pública do proprietário da conta.
example: >-
CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD
space:
type: integer
description: Espaço alocado para a conta.
example: 165
executable:
type: boolean
description: Indica se a conta contém um programa.
example: false
rentEpoch:
type: integer
description: Época na qual a conta deverá pagar aluguel.
example: 4
space:
type: integer
description: Tamanho dos dados da conta.
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: >-
Solicitação incorreta - Parâmetros da solicitação inválidos ou
solicitação malformada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Não autorizado - Chave de API inválida ou ausente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Muitas solicitações - Limite de taxa excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Erro interno do servidor - Ocorreu um erro no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Serviço indisponível - O serviço está temporariamente indisponível.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Tempo limite do gateway - A solicitação expirou.
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: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: O código de erro.
example: -32602
message:
type: string
description: A mensagem de erro.
data:
type: object
description: Dados adicionais sobre o erro.
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API do Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````