跳转到主要内容
POST
getTransfersByAddress
curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTransfersByAddress",
  "params": [
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "limit": 50
    }
  ]
}
'
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "data": [
      {
        "signature": "5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG",
        "slot": 315073428,
        "blockTime": 1736159420,
        "type": "transfer",
        "fromUserAccount": "7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx",
        "toUserAccount": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        "fromTokenAccount": "HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x",
        "toTokenAccount": "CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY",
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "amount": "2500000",
        "decimals": 6,
        "uiAmount": "2.5",
        "confirmationStatus": "finalized",
        "transactionIdx": 35,
        "instructionIdx": 1,
        "innerInstructionIdx": 0
      }
    ],
    "paginationToken": "315073428:35:1:0:splTransfer"
  }
}

​
概览

getTransfersByAddress 返回涉及钱包地址的代币和本地 SOL 移动的解析、可读的转账对象。使用筛选器根据铸币、区块时间、金额、插槽、方向或交易方缩小结果范围。响应旨在提供准确的钱包活动视图、支付跟踪和余额对账，而无需重新实现 Solana 转账解析。
铸造和销毁转账是单向的。铸造具有fromUserAccount: null，只能作为收件人的入站转账返回。销毁具有toUserAccount: null，只能作为销毁所有者的出站转账返回。

​
请求参数

​
address
string
必填
Base58编码的所有者钱包地址，用于查询转账。传递钱包所有者地址，而不是关联的代币账户（ATA）。
​
with
string
按对方地址过滤。仅返回与此地址相关的转账。
​
direction
string
默认值:"any"
根据查询地址的转账方向进行过滤。
  • in
  • out
  • any
​
mint
string
代币铸造地址。对于本地SOL，使用So11111111111111111111111111111111111111111，对于WSOL，使用So11111111111111111111111111111111111111112。
​
solMode
string
默认值:"merged"
SOL/WSOL显示模式。merged模式将WSOL视为本地SOL，并排除包装/解包行，使以SOL计价的历史更易于对账；separate模式将WSOL保留为独立的SPL代币铸造，并包括包装/解包行。
  • merged
  • separate
​
filters
object
用于金额、区块时间和插槽的附加过滤器。
​
filters.amount
object
范围比较过滤器。所有字段都是可选的，并且可以组合使用。
​
filters.amount.gt
number
大于。
​
filters.amount.gte
number
大于或等于。
​
filters.amount.lt
number
小于。
​
filters.amount.lte
number
小于或等于。
​
filters.blockTime
object
范围比较过滤器。所有字段都是可选的，并且可以组合使用。
​
filters.blockTime.gt
number
大于。
​
filters.blockTime.gte
number
大于或等于。
​
filters.blockTime.lt
number
小于。
​
filters.blockTime.lte
number
小于或等于。
​
filters.slot
object
范围比较过滤器。所有字段都是可选的，可以组合使用。
​
filters.slot.gt
number
大于。
​
filters.slot.gte
number
大于或等于。
​
filters.slot.lt
number
小于。
​
filters.slot.lte
number
小于或等于。
​
limit
number
默认值:"100"
要返回的最大传输数量。范围1到100。
​
paginationToken
string
用于分页的上一个响应的游标。
​
example
any
​
commitment
string
默认值:"finalized"
数据承诺级别。
  • finalized
  • confirmed
​
minContextSlot
number
请求使用的最小上下文插槽（可选）。
​
sortOrder
string
默认值:"desc"
结果排序。
  • asc
  • desc

授权

​
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>
默认值:getTransfersByAddress
必填

要调用的RPC方法的名称。

可用选项:
getTransfersByAddress
示例:

"getTransfersByAddress"

​
params
tuple
必填

包含必需的钱包地址和可选配置对象的数组。

示例:
[
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "limit": 50,
    "sortOrder": "desc"
  }
]

响应

成功检索到指定地址的转账。

​
jsonrpc
enum<string>

JSON-RPC 协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string

与请求匹配的标识符。

示例:

"1"

​
result
object

转账数据和分页信息。