跳转到主要内容
getSignaturesForAddress RPC 方法允许您检索涉及特定账户地址的已确认交易签名列表。这对于获取账户的交易历史非常有用。签名按时间倒序返回（最新的在前）。
对于高级过滤、排序和代币账户历史，请使用 getTransactionsForAddress。请注意，getSignaturesForAddress 不包含涉及关联代币账户的交易。

​
常见用例

  • 账户交易历史： 显示用户钱包的过去交易。对于更高级的交易历史解析，考虑使用 Helius 的 增强交易 API。
  • 活动审计： 审查与特定智能合约或账户相关的所有交易。
  • 特定交易查找： 如果只知道相关地址，通过遍历账户历史查找特定交易。
  • 数据索引： 构建本地化的交易索引以加快查询和分析。

​
请求参数

  1. address (string): （必需）要检索交易签名的账户的 base-58 编码公钥。
  2. options (object, 可选): 包含以下字段的可选配置对象：
    • limit (number, 可选): 要返回的最大签名数。默认值为 1000，最大允许值为 1000。
    • before (string, 可选): 一个 base-58 编码的交易签名。如果提供，查询将从此签名之前的交易开始。
    • until (string, 可选): 一个 base-58 编码的交易签名。如果提供，查询将在该签名达到之前搜索交易（不包括该签名）。
    • commitment (string, 可选): 指定查询使用的承诺级别。支持的值为 finalized 或 confirmed。不支持 processed 承诺。如果省略，则使用 RPC 节点的默认承诺（通常为 finalized）。
    • minContextSlot (number, 可选): 请求可以被评估的最小 slot。这不是对历史交易的过滤，而是为节点的上下文设置最小 slot。
不支持批处理此归档方法不支持批处理。仅进行单独请求。

​
响应结构

JSON-RPC 响应中的 result 字段是一个签名信息对象数组。每个对象的结构如下：
  • signature (string): base-58 编码的交易签名。
  • slot (u64): 处理交易的槽位。
  • err (object | null): 如果交易失败则为错误对象，成功则为 null。
  • memo (string | null): 交易相关的备忘录（如果有）。
  • blockTime (i64 | null): 包含交易的块的估计生成时间，Unix 时间戳格式（自纪元以来的秒数）。如果不可用则为 null。
  • confirmationStatus (string | null): 交易的确认状态（例如，processed, confirmed, finalized）。如果不可用（例如，对于旧的 Helius 响应）则为 null。

​
示例

​
1. 获取地址的最新签名

此示例获取给定地址的最近（最多 1000 个）交易签名。 
# Replace <api-key> with your Helius API key
# Replace SYSTEM_PROGRAM_ID with the address you want to query
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "11111111111111111111111111111111" 
    ]
  }'

​
2. 获取有限制的签名

此示例获取指定数量的地址的最近交易签名。 
# Replace <api-key> with your Helius API key
# Replace TARGET_ACCOUNT_ADDRESS with the address you want to query
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "TARGET_ACCOUNT_ADDRESS",
      {
        "limit": 5 
      }
    ]
  }'

​
3. 分页获取交易历史

此示例演示如何使用 before 参数批量获取交易历史。 
# Initial request (get the latest 2)
# Replace <api-key> with your Helius API key
# Replace TARGET_ACCOUNT_ADDRESS with the address you want to query
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "TARGET_ACCOUNT_ADDRESS",
      { "limit": 2 }
    ]
  }'

# Suppose the last signature from the above response was LAST_SIGNATURE_FROM_PREVIOUS_BATCH
# Fetch the next 2 transactions before that one
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "TARGET_ACCOUNT_ADDRESS",
      { 
        "limit": 2,
        "before": "LAST_SIGNATURE_FROM_PREVIOUS_BATCH" 
      }
    ]
  }'

​
开发者提示

  • 分页: 要获取活跃账户的完整交易历史，您可能需要进行多次请求，使用上一个批次中收到的最后签名和一个 limit。
  • 速率限制: 在获取大量交易历史时，请注意 RPC 节点的速率限制。
  • 顺序: 签名总是从最新返回到最旧。
  • limit 参数： limit 参数可以在 1 到 1000 之间。如果未指定，默认值为 1000。
  • until 参数： 此参数可用于在达到已知较旧的签名时停止获取签名，如果您只需要获取到某个时间点的交易，这非常有用。
  • minContextSlot: 此参数不过滤历史交易。它指定 RPC 节点在评估请求时应该使用的最小槽位上下文。如果节点的状态早于此槽位，可能返回错误。
  • 交易详情: 此方法只返回签名和基本信息。要获取完整的交易详情，您需要使用每个签名调用 getTransaction 方法。
  • 代币账户限制: 此方法仅返回直接引用提供地址的交易。不包括地址拥有的代币账户相关交易。要获取完整的代币历史，包括关联的代币账户，请使用 getTransactionsForAddress 结合 tokenAccounts 过滤器。
通过使用 getSignaturesForAddress 及其分页选项，您可以有效地检索和管理任何 Solana 地址的交易历史。

​
相关方法

getTransactionsForAddress

高级过滤、排序和代币账户历史

getTransaction

从签名获取完整的交易详情