跳转到主要内容
POST
getTransactionsForAddress
curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTransactionsForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    {
      "transactionDetails": "signatures",
      "limit": 10
    }
  ]
}
'
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "data": [
      {
        "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1054,
        "transactionIndex": 42,
        "err": null,
        "memo": null,
        "blockTime": 1641038400,
        "confirmationStatus": "已完成"
      },
      {
        "signature": "kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1055,
        "transactionIndex": 15,
        "err": null,
        "memo": null,
        "blockTime": 1641038460,
        "confirmationStatus": "已完成"
      }
    ],
    "paginationToken": "1055:5"
  }
}

​
请求参数

​
address
string
必填
要查询交易历史的账户的 Base-58 编码公钥
​
transactionDetails
string
默认值:"signatures"
返回的交易细节级别：
  • signatures: 基本签名信息（更快）
  • full: 完整交易数据（消除 getTransaction 调用的需要，限额 ≤ 100）
​
sortOrder
string
默认值:"desc"
结果的排序顺序：
  • desc: 最新优先（默认）
  • asc: 最旧优先（按时间顺序，适合历史分析）
​
limit
number
默认值:"1000"
返回的最大交易数：
  • 当 transactionDetails: "signatures" 时最多 1000
  • 当 transactionDetails: "full" 时最多 100
​
paginationToken
string
来自上一个响应的分页令牌（格式："slot:position"）
​
commitment
string
默认值:"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" }
​
filters.tokenAccounts
string
默认值:"none"
筛选相关代币账户的交易：
  • none: 仅返回引用所提供地址的交易（默认）
  • balanceChanged: 返回引用所提供地址或修改由所提供地址拥有的代币账户余额的交易（推荐）
  • all: 返回引用所提供地址或由所提供地址拥有的任何代币账户的交易
示例: { "tokenAccounts": "balanceChanged" }
​
encoding
string
交易数据的编码格式（仅当 transactionDetails: "full" 时适用）。与 getTransaction API 相同。选项: json, jsonParsed, base64, base58
​
maxSupportedTransactionVersion
number
设置要返回的最大交易版本。如果省略，则只返回传统交易。设置为 0 以包括所有版本的交易。
​
minContextSlot
number
请求可被评估的最低插槽

授权

​
api-key
string
query
必填

您的Helius API密钥。您可以在仪表板中免费获取一个。

请求体

application/json
​
jsonrpc
enum<string>
默认值:2.0
必填

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string
默认值:1
必填

请求的唯一标识符。

示例:

"1"

​
method
enum<string>
默认值:getTransactionsForAddress
必填

要调用的RPC方法名称。

可用选项:
getTransactionsForAddress
示例:

"getTransactionsForAddress"

​
params
tuple
必填

包含所需账户地址和可选配置对象的数组。

示例:
[
  "Vote111111111111111111111111111111111111111",
  {
    "transactionDetails": "signatures",
    "limit": 50,
    "sortOrder": "desc",
    "filters": {
      "status": "succeeded",
      "slot": { "gte": 1000, "lt": 2000 }
    }
  }
]

响应

成功检索到指定地址的交易。

​
jsonrpc
enum<string>

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string

与请求匹配的标识符。

示例:

"1"

​
result
object

交易数据和分页信息。