跳转到主要内容
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"
  }
}

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.

​
请求参数

​
address
string
必填
用于检索交易历史的Solana账户地址（钱包、代币、程序、NFT等）。
​
transactionDetails
string
默认值:"signatures"
返回的交易详细程度。
  • signatures
  • full
​
sortOrder
string
默认值:"desc"
返回交易的排序顺序。
  • asc
  • desc
​
commitment
string
默认值:"finalized"
请求的承诺级别。不支持的processed级别。
  • confirmed
  • finalized
​
minContextSlot
number
请求使用的最小上下文槽（可选）。
​
limit
number
默认值:"1000"
每个请求的最大交易数量。对于 transactionDetails:“signatures” 使用 1–1000，对于 transactionDetails:“full” 使用 1–1000。
​
paginationToken
string
从上一个响应中获取下一页结果的分页令牌（格式为”slot:position”）。
​
encoding
string
默认值:"json"
交易数据的编码格式（仅适用于transactionDetails=full时）。
  • json
  • jsonParsed
  • base58
  • base64
​
maxSupportedTransactionVersion
number
返回的最大交易版本（仅适用于transactionDetails=full时）。
​
filters
object
用于缩小交易结果的高级筛选器。
​
filters.slot
object
按插槽编号过滤。
​
filters.slot.gte
number
大于或等于插槽编号。
​
filters.slot.gt
number
大于插槽编号。
​
filters.slot.lte
number
小于或等于插槽编号。
​
filters.slot.lt
number
小于插槽编号。
​
filters.blockTime
object
按区块时间戳（Unix时间戳）过滤。
​
filters.blockTime.gte
number
大于或等于时间戳。
​
filters.blockTime.gt
number
大于时间戳。
​
filters.blockTime.lte
number
小于或等于时间戳。
​
filters.blockTime.lt
number
小于时间戳。
​
filters.blockTime.eq
number
等于时间戳。
​
filters.signature
object
通过交易签名进行过滤。
​
filters.signature.gte
string
获取签名大于或等于此值的交易。
​
filters.signature.gt
string
获取此签名之后的交易。
​
filters.signature.lte
string
获取签名小于或等于此值的交易。
​
filters.signature.lt
string
获取此签名之前的交易。
​
filters.status
string
默认值:"any"
通过交易状态进行过滤。
  • succeeded
  • failed
  • any
​
filters.tokenAccounts
string
默认值:"none"
筛选相关代币账户的交易。控制是否包括涉及地址所拥有的代币账户的交易。
  • none
  • balanceChanged
  • all
​
filters.tokenTransfer
object
将结果限定为查询地址参与的符合特定条件的代币转移的交易。所有字段都是可选的，并且使用AND语义组合。
​
filters.tokenTransfer.with
string
对方地址。匹配另一方是此地址的转账。
​
filters.tokenTransfer.direction
string
默认值:"any"
相对于查询地址的转账方向。
  • in
  • out
  • any
​
filters.tokenTransfer.mint
string
筛选的代币铸造。
​
filters.tokenTransfer.amount
object
原始链上金额范围过滤器。所有字段都是可选的，可以组合使用。

授权

​
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 },
      "tokenTransfer": {
        "direction": "in",
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
      }
    }
  }
]

响应

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

​
jsonrpc
enum<string>

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string

与请求匹配的标识符。

示例:

"1"

​
result
object

交易数据和分页信息。