Dados de carteiras Solana sem complicação
Uma única API REST para consultar saldos, histórico, identidade e fontes de financiamento de carteiras Solana. Não é preciso memorizar métodos JSON-RPC da Solana nem fazer cálculos com lamports.
Saiba a quem pertence uma carteira
Associe um endereço ou nome de domínio da Solana a uma identidade. Compatível com mais de 32.500 rótulos e 21,5 milhões de tags.
- Consulta individual ou em lote de até 100 endereços
- TLDs personalizados de SNS e ANS são resolvidos na mainnet
- Compatível com rótulos para endereços de corretoras, carteiras de protocolos, instituições e endereços sinalizados
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
- Consulta individual ou em lote de até 100 endereços
- TLDs personalizados de SNS e ANS são resolvidos na mainnet
- Compatível com rótulos para endereços de corretoras, carteiras de protocolos, instituições e endereços sinalizados
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
Descubra quem financiou uma carteira
A fonte original de financiamento de uma carteira: quem enviou o primeiro SOL, quanto e quando. O nome e o tipo do financiador vêm do mesmo sistema de identidade.
- Endereço do financiador direto, valor, slot e assinatura
- Corretora, protocolo ou desconhecido, com rótulo quando identificado
- Armazene em cache para sempre. O primeiro financiador de uma carteira nunca muda
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
- Endereço do financiador direto, valor, slot e assinatura
- Corretora, protocolo ou desconhecido, com rótulo quando identificado
- Armazene em cache para sempre. O primeiro financiador de uma carteira nunca muda
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
Atividade da carteira totalmente processada
Histórico de transações com alterações de saldo por transação em linguagem fácil de entender.
- Mais recentes primeiro, até 100 transações por página
tokenAccounts=balanceChangedpara receber apenas atualizaçõesamountjá vem ajustado para casas decimais, sem cálculos com lamports
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
- Mais recentes primeiro, até 100 transações por página
tokenAccounts=balanceChangedpara receber apenas atualizaçõesamountjá vem ajustado para casas decimais, sem cálculos com lamports
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
Entregue a carteira e a camada de dados juntas
Adicione carteiras incorporadas sem custódia ao seu aplicativo, com suporte a login por passkeys, e-mail e carteiras existentes via helius-wallet-kit
Casos de uso da Wallet API
Painéis de carteiras
Saldos, valores em USD e metadados em uma única chamada REST. Sem combinar dados do DAS nem fazer cálculos com lamports
Rastreadores de portfólio
Use o histórico e o balance-at para reconstruir posições e calcular lucros e perdas ao longo do tempo
Processadores de pagamentos
Registre transações e transferências com contraparte, valor, mint e direção
Tributação e contabilidade
Obtenha um histórico fácil de entender com posições e alterações de saldo por transação
Compliance e prevenção à lavagem de dinheiro
Consulte corretoras e carteiras de tesouraria conhecidas e veja como as carteiras foram financiadas
Exploradores e análises
Obtenha tags de mais de 21 milhões de carteiras para adicionar rótulos de contas ao seu aplicativo
Uma API REST para todos os dados de carteiras Solana
1. Obtenha uma chave de API
Cadastre-se, obtenha sua chave de API da Helius e passe api-key na string de consulta ou como cabeçalho X-Api-Key
2. Acesse uma rota REST
GET /v1/wallet/{wallet}/balances, identity, history ou qualquer outro endpoint da Wallet API
3. Integre ao seu aplicativo
Os valores vêm ajustados para casas decimais, as identidades são rotuladas e os dados são formatados corretamente. Nenhuma etapa adicional é necessária
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");1. Obtenha uma chave de API
Cadastre-se, obtenha sua chave de API da Helius e passe api-key na string de consulta ou como cabeçalho X-Api-Key
2. Acesse uma rota REST
GET /v1/wallet/{wallet}/balances, identity, history ou qualquer outro endpoint da Wallet API
3. Integre ao seu aplicativo
Os valores vêm ajustados para casas decimais, as identidades são rotuladas e os dados são formatados corretamente. Nenhuma etapa adicional é necessária
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");Perguntas frequentes
Encontre respostas para perguntas frequentes. Precisa de ajuda ou de um plano personalizado? Fale com nossa equipe.
Saldos, saldo histórico (balance-at), histórico e transferências estão disponíveis em todos os planos, incluindo o Free. Identity (individual e em lote) e funded-by exigem qualquer plano pago (Developer ou superior) e retornam 403 no Free.
Cada solicitação à Wallet API custa 100 créditos, incluindo consultas de identidade em lote (até 100 endereços em uma única chamada). Consulte a tabela completa de créditos.
Use balances para o portfólio atual, balance-at para consultar uma posição em um slot ou timestamp anterior, history para obter um feed completo de atividades com alterações de saldo por transação e transfers quando você precisar apenas dos pagamentos enviados ou recebidos com uma contraparte. Use identity para identificar uma corretora, um protocolo ou uma instituição conhecida e funded-by para encontrar a carteira que enviou o primeiro SOL.
A Wallet API é a rota de leitura: obtenha saldos, histórico, identidade e informações de funded-by da carteira via REST. WaaS oferece carteiras incorporadas: crie e assine transações usando helius-wallet-kit.
O WaaS está em beta e disponível em todos os planos pagos (Developer, Business, Professional e Enterprise). Ele não está disponível no Free.
Não há assinatura separada nem tarifa por usuário. Cada assinatura custa 200 créditos (US$ 0,001 pela tarifa padrão de créditos). A criação de carteiras é gratuita. signMessage, signTransaction e signAndSendTransaction contam como uma assinatura cada. A assinatura é cobrada mesmo que a transação falhe posteriormente on-chain. Um prompt cancelado é gratuito. Acompanhe o uso no painel em WaaS → Analytics. Consulte os créditos do WaaS.
Faça upgrade para um plano pago, crie uma chave de API e instale helius-wallet-kit. Envolva seu aplicativo com HeliusWalletProvider e siga o guia de início rápido do WaaS.
Dados de carteiras sem complexidade
Deixe de lado os métodos JSON-RPC brutos da Solana e comece a consultar dados on-chain de carteiras em minutos