Skip to main content
Helius 独家功能 - getTransactionsForAddress 仅通过 Helius RPC 节点提供，并不是标准 Solana RPC 的一部分。此端点需要 开发者计划 或更高级别，并且每次请求消耗 100 积分。返回 100 个完整交易或 1,000 个签名。

​
概述

getTransactionsForAddress 提供强大的交易历史查询功能，具有高级过滤、灵活排序和高效分页。

​
主要功能

灵活排序

按时间顺序排序（最早优先）或反向排序（最新优先）

高级过滤

按时间范围、槽位、签名和交易状态进行过滤

完整交易数据

一次调用获取完整的交易详情

简单分页

使用 slot:position 令牌轻松分页

​
常见用例

此方法在多个场景中特别有用。代币发行分析有助于跟踪新项目的首次铸币交易和早期代币持有者。钱包资金历史允许您识别特定地址的资金来源和交易模式。交易分析让您可以按成功/失败状态进行过滤，专注于已完成的交易并排除失败的尝试。 该 API 还支持 审计与合规 工作流，通过状态过滤为特定时间段生成交易报告。分析仪表板可以利用历史重播功能构建全面的交易分析。最后，投资组合跟踪应用程序可以访问完整的成功交易历史，用于 DeFi 投资组合管理。

​
快速开始

1

获取您的 API 密钥

从 Helius Dashboard 获取您的 API 密钥。
2

使用高级功能查询

获取在两个日期之间按时间顺序排序的钱包的所有成功交易：
// Get successful transactions between Jan 1-31, 2025 in chronological order
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: [
      'YOUR_ADDRESS_HERE',
      {
        transactionDetails: 'full',
        sortOrder: 'asc',
        limit: 100,
        filters: {
          blockTime: {
            gte: 1735689600,   // Jan 1, 2025
            lte: 1738368000    // Jan 31, 2025
          },
          status: 'succeeded'  // Only successful transactions
        }
      }
    ]
  })
});

const data = await response.json();
console.log('Successful transactions in January:', data.result.data);
3

了解参数

此示例展示了关键特性：
  • transactionDetails: 设置为'full'以在一次调用中获取完整的交易数据
  • sortOrder: 使用'asc'按时间顺序（最早的优先）或'desc'按最新的优先
  • filters.blockTime: 使用gte（大于或等于）和lte（小于或等于）设置时间范围
  • filters.status: 仅过滤'succeeded'或'failed'交易

​
请求参数

​
address
string
required
要查询交易历史的账户的Base-58编码公钥
​
transactionDetails
string
default:"signatures"
返回的交易详细级别：
  • signatures: 基本签名信息（更快）
  • full: 完整的交易数据（消除对getTransaction调用的需求，要求限制≤100）
​
sortOrder
string
default:"desc"
结果的排序顺序：
  • desc: 最新的优先（默认）
  • asc: 最早的优先（按时间顺序，适合历史分析）
​
limit
number
default:"1000"
返回的最大交易数：
  • 当transactionDetails: "signatures"时最多1000
  • 当transactionDetails: "full"时最多100
​
paginationToken
string
上一个响应的分页令牌（格式："slot:position"）
​
commitment
string
default:"finalized"
承诺级别：finalized, confirmed, 或 processed
​
filters
object
用于缩小结果范围的高级过滤选项。
​
filters.slot
object
使用比较运算符按槽号过滤：gte, gt, lte, lt示例：{ "slot": { "gte": 1000, "lte": 2000 } }
​
filters.blockTime
object
使用比较运算符按Unix时间戳过滤：gte, gt, lte, lt, eq示例：{ "blockTime": { "gte": 1640995200, "lte": 1641081600 } }
​
filters.signature
object
使用比较运算符按交易签名过滤：gte, gt, lte, lt示例：{ "signature": { "lt": "SIGNATURE_STRING" } }
​
filters.status
string
按交易成功/失败状态过滤：
  • succeeded: 仅成功的交易
  • failed: 仅失败的交易
  • any: 成功和失败的交易（默认）
