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

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.

​
概览

getTransfersByAddress 返回涉及钱包地址的代币和本地 SOL 移动的解析、可读的转账对象。使用筛选器根据铸币、区块时间、金额、插槽、方向或交易方缩小结果范围。响应旨在提供准确的钱包活动视图、支付跟踪和余额对账，而无需重新实现 Solana 转账解析。
数据保留 - 目前仅提供最近 1 年的转账历史记录。

​
请求参数

参数 address 是钱包所有者地址，而不是关联的代币账户（ATA）。API 会查找该钱包拥有的代币账户的转账活动。
​
address
string
必填
要查询转账的 Base58 编码的所有者钱包地址。传递钱包所有者地址，而不是关联的代币账户（ATA）。
​
config
object
可选的配置对象。
​
with
string
按交易方地址筛选。仅返回与此地址之间的转账。
​
direction
string
默认值:"any"
按相对于 address 的转账方向筛选。
  • in
  • out
  • any
​
mint
string
按代币铸币地址筛选。使用 So11111111111111111111111111111111111111111 表示本地 SOL，使用 So11111111111111111111111111111111111111112 表示 WSOL。
​
solMode
string
默认值:"merged"
SOL/WSOL 显示模式。
  • merged: 将 WSOL 视为本地 SOL，并排除包装/解包生命周期行，以便更易于对账 SOL 计价历史。
  • separate: 将 WSOL 保留为独特的 SPL 代币铸币，并包括包装/解包生命周期行。
​
filters
object
额外的筛选条件用于金额、区块时间和槽位。
​
filters.amount
object
根据原始转账金额筛选，而不是用户界面金额。
​
filters.amount.gt
number
金额必须大于此整数值。
​
filters.amount.gte
number
金额必须大于或等于此整数值。
​
filters.amount.lt
number
金额必须小于此整数值。
​
filters.amount.lte
number
金额必须小于或等于此整数值。
​
filters.blockTime
object
根据Unix秒的区块时间戳进行筛选。
​
filters.blockTime.gt
number
区块时间必须大于此Unix时间戳。
​
filters.blockTime.gte
number
区块时间必须大于或等于此Unix时间戳。
​
filters.blockTime.lt
number
区块时间必须小于此Unix时间戳。
​
filters.blockTime.lte
number
区块时间必须小于或等于此Unix时间戳。
​
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
用于分页的上一次响应的游标。
​
commitment
string
默认值:"finalized"
数据承诺级别。
  • finalized
  • confirmed
​
sortOrder
string
默认值:"desc"
结果排序。
  • desc
  • asc

​
响应字段

​
data
TokenTransfer[]
请求地址的转账记录。
​
paginationToken
string | null
下一页的游标，或当没有更多结果时为 null。
​
TokenTransfer.signature
string
Base58 编码的交易签名。
​
TokenTransfer.slot
number
包含交易的槽号。
​
TokenTransfer.blockTime
number
区块的 Unix 时间戳（秒）。
​
TokenTransfer.type
string
转账类型：transfer, mint, burn, wrap, unwrap, changeOwner 或 withdrawWithheldFee。
​
TokenTransfer.fromUserAccount
string | null
发送代币的钱包地址，或当没有发送者时为 null。此字段始终存在。
​
TokenTransfer.toUserAccount
string | null
接收代币的钱包地址，或当没有接收者时为 null。此字段始终存在。
​
TokenTransfer.fromTokenAccount
string
源代币账户。不适用时省略，例如本机 SOL 转账。
​
TokenTransfer.toTokenAccount
string
目标代币账户。不适用时省略，例如本机 SOL 转账。
铸币和销毁转账是单方面的。铸币具有 fromUserAccount: null，只能作为接收者的入站转账返回。销毁具有 toUserAccount: null，只能作为销毁所有者的出站转账返回。
​
TokenTransfer.mint
string
代币铸造地址。本机 SOL 使用 So11111111111111111111111111111111111111111；WSOL 使用 So11111111111111111111111111111111111111112 当 solMode 为 separate 时。
​
TokenTransfer.amount
string
将转账金额以字符串形式保存以保持精度。对于收费 Token-2022 转账，这是目标收到的金额。
​
TokenTransfer.feeAmount
string
由 Token-2022 转账费用扩展保留的转账费用。仅在收费转账时出现。对于收费转账，来源被扣除 amount + feeAmount，目标被记入 amount。
​
TokenTransfer.decimals
number
代币的小数位。原生SOL使用9。
​
TokenTransfer.uiAmount
string
可读金额，计算自amount / 10^decimals。
​
TokenTransfer.feeUiAmount
string
可读手续费金额。仅在feeAmount存在时显示。
​
TokenTransfer.confirmationStatus
string
finalized或confirmed。
​
TokenTransfer.transactionIdx
number
区块中交易的索引。
​
TokenTransfer.instructionIdx
number
交易中指令的索引。
​
TokenTransfer.innerInstructionIdx
number
内部指令中的索引。当转账为顶级时为0。

​
请求参数

​
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
​
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

转账数据和分页信息。