Skip to main content
A Wallet API está em Beta. Os endpoints e formatos de resposta podem mudar.

​
O que é a Wallet API?

A Wallet API fornece endpoints REST de alto nível para consultar dados completos de uma carteira Solana — saldos, histórico de transações, transferências de tokens, resolução de identidade, saldos históricos e fontes de financiamento. Em vez de fazer várias chamadas RPC e analisar dados brutos da blockchain, você obtém informações estruturadas e legíveis por humanos com preços em USD em uma única solicitação. Ela é criada para carteiras, rastreadores de portfólio, exploradores, processadores de pagamento, ferramentas fiscais e sistemas de conformidade e AML. Todos os endpoints compartilham a URL base https://api.helius.xyz e retornam quantias em unidades legíveis por humanos (não é necessária conversão de lamports).

​
Por que Helius para dados de carteira?

Uma chamada REST

Saldos estruturados, histórico e transferências sem juntar respostas RPC brutas.

Preço em USD embutido

Os saldos de tokens incluem valores em USD e totais de portfólio, originados do DAS.

Resolução de identidade

Mais de 32.500 contas e programas rotulados, além de mais de 21,5 milhões de tags categóricas para exchanges, protocolos e instituições.

Saída legível por humanos

Dados claros, ajustados em decimal em vez de lamports brutos e instruções.

​
Principais endpoints

Identidade da Carteira

Identifique carteiras conhecidas por endereço ou domínio SNS/ANS — exchanges, protocolos, instituições.

Saldos da Carteira

Todos os saldos de tokens e NFTs com valores em USD, logotipos e metadados.

Saldo Histórico

Um saldo de token ou SOL em um timestamp, data/hora ou slot passado.

Histórico da Carteira

Histórico completo de transações com alterações de saldo para cada transação.

Transferências de Token

Todas as transferências de entrada e saída com informações do remetente/destinatário.

Fonte de Financiamento

A fonte de financiamento original de uma carteira, rastreada até seu primeiro SOL recebido.

​
Qual endpoint devo usar?

Referência rápida das rotas subjacentes (URL base https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — obter identidade da carteira por endereço ou domínio SNS/ANS
  • POST /v1/wallet/batch-identity — consulta de identidade em lote (até 100 endereços e/ou domínios)
  • GET /v1/wallet/{wallet}/balances — obter todos os saldos de tokens e NFTs
  • GET /v1/wallet/{wallet}/balance-at — obter um saldo de token ou SOL em um timestamp, data/hora ou slot passado
  • GET /v1/wallet/{wallet}/history — obter histórico de transações com alterações de saldo
  • GET /v1/wallet/{wallet}/transfers — obter toda a atividade de transferência de tokens
  • GET /v1/wallet/{wallet}/funded-by — encontrar a fonte de financiamento original

​
Autenticação

Todas as solicitações para a Wallet API exigem uma chave de API. Você pode passá-la como um parâmetro de consulta ou como um cabeçalho:

​
Requisitos do plano

Os endpoints de identidade e fonte de financiamento exigem um plano pago. No plano Gratuito, solicitações para esses endpoints retornam 403 Forbidden. Todos os outros endpoints estão abertos em todos os planos, incluindo Gratuito. Qualquer nível pago desbloqueia os endpoints restritos — Developer, Business, e todos os níveis superiores (como Enterprise). Para habilitar consultas de identidade e fonte de financiamento, faça upgrade do seu plano no painel.

​
Quantias e unidades

A Wallet API é uma abstração de alto nível sobre dados brutos do Solana. Todos os campos amount nas respostas são legíveis por humanos — já divididos pelo decimals do token — para que você possa exibi-los diretamente sem qualquer conversão. Chamadas RPC brutas do Solana retornam valores em lamports (a menor unidade, 10⁻⁹ SOL); a Wallet API não. "amount": 1.5 significa 1.5 SOL, não 1.5 lamports. Onde a aritmética exata é necessária, alguns endpoints também expõem amountRaw: o mesmo valor como um inteiro bruto serializado como uma string para evitar perda de precisão de ponto flutuante. A fórmula de conversão é: amount = parseInt(amountRaw) / 10**decimals Use amount para exibição. Use amountRaw ao passar valores para instruções on-chain ou outros sistemas que exigem aritmética exata de inteiros.

​
Comece agora

1

Obtenha sua chave de API

Inscreva-se em dashboard.helius.dev para obter sua chave de API.
2

Escolha seu endpoint

Use a tabela acima para escolher o endpoint que corresponde ao seu caso de uso.
3

Faça sua primeira solicitação

Comece com uma consulta de saldo simples:
4

Trate a resposta

Analise a resposta JSON e exiba os dados em sua aplicação.

​
Próximos passos

Obtendo Dados

Explore todas as formas de consultar dados do Solana no Helius.

Referência de API

Esquemas de solicitação e resposta para todos os endpoints da Wallet API.

Contato com Suporte

Obtenha ajuda através do Discord, chat ou email.