示例：{ "status": "succeeded" }
​
encoding
string
交易数据的编码格式（仅在transactionDetails: "full"时适用）。与getTransaction API 相同。选项：json, jsonParsed, base64, base58
​
maxSupportedTransactionVersion
number
设置返回的最大交易版本。如果省略，则仅返回旧版交易。设置为0以包含所有版本的交易。
​
minContextSlot
number
请求可以评估的最小槽位

​
过滤器操作符

使用过滤器时，可以对slot, blockTime或signature使用比较操作符，以及一个特殊的status过滤器。这些操作符的工作方式类似于数据库查询，能够精确控制数据范围。

​
比较操作符

操作符全名描述示例
gte大于或等于包含值 ≥ 指定值slot: { gte: 100 }
gt大于包含值 > 指定值blockTime: { gt: 1641081600 }
lte小于或等于包含值 ≤ 指定值slot: { lte: 2000 }
lt小于包含值 < 指定值blockTime: { lt: 1641168000 }
eq等于包含值完全等于（仅blockTime）blockTime: { eq: 1641081600 }

​
状态过滤器

过滤器描述值
status按成功/失败过滤交易succeeded, failed, 或 any
组合过滤器示例： 
// Time range with successful transactions only
"filters": {
  "blockTime": {
    "gte": 1640995200,
    "lte": 1641081600
  },
  "status": "succeeded"
}

// Slot range
"filters": {
  "slot": {
    "gte": 1000,
    "lte": 2000
  }
}

// Only failed transactions
"filters": {
  "status": "failed"
}

​
响应格式

  • 签名响应
  • 完整交易响应
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1054,
        "err": null,
        "memo": null,
        "blockTime": 1641038400,
        "confirmationStatus": "finalized"
      }
    ],
    "paginationToken": "1055:5"
  }
}

​
实用示例

​
基于时间的分析

生成每月交易报告： 
// Get all successful transactions for January 2025
const startTime = Math.floor(new Date('2025-01-01').getTime() / 1000);
const endTime = Math.floor(new Date('2025-02-01').getTime() / 1000);

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransactionsForAddress",
  "params": [
    "WALLET_OR_PROGRAM_ADDRESS",
    {
      "transactionDetails": "signatures",
      "filters": {
        "blockTime": {
          "gte": startTime,
          "lt": endTime
        },
        "status": "succeeded"
      },
      "limit": 1000
    }
  ]
}
分析过程： 
// Calculate daily transaction volume
const dailyStats = {};
response.result.data.forEach(tx => {
  const date = new Date(tx.blockTime * 1000).toISOString().split('T')[0];
  dailyStats[date] = (dailyStats[date] || 0) + 1;
});

console.log('Daily Transaction Counts:', dailyStats);

​
代币铸造创建

查找特定代币的铸造创建交易： 
{
  "jsonrpc": "2.0",
  "id": "find-first-mints",
  "method": "getTransactionsForAddress",
  "params": [
    MINT_ADDRESS, // Token mint address
    {
      "encoding": "jsonParsed",
      "maxSupportedTransactionVersion": 0,
      "sortOrder": "asc",  // Chronological order from the beginning
      "limit": 10,
      "transactionDetails": "full"
    }
  ]
}
对于流动性池创建，查询池地址： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransactionsForAddress", 
  "params": [
    "POOL_ADDRESS_HERE", // Raydium/Meteora pool address
    {
      "transactionDetails": "full",
      "sortOrder": "asc",  // First transaction is usually pool creation
      "limit": 1
    }
  ]
}
用例：查找代币铸造或流动性池创建的确切时刻，包括创建者地址和初始参数。

​
资金交易

查找谁为特定地址提供资金： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransactionsForAddress",
  "params": [
    "TARGET_WALLET_ADDRESS",
    {
      "transactionDetails": "full",
      "sortOrder": "asc",  // Oldest first
      "limit": 10
    }
  ]
}
然后分析交易数据以查找SOL转账： 
response.result.data.forEach(tx => {
  // Look for SOL transfers in preBalances/postBalances
  const balanceChanges = tx.meta.preBalances.map((pre, index) => 
    tx.meta.postBalances[index] - pre
  );
  
  // Positive balance change = incoming SOL
  balanceChanges.forEach((change, index) => {
    if (change > 0) {
      console.log(`Received ${change} lamports from ${tx.transaction.message.accountKeys[index]}`);
    }
  });
});
最初的几笔交易通常会揭示资金来源，并有助于识别相关地址或资金模式。

