> ## 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
> Retorna todas as contas de Token SPL pelo proprietário do token.
**Nova Funcionalidade**: `getTokenAccountsByOwner` agora suporta o parâmetro `changedSinceSlot` para atualizações incrementais. Quando especificado, o método retorna apenas contas de token que foram modificadas no ou após o número do slot dado. Isso é ideal para rastrear mudanças de saldo de tokens e atualizações de portfólio.
## Parâmetros da Solicitação
Endereço da carteira Solana (pubkey) do proprietário da conta para consultar as participações de token, como uma string codificada em base-58.
Endereço específico de mint do token Solana para recuperar apenas contas de um token ou NFT específico.
ID específico do programa de token Solana (tipicamente o programa SPL Token) que criou as contas de token.
O nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
* `processed`
O slot mínimo em que a solicitação pode ser avaliada.
Solicita uma fatia dos dados da conta.
Número de bytes a serem retornados.
Offset de byte a partir do qual começar a leitura.
Formato de codificação para dados da Conta.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Retorna apenas contas que foram modificadas no ou após este número de slot. Útil para atualizações incrementais.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API abrangente de descoberta de conta de token Solana para recuperar saldos
de tokens SPL, NFTs e outras participações de tokens associadas a qualquer
endereço de carteira na blockchain Solana.
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 Mainnet RPC
- url: https://devnet.helius-rpc.com
description: Ponto de extremidade Devnet RPC
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountsByOwner
description: >
Recupere todas as contas de token SPL de propriedade de um endereço de
carteira Solana específico com opções de filtragem poderosas.
Essa API essencial permite que os desenvolvedores descubram
participações completas em tokens, incluindo tokens fungíveis e NFTs,
com a capacidade de filtrar por tokens específicos ou limitar a contas
criadas por programas de token específicos.
Suporta dados analisados para informações de token legíveis por humanos,
incluindo saldos, decimais e status de propriedade.
Crítico para carteiras, rastreadores de portfólio e aplicativos DeFi que
precisam de dados abrangentes de participações de tokens.
operationId: getTokenAccountsByOwner
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:
- getTokenAccountsByOwner
description: O nome do método RPC a ser invocado.
example: getTokenAccountsByOwner
default: getTokenAccountsByOwner
params:
type: array
description: >-
Parâmetros para consultar contas de token de propriedade de
uma chave pública específica.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Endereço da carteira Solana (pubkey) do proprietário
da conta para consultar as participações em tokens,
como uma string codificada em base-58.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: >-
Configuração de filtro para restringir as contas de
token por endereço de mint ou ID de programa.
properties:
mint:
type: string
description: >-
Endereço específico de mint de token Solana para
recuperar apenas contas para um token ou NFT
específico.
example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
programId:
type: string
description: >-
ID de programa específico do token Solana
(normalmente programa SPL Token) que criou as
contas de token.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Objeto de configuração com campos opcionais.
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: Solicite um trecho 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 a
leitura deve começar.
example: 0
encoding:
type: string
description: Formato de codificação para os dados da conta.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
changedSinceSlot:
type: integer
description: >-
Retornar apenas contas que foram modificadas nesse
número de slot ou depois.
example: 464175999
responses:
'200':
description: Contas de token recuperadas com sucesso pelo proprietário.
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:
apiVersion:
type: string
description: Versão da API.
example: 2.0.15
slot:
type: integer
description: Slot em que os dados foram buscados.
example: 341197933
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: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: Detalhes da conta de token.
properties:
lamports:
type: integer
description: Número de lamports atribuídos à conta.
example: 2039280
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 de token.
properties:
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: >-
2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner:
type: string
description: Chave pública do proprietário da conta.
example: >-
A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state:
type: string
description: Estado da conta de token.
example: initialized
tokenAmount:
type: object
description: Detalhes do montante do token.
properties:
amount:
type: string
description: Saldo bruto sem decimais.
example: '420000000000000'
decimals:
type: integer
description: Número de decimais.
example: 6
uiAmount:
type: number
description: Saldo em formato amigável ao usuário.
example: 420000000
uiAmountString:
type: string
description: Saldo como uma string.
example: '420000000'
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 em que a conta deverá pagar aluguel.
example: 18446744073709552000
space:
type: integer
description: Tamanho dos dados da conta.
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: >-
Solicitação Incorreta - Parâmetros de solicitação inválidos ou
solicitação malformada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Parâmetros inválidos
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: Não autorizado
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: Muitas solicitações
id: '1'
'500':
description: Erro Interno do Servidor - Um erro ocorreu no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Erro interno
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: Serviço indisponível
id: '1'
'504':
description: Tempo Esgotado do Gateway - A solicitação demorou demais.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo de espera excedido
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 Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````