NOVO: Solana Privacy Rings já está disponível na mainnet
Wallet API (Beta)

Dados de carteiras Solana sem complicação

Uma única API REST para consultar saldos, histórico, identidade e fontes de financiamento de carteiras Solana. Sem precisar memorizar métodos JSON-RPC da Solana nem fazer cálculos com lamports.

Imagem principal
IDENTIDADE

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.

GET /v1/wallet/{wallet}/identity
          
{ "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
FINANCIADA POR

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.

GET /v1/wallet/{wallet}/funded-by
          
{ "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
HISTÓRICO

Atividade da carteira totalmente interpretada

Histórico de transações com alterações de saldo por transação em linguagem fácil de entender.

GET /v1/wallet/{wallet}/history
          
{ "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" } }
  • Das mais recentes para as mais antigas, com até 100 transações por página
  • tokenAccounts=balanceChanged somente para atualizações
  • amount já vem ajustado às casas decimais, sem cálculos com lamports
CARTEIRAS COMO SERVIÇO DA HELIUS

Entregue a carteira e a camada de dados juntas

Adicione carteiras integradas e sem custódia ao seu app, com opções de 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 legível com saldos e alterações por transação

Conformidade e AML

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 app

COMO FUNCIONA

Uma API REST para todos os dados de carteiras Solana

getWalletBalances
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 envie a api-key na string de consulta ou como cabeçalho X-Api-Key

2. Acesse um único caminho REST

GET /v1/wallet/{wallet}/balances, identidade, histórico ou qualquer outro endpoint da Wallet API

3. Integre ao seu app

Os valores vêm ajustados às casas decimais, as identidades vêm rotuladas e os dados são formatados corretamente. Nenhuma etapa adicional é necessária

Perguntas frequentes

Encontre respostas para perguntas frequentes. Precisa de ajuda ou de um plano personalizado? Fale com nossa equipe.

sinta a diferença

Dados de carteiras sem complexidade

Deixe de lado os métodos JSON-RPC brutos da Solana e comece a consultar dados onchain de carteiras em minutos