​
分页

当交易数量超过限制时，使用响应中的paginationToken获取下一页。该令牌是一个简单的字符串，格式为"slot:position"，指示API从何处继续。

​
如何分页

使用每个响应中的分页令牌获取下一页： 
// First request
let paginationToken = null;
let allTransactions = [];

const getNextPage = async (paginationToken = null) => {
  const params = [
    'ADDRESS',
    {
      transactionDetails: 'signatures',
      limit: 100,
      ...(paginationToken && { paginationToken })
    }
  ];

  const response = await fetch(rpcUrl, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'getTransactionsForAddress',
      params
    })
  });

  const data = await response.json();
  return data.result;
};

// Paginate through all results
do {
  const result = await getNextPage(paginationToken);
  allTransactions.push(...result.data);
  paginationToken = result.paginationToken;
  
  console.log(`Fetched ${result.data.length} transactions, total: ${allTransactions.length}`);
} while (paginationToken);

​
多个地址

您不能在单个请求中查询多个地址。要获取多个地址的交易，请在相同的时间或槽窗口中查询每个地址，然后合并和排序： 
const addresses = ['Address1...', 'Address2...', 'Address3...'];

// Query all addresses in parallel with slot filter
const results = await Promise.all(
  addresses.map(address => 
    fetch(rpcUrl, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        jsonrpc: '2.0',
        id: 1,
        method: 'getTransactionsForAddress',
        params: [address, {
          sortOrder: 'desc',
          filters: { slot: { gt: 250000000 } }
        }]
      })
    }).then(r => r.json())
  )
);

// Merge and sort by slot
const allTransactions = results
  .flatMap(r => r.result.data)
  .sort((a, b) => b.slot - a.slot);
对于较大的历史扫描，通过时间或槽窗口进行迭代（例如，每次1000个槽），并重复此模式。
每个地址查询计为一个单独的API请求（每个地址100个积分）。

​
最佳实践

​
性能

为了获得最佳性能，当您不需要完整的交易数据时，使用transactionDetails: "signatures"。实现合理的页面大小以获得更好的响应时间，并考虑按时间范围或特定槽进行过滤以进行更有针对性的查询。

​
过滤

从广泛的过滤器开始，并逐步缩小范围以找到所需的数据。使用基于时间的过滤器进行分析和报告工作流。您可以结合多个过滤器进行精确查询，以定位特定的交易类型或时间段。

​
分页

在需要稍后恢复大型查询时存储分页键。监控分页深度以进行性能规划，并在需要按时间顺序重播历史事件的情况下使用升序。

​
错误处理

使用指数退避策略优雅地处理速率限制。在发出请求之前始终验证地址，并在适当时缓存结果以减少API使用并提高应用程序性能。

​
这与getSignaturesForAddress有何不同？

如果您熟悉标准的getSignaturesForAddress方法，以下是主要区别：

​
在一次调用中获取完整交易

使用getSignaturesForAddress，您需要两个步骤： 
// Step 1: Get signatures
const signatures = await connection.getSignaturesForAddress(address, { limit: 100 });

// Step 2: Get transaction details (100 additional calls!)
const transactions = await Promise.all(
  signatures.map(sig => connection.getTransaction(sig.signature))
);
使用getTransactionsForAddress，只需一次调用： 
const response = await fetch(heliusRpcUrl, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransactionsForAddress',
    params: [
      address,
      {
        transactionDetails: 'full',
        limit: 100
      }
    ]
  })
});

​
附加功能

按时间顺序排序

使用 sortOrder: 'asc' 将交易从最早到最新排序

基于时间的过滤

使用 blockTime 过滤器按时间范围过滤

状态过滤

使用 status 过滤器仅获取成功或失败的交易

更简单的分页

使用 paginationToken 代替复杂的 before/until 签名

​
支持与社区

联系支持

获取我们团队的技术问题和问题帮助

Discord 社区

加入数千名在 Solana 上使用 Helius 构建的开发者