Introdução Rápida à Obtenção de Dados

Configuração rápida

Cada exemplo abaixo precisa apenas da sua chave de API Helius do dashboard.helius.dev. Substitua YOUR_API_KEY, então escolha o caminho que corresponde ao que você está buscando:

Você quer	Use isto	Retorna
Histórico completo de transações de um endereço	getTransactionsForAddress	Transações decodificadas para um endereço
Histórico completo de transferências de um endereço	getTransfersByAddress	Transferências de tokens e SOL nativo para um endereço
Tokens, NFTs e ativos possuídos por uma carteira	API DAS — `getAssetsByOwner`	Ativos com metadados, propriedade e saldos
Saldos de carteira com valores em USD via REST	API Wallet — `/balances`	Saldos de tokens e NFT com precificação em USD

Opção 1: Preencher histórico de transações (getTransactionsForAddress)

getTransactionsForAddress retorna o histórico completo de transações decodificadas para um endereço em um único método — a maneira mais rápida de preencher dados para indexação. Passe o endereço primeiro, depois um objeto de opções com filtros opcionais.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransactionsForAddress',
    params: [
      '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      {
        transactionDetails: 'full',
        sortOrder: 'desc',
        limit: 100,
      },
    ],
  }),
});

const { result } = await response.json();
console.log(`Fetched ${result.data.length} transactions`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactionsForAddress",
    "params": [
        "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        {"transactionDetails": "full", "sortOrder": "desc", "limit": 100},
    ],
}
result = requests.post(url, json=payload).json()["result"]
print(f"Fetched {len(result['data'])} transactions")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactionsForAddress",
    "params": [
      "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      { "transactionDetails": "full", "sortOrder": "desc", "limit": 100 }
    ]
  }'

Guia de getTransactionsForAddress

Filtros, paginação, formato de resposta e melhores práticas.

Guia de Indexação

Construir, preencher e manter um índice Solana atualizado.

Opção 2: Obter histórico de transferências (getTransfersByAddress)

getTransfersByAddress retorna o histórico de transferências de tokens e SOL nativo para um endereço — no nível de transferência em vez de nível de transação, pronto para reconciliação. Passe o endereço; adicione um objeto de opções para filtros.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransfersByAddress',
    params: ['86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY'],
  }),
});

const { result } = await response.json();
console.log(`Fetched ${result.data.length} transfers`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransfersByAddress",
    "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"],
}
result = requests.post(url, json=payload).json()["result"]
print(f"Fetched {len(result['data'])} transfers")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransfersByAddress",
    "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"]
  }'

Guia de getTransfersByAddress

Tipos de transferência, filtros, reconciliação e formato de resposta.

Referência de getTransfersByAddress

Parâmetros completos e esquema de resposta.

Opção 3: Obter ativos de uma carteira (API DAS)

A API DAS retorna os NFTs, tokens fungíveis e ativos comprimidos que uma carteira possui em uma única chamada — o ponto de partida mais comum para carteiras, visualizações de portfólio e análises.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAssetsByOwner',
    params: {
      ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      page: 1,
      limit: 1000,
      options: {
        showFungible: true,
        showNativeBalance: true,
      },
    },
  }),
});

const { result } = await response.json();
console.log(`Found ${result.total} assets`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getAssetsByOwner",
    "params": {
        "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        "page": 1,
        "limit": 1000,
        "options": {
            "showFungible": True,
            "showNativeBalance": True,
        },
    },
}
result = requests.post(url, json=payload).json()["result"]
print(f"Found {result['total']} assets")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getAssetsByOwner",
    "params": {
      "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      "page": 1,
      "limit": 1000,
      "options": {
        "showFungible": true,
        "showNativeBalance": true
      }
    }
  }'

Visão geral da API DAS

Todos os métodos de ativos, tipos de ativos especiais e melhores práticas.

Referência de getAssetsByOwner

Parâmetros completos e esquema de resposta.

Opção 4: Obter saldos da carteira via REST (API Wallet)

A API Wallet é uma API REST de alto nível. O endpoint de saldos retorna as posses de tokens e NFT de uma carteira com valores em USD — sem necessidade de envelope JSON-RPC.

const address = '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY';
const response = await fetch(
  `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`,
);

const data = await response.json();
console.log(`Current page value: $${data.totalUsdValue}`);

import requests

address = "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
url = f"https://api.helius.xyz/v1/wallet/{address}/balances"
data = requests.get(url, headers={"X-Api-Key": "YOUR_API_KEY"}).json()
print(f"Current page value: ${data['totalUsdValue']}")

curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"

Visão geral da API Wallet

Todos os endpoints da carteira, autenticação e unidades.

Referência de Saldos da Carteira

Parâmetros de consulta e esquema completo de resposta.

Próximos passos

Visão geral da Obtenção de Dados

Compare todas as APIs de dados e escolha a certa para seu caso de uso.

Referência de API

Documentação completa de métodos e endpoints.

Precisa de ajuda? Junte-se ao nosso Discord ou veja os documentos de suporte.

Primeiros Passos

Transmissão de Dados & Escuta de Eventos

APIs de Dados & RPCs

Negociação

Envio de Transações

Carteira como Serviço

Guias

Recursos

Introdução Rápida à Obtenção de Dados

Configuração rápida

Opção 1: Preencher histórico de transações (getTransactionsForAddress)

Guia de getTransactionsForAddress

Guia de Indexação

Opção 2: Obter histórico de transferências (getTransfersByAddress)

Guia de getTransfersByAddress

Referência de getTransfersByAddress

Opção 3: Obter ativos de uma carteira (API DAS)

Visão geral da API DAS

Referência de getAssetsByOwner

Opção 4: Obter saldos da carteira via REST (API Wallet)

Visão geral da API Wallet

Referência de Saldos da Carteira

Próximos passos

Visão geral da Obtenção de Dados

Referência de API

​Configuração rápida

​Opção 1: Preencher histórico de transações (getTransactionsForAddress)

Guia de getTransactionsForAddress

Guia de Indexação

​Opção 2: Obter histórico de transferências (getTransfersByAddress)

Guia de getTransfersByAddress

Referência de getTransfersByAddress

​Opção 3: Obter ativos de uma carteira (API DAS)

Visão geral da API DAS

Referência de getAssetsByOwner

​Opção 4: Obter saldos da carteira via REST (API Wallet)

Visão geral da API Wallet

Referência de Saldos da Carteira

​Próximos passos

Visão geral da Obtenção de Dados

Referência de API

Configuração rápida

Opção 1: Preencher histórico de transações (getTransactionsForAddress)

Opção 2: Obter histórico de transferências (getTransfersByAddress)

Opção 3: Obter ativos de uma carteira (API DAS)

Opção 4: Obter saldos da carteira via REST (API Wallet)

Próximos passos