跳转到主要内容
GET
USDC received

SDK Example

授权

x-api-key
string
header
必填

用于鉴权的 API Key

路径参数

address
string
必填

钱包或账户地址。SPL 转账通过该钱包拥有的代币账户匹配。

查询参数

limit
integer
默认值:100

每页转账数。每页只包含完整的交易,因此可能略多或略少。grouped=true 时改为按交易计数,除非设置了 dex=include,且未设置 type、地址、数量或插槽筛选以及 excludeZero 中的任何一个。使用 minValue 或 maxValue 时最多为 100。

必填范围: 1 <= x <= 1000
cursor
string

上一页返回的 pagination.next。翻页时请保持其他参数不变。传入空的 cursor= 会返回第一页。

sortOrder
enum<string>
默认值:desc

desc 按从新到旧返回,asc 按从旧到新返回。

可用选项:
desc,
asc
start
integer

区块时间起点,Unix 秒,包含边界值。不接受毫秒。

必填范围: x >= 0
end
integer

区块时间终点,Unix 秒,包含边界值。不得早于 start。

必填范围: x >= 0
startSlot
integer

插槽起点,包含边界值。

必填范围: x >= 0
endSlot
integer

插槽终点,包含边界值。

必填范围: x >= 0
direction
enum<string>
默认值:all

该地址接收(in)或发出(out)的转账。

可用选项:
all,
in,
out
type
enum<string>

sol 表示原生 SOL 转账,spl 表示 SPL 和 Token-2022 转账(包括 wrapped SOL)。默认两者都返回。

可用选项:
sol,
spl
mint
string

仅返回此代币的转账。使用 wrapped SOL mint So11111111111111111111111111111111111111112 时会返回原生 SOL 和 wrapped SOL 转账。

status
enum<string>
默认值:success

交易结果:success(默认)、failed 或 any。每笔转账都有各自的 status。

可用选项:
success,
failed,
any
dex
enum<string>
默认值:exclude

exclude(默认)排除有 DEX 活动的交易中的所有转账,only 仅返回这些转账,include 返回全部。当交易中有转账发往或来自某个池(DEX 或发射台程序拥有的账户,或 Raydium、Meteora 的金库权限账户)时,该交易即视为有 DEX 活动:包括兑换、添加和移除流动性,以及领取手续费或奖励。该地址发出一种代币并收到另一种代币的交易也算在内。

可用选项:
exclude,
include,
only
from
string

最多 5 个发送方地址(钱包或代币账户),用英文逗号分隔。

to
string

最多 5 个接收方地址(钱包或代币账户),用英文逗号分隔。

counterparty
string

最多 5 个任一方的地址(钱包或代币账户),用英文逗号分隔。

excludeFrom
string

排除来自这些地址的转账(最多 5 个,用英文逗号分隔)。

excludeTo
string

排除发往这些地址的转账(最多 5 个,用英文逗号分隔)。

minAmount
number

最小数量,以代币单位(uiAmount)计,包含边界值。

必填范围: x >= 0
maxAmount
number

最大数量,以代币单位(uiAmount)计,包含边界值。

必填范围: x >= 0
minValue
number

转账发生时的最低美元价值,包含边界值。会启用 historicPrices,且 limit 最多为 100。每页检查接下来的 limit 笔转账并返回其中匹配的转账,因此即使 hasMore 为 true,一页也可能更少,甚至为空。

必填范围: x >= 0
maxValue
number

转账发生时的最高美元价值,包含边界值。会启用 historicPrices,且 limit 最多为 100。

必填范围: x >= 0
historicPrices
boolean
默认值:false

为每笔转账添加 price.usd 和 value.usd:代币的美元价格取自转账时或之前最近一根 1 分钟 K 线,最多早一小时,否则为 null。USDC、USDT 和 USD1 按 1 计价。不启用时,转账不包含 price 和 value。

grouped
boolean
默认值:false

同时返回 transactions:本页转账按交易分组,包含合计、dex 和兑换识别。

excludeZero
boolean
默认值:false

排除数量为零的转账。

响应

该地址的转账

account
string
必填
transfers
object[]
必填

本页的转账。grouped=true 时为所返回交易的全部转账。

pagination
object
必填
grouped
boolean

grouped=true 时出现且为 true

transactions
object[]

仅 grouped=true

enrichmentStatus
enum<string>

价格查询超时时出现:未找到的价格为 null。此类页面不会被缓存。

可用选项:
partial