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

# 获取数据快速入门

> 几分钟内进行您的第一个 Solana 数据查询。复制粘贴示例代码，用于 getTransactionsForAddress、getTransfersByAddress、DAS API 和 Wallet API。

## 快速设置

每个下面的示例只需要您从 [dashboard.helius.dev](https://dashboard.helius.dev) 获取的 Helius API 密钥。替换 `YOUR_API_KEY`，然后选择与您要获取的数据匹配的路径：

| 您想要                   | 使用此项                             | 返回                |
| --------------------- | -------------------------------- | ----------------- |
| 地址的完整交易历史             | **getTransactionsForAddress**    | 一个地址的解码交易         |
| 地址的完整转账历史             | **getTransfersByAddress**        | 一个地址的代币和本机 SOL 转账 |
| 钱包拥有的代币、NFT 和资产       | **DAS API** — `getAssetsByOwner` | 具有元数据、所有权和余额的资产   |
| 通过 REST 获取的以美元计价的钱包余额 | **Wallet API** — `/balances`     | 具有美元定价的代币和 NFT 余额 |

## 选项 1：回填交易历史（getTransactionsForAddress）

`getTransactionsForAddress` 返回一个地址的完整解码交易历史，使用单一方法——这是为索引回填数据的最快方式。先传递地址，然后传递一个带有可选过滤器的选项对象。

<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="getTransactionsForAddress 指南" icon="clock-rotate-left" href="/zh/rpc/gettransactionsforaddress">
    过滤器、分页、响应格式和最佳实践。
  </Card>

  <Card title="索引指南" icon="layer-group" href="/zh/rpc/how-to-index-solana-data">
    构建、回填并保持 Solana 索引的更新。
  </Card>
</CardGroup>

## 选项 2：获取转账历史（getTransfersByAddress）

`getTransfersByAddress` 返回一个地址的解析代币和本机 SOL 转账历史——是在转账级别而不是交易级别，准备进行对账。传递地址；添加过滤器的选项对象。

<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="getTransfersByAddress 指南" icon="arrow-right-arrow-left" href="/zh/rpc/gettransfersbyaddress">
    转账类型、过滤器、对账和响应格式。
  </Card>

  <Card title="getTransfersByAddress 参考" icon="code" href="/zh/api-reference/rpc/http/gettransfersbyaddress">
    完整参数和响应架构。
  </Card>
</CardGroup>

## 选项 3：获取钱包资产（DAS API）

DAS API 返回钱包在单次调用中拥有的 NFT、同质化代币和压缩资产 —— 是钱包、投资组合视图和分析的最常见起点。

<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="DAS API 概述" icon="gem" href="/zh/das-api">
    所有资产方法、特殊资产类型和最佳实践。
  </Card>

  <Card title="getAssetsByOwner 参考" icon="code" href="/zh/api-reference/das/getassetsbyowner">
    完整参数和响应架构。
  </Card>
</CardGroup>

## 选项 4：通过 REST 获取钱包余额（钱包 API）

[Wallet API](/zh/wallet-api/overview) 是一个高级 REST API。余额端点返回钱包的代币和 NFT 持有量及其美元价值 —— 无需 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="钱包 API 概述" icon="wallet" href="/zh/wallet-api/overview">
    所有钱包端点、认证和单位。
  </Card>

  <Card title="钱包余额参考" icon="code" href="/zh/api-reference/wallet-api/balances">
    查询参数和完整响应架构。
  </Card>
</CardGroup>

## 下一步

<CardGroup cols={2}>
  <Card title="获取数据概述" icon="database" href="/zh/getting-data">
    比较每个数据 API 并选择适合您的用例的那个。
  </Card>

  <Card title="API 参考" icon="code" href="/zh/api-reference">
    完整的方法和端点文档。
  </Card>
</CardGroup>

**需要帮助？** 加入我们的 [Discord](https://discord.com/invite/6GXdee3gBj) 或查看 [支持文档](/zh/support)。