获取数据快速入门

快速设置

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

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

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

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

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 }
    ]
  }'

getTransactionsForAddress 指南

过滤器、分页、响应格式和最佳实践。

索引指南

构建、回填并保持 Solana 索引的更新。

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

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

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"]
  }'

getTransfersByAddress 指南

转账类型、过滤器、对账和响应格式。

getTransfersByAddress 参考

完整参数和响应架构。

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

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

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
      }
    }
  }'

DAS API 概述

所有资产方法、特殊资产类型和最佳实践。

getAssetsByOwner 参考

完整参数和响应架构。

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

Wallet API 是一个高级 REST API。余额端点返回钱包的代币和 NFT 持有量及其美元价值 —— 无需 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"

钱包 API 概述

所有钱包端点、认证和单位。

钱包余额参考

查询参数和完整响应架构。

下一步

获取数据概述

比较每个数据 API 并选择适合您的用例的那个。

API 参考

完整的方法和端点文档。

需要帮助？ 加入我们的 Discord 或查看支持文档。

入门指南

数据流与事件监听

数据 API 与 RPC

交易

发送交易

Wallet-as-a-Service

指南

资源

获取数据快速入门

快速设置

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

getTransactionsForAddress 指南

索引指南

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

getTransfersByAddress 指南

getTransfersByAddress 参考

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

DAS API 概述

getAssetsByOwner 参考

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

钱包 API 概述

钱包余额参考

下一步

获取数据概述

API 参考

​快速设置

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

getTransactionsForAddress 指南

索引指南

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

getTransfersByAddress 指南

getTransfersByAddress 参考

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

DAS API 概述

getAssetsByOwner 参考

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

钱包 API 概述

钱包余额参考

​下一步

获取数据概述

API 参考

快速设置

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

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

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

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

下一步