> ## 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.
# getCompressedTokenAccountsByOwner
> Retorna as contas de token comprimidas de propriedade de uma determinada conta.
## Parâmetros de Requisição
Cursor de paginação para recuperar conjuntos subsequentes de contas de token comprimidas em carteiras Solana com grandes participações
Número máximo de contas de token comprimidas para retornar por requisição (para paginação)
Filtrar contas de token comprimidas por endereço de mint de token Solana específico
Uma chave pública Solana representada como uma string base58 para endereços de conta e carteira.
## OpenAPI
````yaml pt-BR/openapi/zk-compression/getCompressedTokenAccountsByOwner.yaml POST /
openapi: 3.0.3
info:
title: API de Portfólio de Tokens Comprimidos Solana
description: >
Indexador avançado Solana para contas de tokens comprimidas usando
tecnologia de compressão de estado para armazenamento e recuperação de
tokens de maneira eficiente e econômica.
Esta API fornece acesso otimizado a tokens comprimidos e NFTs Solana,
permitindo até 1000x de economia de custos enquanto mantém
total segurança e compatibilidade com o ecossistema de tokens Solana. Ideal
para aplicativos de carteira, marketplaces e dApps baseados em tokens
que necessitam de gerenciamento de portfólio eficiente para ativos
comprimidos.
license:
name: Apache-2.0
version: 0.50.0
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
summary: getCompressedTokenAccountsByOwner
post:
description: >
Recupere todas as contas de tokens comprimidos pertencentes a um
endereço de carteira Solana específico.
Este endpoint de portfólio fornece dados completos de participações de
tokens SPL comprimidos e NFTs com
economias de custos significativas usando a tecnologia de compressão de
estado do Solana. Filtre resultados por endereço de mint,
paginar por grandes coleções de forma eficiente e acessar dados
detalhados da conta com verificação completa de propriedade.
Principais benefícios:
- Redução nos custos de armazenamento na cadeia para contas de token
(até 1000x de economia)
- Suporte para integrações de carteira em larga escala com paginação
eficiente
- Compatibilidade com o padrão de token SPL do Solana e NFTs comprimidos
- Filtragem específica de mint para consultas de tokens direcionadas
- Dados completos da conta de token, incluindo saldos, delegados e
estados
operationId: getCompressedTokenAccountsByOwner
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Um ID para identificar a solicitação.
default: '1'
method:
type: string
description: O nome do método a ser invocado.
enum:
- getCompressedTokenAccountsByOwner
default: getCompressedTokenAccountsByOwner
params:
type: object
required:
- owner
properties:
cursor:
allOf:
- $ref: '#/components/schemas/Base58String'
nullable: true
description: >-
Cursor de paginação para recuperar conjuntos
subsequentes de contas de tokens comprimidos em
carteiras Solana com grandes participações
limit:
allOf:
- $ref: '#/components/schemas/Limit'
nullable: true
description: >-
Número máximo de contas de tokens comprimidos para
retornar por solicitação (para paginação)
mint:
allOf:
- $ref: '#/components/schemas/SerializablePubkey'
nullable: true
description: >-
Filtrar contas de tokens comprimidos por endereço de
mint de token Solana específico
owner:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
O endereço da carteira Solana que possui as contas de
tokens comprimidos a serem recuperadas
additionalProperties: false
required: true
responses:
'200':
description: >-
Contas de tokens comprimidos recuperadas com sucesso do blockchain
Solana para o proprietário da carteira especificado
content:
application/json:
schema:
type: object
required:
- context
- value
properties:
context:
$ref: '#/components/schemas/Context'
value:
$ref: '#/components/schemas/TokenAccountList'
additionalProperties: false
'400':
description: >-
Solicitação inválida - 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 - Ocorreu um erro 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 limite do gateway - O tempo da solicitação expirou.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo limite do gateway
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
Base58String:
type: string
description: >-
Uma string codificada em base 58 usada para endereços e identificadores
Solana.
default: 3J98t1WpEZ73CNm
example: 3J98t1WpEZ73CNm
Limit:
type: integer
format: int64
minimum: 0
description: >-
Número máximo de contas de tokens comprimidos a serem retornadas em uma
única solicitação
SerializablePubkey:
type: string
description: >-
Uma chave pública Solana representada como uma string base58 para contas
e endereços de carteira.
default: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
example: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
Context:
type: object
required:
- slot
properties:
slot:
type: integer
default: 100
example: 100
description: Slot atual do blockchain Solana para esta resposta
TokenAccountList:
type: object
required:
- items
properties:
cursor:
$ref: '#/components/schemas/Base58String'
description: >-
Cursor de paginação para recuperar o próximo conjunto de contas de
tokens comprimidos em solicitações subsequentes
items:
type: array
items:
$ref: '#/components/schemas/TokenAcccount'
description: >-
Array de contas de tokens comprimidos pertencentes ao endereço de
carteira Solana especificado
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'
TokenAcccount:
type: object
required:
- account
- tokenData
properties:
account:
$ref: '#/components/schemas/Account'
description: >-
Informações de conta comprimidas para a conta de token no Solana,
incluindo posição na árvore e dados de verificação
tokenData:
$ref: '#/components/schemas/TokenData'
description: >-
Dados específicos relacionados ao token, incluindo saldo, mint,
proprietário e status de delegação
additionalProperties: false
Account:
type: object
required:
- hash
- owner
- lamports
- tree
- leafIndex
- seq
- slotCreated
properties:
address:
$ref: '#/components/schemas/SerializablePubkey'
description: O endereço único da conta comprimida no Solana
data:
$ref: '#/components/schemas/AccountData'
description: Dados da conta armazenados em um formato comprimido no Solana
hash:
$ref: '#/components/schemas/Hash'
description: Hash criptográfico dos dados da conta comprimida para verificação
lamports:
$ref: '#/components/schemas/UnsignedInteger'
description: Saldo em lamports associado à conta comprimida
leafIndex:
$ref: '#/components/schemas/UnsignedInteger'
description: >-
Posição do índice na árvore Merkle onde a conta comprimida está
armazenada
owner:
$ref: '#/components/schemas/SerializablePubkey'
description: Programa Solana que possui esta conta comprimida
seq:
$ref: '#/components/schemas/UnsignedInteger'
description: Número de sequência para rastrear atualizações na conta comprimida
slotCreated:
$ref: '#/components/schemas/UnsignedInteger'
description: Slot do blockchain Solana quando a conta comprimida foi criada
tree:
$ref: '#/components/schemas/SerializablePubkey'
description: Endereço da árvore Merkle contendo esta conta comprimida
additionalProperties: false
TokenData:
type: object
required:
- mint
- owner
- amount
- state
properties:
amount:
$ref: '#/components/schemas/UnsignedInteger'
description: Quantidade de saldo de token mantida nesta conta de token comprimida
delegate:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
Endereço de delegado opcional autorizado a realizar operações nesta
conta de token comprimida
mint:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
O endereço de mint do token SPL Solana ao qual esta conta de token
comprimida pertence
owner:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
O endereço da carteira Solana que possui esta conta de token
comprimida
state:
$ref: '#/components/schemas/AccountState'
description: >-
Estado atual da conta de token comprimida (inicializado ou
congelado)
tlv:
$ref: '#/components/schemas/Base64String'
description: >-
Dados opcionais codificados em tipo-comprimento-valor para
informações estendidas da conta de token
AccountData:
type: object
required:
- discriminator
- data
- dataHash
properties:
data:
$ref: '#/components/schemas/Base64String'
description: Dados codificados em Base64 da conta Solana comprimida
dataHash:
$ref: '#/components/schemas/Hash'
description: Hash dos dados da conta comprimida para verificação de integridade
discriminator:
$ref: '#/components/schemas/UnsignedInteger'
description: Identificador para o tipo de conta no programa Solana
additionalProperties: false
Hash:
type: string
description: >-
Um hash criptográfico de 32 bytes representado como uma string base58
para verificação de dados Solana.
example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
UnsignedInteger:
type: integer
default: 100
example: 100
description: >-
Valor inteiro não negativo usado para quantidades de tokens, números de
sequência e outros valores numéricos
AccountState:
type: string
enum:
- initialized
- frozen
description: Estado atual da conta de token comprimido (inicializado ou congelado)
Base64String:
type: string
description: >-
Uma string codificada em base 64 para armazenamento de dados binários em
contas Solana comprimidas.
default: SGVsbG8sIFdvcmxkIQ==
example: SGVsbG8sIFdvcmxkIQ==
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API Helius. Você pode obter uma gratuitamente no
[painel](https://dashboard.helius.dev/api-keys).
````