xca文档
接口

持有人

分页返回已扫描代币的持有人及其分类，包含盈亏、入场时间和资金来源。

GET/api/v1/tokens/{chain}/{address}/holders

返回代币经过分析的持有人，按排名排序，并附带 XCA 为每个钱包分配的类别。该代币必须已被扫描，否则会返回 404。

参数#

chainpath必填
链 ID。目前仅支持 solana。"solana"
addresspath必填
代币的 mint 地址。string
pagequery
页码，从 1 开始。integer ≥ 1默认: 1
pageSizequery
每页持有人数。10 | 25 | 50 | 100默认: 100
classquery
只返回该类别的持有人。ALL | HolderClass默认: ALL

请求#

curl -s "https://app.xca.fun/api/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/holders?class=SMART_MONEY&pageSize=25" \
  -H "Authorization: Bearer $XCA_API_KEY"
在线调试
粘贴你的 API 密钥即可发送真实请求。

响应#

rows
本页的持有人。HolderRow[]
rank
按余额排名，1 为最大。number
address
钱包地址。string | null
sharePct
持有的供应量占比。number
valueUsd
持仓价值（美元）。number | null
class
XCA 为该钱包分配的类别。HolderClass | "HIDDEN"
flags
钱包的附加特征。string[]
entryAt
首次买入的时间。string | null
entryBlock
从开盘到首次买入间隔的区块数（狙击手的数值很小）。number | null
pnl30dUsd
近 30 天的已实现和未实现盈亏（美元）。number | null
pnl30dPct
近 30 天的盈亏（百分比）。number | null
winRate
盈利交易的占比，取值 0 到 1。number | null
avgHoldSec
平均持仓时间（秒）。number | null
trades30d
近 30 天的交易次数。number | null
fundedBy
最早向该钱包注资的钱包。string | null
clusterId
该钱包所属的集群。string | null
profiled
已有完整的钱包画像。boolean
total
符合筛选条件的可见持有人数。number
lockedCount
因套餐限制而被隐藏的持有人数。number
page
当前页码。number
pageSize
每页持有人数。number
visibleLimit
你的套餐最多显示前多少名持有人；-1 表示全部。number

响应示例#

{
  "rows": [
    {
      "rank": 4,
      "address": "5Hr7wZg7oBpVhH5nngRqzr5W7ZFUfCsfEhbziZJak7fr",
      "sharePct": 1.92,
      "valueUsd": 3641200,
      "class": "SMART_MONEY",
      "flags": [
        "smart"
      ],
      "entryAt": "2023-01-04T18:22:10.000Z",
      "entryBlock": null,
      "pnl30dUsd": 48210.7,
      "pnl30dPct": 31.4,
      "winRate": 0.64,
      "avgHoldSec": 1209600,
      "trades30d": 37,
      "fundedBy": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5",
      "clusterId": null,
      "profiled": true
    }
  ],
  "total": 7,
  "lockedCount": 0,
  "page": 1,
  "pageSize": 25,
  "visibleLimit": -1
}

状态码#

200成功
400validation — 某个参数或请求体无效；详见 error.issues。
401unauthorized — API 密钥缺失、格式错误或已被吊销。
402planRequired — 你的套餐不包含 API 访问权限或该功能。
404notFound — 该代币尚未被扫描，或该钱包尚未建立画像。
429rateLimited — 每分钟请求过多，或月度配额已用完。

持有人类别#

SMART_MONEY近 30 天盈利且胜率高的交易者。
REGULAR无明显特征。
DEV代币创建者。
DEV_BUNDLE与创建者同时买入，或由创建者注资。
SNIPER在开盘后最初几个区块内买入。
FRESH最近才创建的钱包。
POOL流动性池、金库或联合曲线。
CEX中心化交易所钱包。
BURN销毁地址。

注意事项#

  • 你的套餐决定了最多能看到前多少名持有人；total 只统计可见的持有人，lockedCount 表示另外还有多少名。
  • 按 SNIPER、DEV_BUNDLE、SMART_MONEY 或 FRESH 筛选时，需要你的套餐包含相应功能，否则会返回 402。
  • 你的套餐无权查看的类别会以 HIDDEN 返回。
  • 盈亏字段取决于套餐的盈亏级别：基础级提供 pnl30dUsd 和 winRate，详细级另外提供 pnl30dPct、avgHoldSec 和 trades30d。