> ## 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.

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

> Faça sua primeira consulta de dados Solana em minutos. Exemplos para copiar e colar de getTransactionsForAddress, getTransfersByAddress, a API DAS e a API Wallet.

## Configuração rápida

Cada exemplo abaixo precisa apenas da sua chave de API Helius do [dashboard.helius.dev](https://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.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  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`);
  ```

  ```python Python theme={"system"}
  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")
  ```

  ```bash cURL theme={"system"}
  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 }
      ]
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Guia de getTransactionsForAddress" icon="clock-rotate-left" href="/docs/pt-BR/rpc/gettransactionsforaddress">
    Filtros, paginação, formato de resposta e melhores práticas.
  </Card>

  <Card title="Guia de Indexação" icon="layer-group" href="/docs/pt-BR/rpc/how-to-index-solana-data">
    Construir, preencher e manter um índice Solana atualizado.
  </Card>
</CardGroup>

## 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.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  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`);
  ```

  ```python Python theme={"system"}
  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")
  ```

  ```bash cURL theme={"system"}
  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"]
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Guia de getTransfersByAddress" icon="arrow-right-arrow-left" href="/docs/pt-BR/rpc/gettransfersbyaddress">
    Tipos de transferência, filtros, reconciliação e formato de resposta.
  </Card>

  <Card title="Referência de getTransfersByAddress" icon="code" href="/docs/pt-BR/api-reference/rpc/http/gettransfersbyaddress">
    Parâmetros completos e esquema de resposta.
  </Card>
</CardGroup>

## 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.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  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`);
  ```

  ```python Python theme={"system"}
  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")
  ```

  ```bash cURL theme={"system"}
  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
        }
      }
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Visão geral da API DAS" icon="gem" href="/docs/pt-BR/das-api">
    Todos os métodos de ativos, tipos de ativos especiais e melhores práticas.
  </Card>

  <Card title="Referência de getAssetsByOwner" icon="code" href="/docs/pt-BR/api-reference/das/getassetsbyowner">
    Parâmetros completos e esquema de resposta.
  </Card>
</CardGroup>

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

A [API Wallet](/docs/pt-BR/wallet-api/overview) é 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.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  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}`);
  ```

  ```python Python theme={"system"}
  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']}")
  ```

  ```bash cURL theme={"system"}
  curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Visão geral da API Wallet" icon="wallet" href="/docs/pt-BR/wallet-api/overview">
    Todos os endpoints da carteira, autenticação e unidades.
  </Card>

  <Card title="Referência de Saldos da Carteira" icon="code" href="/docs/pt-BR/api-reference/wallet-api/balances">
    Parâmetros de consulta e esquema completo de resposta.
  </Card>
</CardGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Visão geral da Obtenção de Dados" icon="database" href="/docs/pt-BR/getting-data">
    Compare todas as APIs de dados e escolha a certa para seu caso de uso.
  </Card>

  <Card title="Referência de API" icon="code" href="/docs/pt-BR/api-reference">
    Documentação completa de métodos e endpoints.
  </Card>
</CardGroup>

**Precisa de ajuda?** Junte-se ao nosso [Discord](https://discord.com/invite/6GXdee3gBj) ou veja os [documentos de suporte](/docs/pt-BR/support).