xca文档
接口

钱包

钱包近 30 天的交易画像：盈亏、胜率、持仓时间和资金来源。

GET/api/v1/wallets/{address}

返回 XCA 为某个钱包建立的画像。钱包画像在代币扫描期间生成（针对最大的持有人），也可以在应用中按需生成；从未建立画像的钱包会返回 404。

参数#

addresspath必填
钱包地址。string

请求#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -H "Authorization: Bearer $XCA_API_KEY"
在线调试
粘贴你的 API 密钥即可发送真实请求。

响应#

address
钱包地址。string
isSmart
该钱包达到聪明钱门槛。boolean
pnl30dUsd
近 30 天的盈亏（美元）。number | null
pnl30dPct
近 30 天的盈亏（百分比）。number | null
winRate
盈利交易的占比，取值 0 到 1。number | null
trades30d
近 30 天的交易次数。number | null
avgHoldSec
平均持仓时间（秒）。number | null
walletAgeDays
距首笔交易的天数。number | null
fundedBy
最早向该钱包注资的钱包。string | null
lastProfiledAt
画像的生成时间。string

响应示例#

{
  "address": "HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH",
  "isSmart": true,
  "pnl30dUsd": 48210.7,
  "pnl30dPct": 31.4,
  "winRate": 0.64,
  "trades30d": 37,
  "avgHoldSec": 1209600,
  "walletAgeDays": 412,
  "fundedBy": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5",
  "lastProfiledAt": "2026-10-02T08:40:11.000Z"
}

状态码#

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

注意事项#

  • pnl30dPct 和 avgHoldSec 需要你的套餐包含详细盈亏，fundedBy 需要套餐包含集群功能；否则它们为 null。
  • isSmart 标记达到聪明钱门槛的钱包：近 30 天盈利、胜率高且交易次数足够。