包含什么
| 字段组 | 举例 |
|---|---|
| 身份 | chainId, address, ens/sns, tags, firstSeenAt |
| 持仓 | holdings[]：token, balance, valueUsd, costBasisUsd, unrealizedPnlUsd |
| 净值 | netWorthUsd、小时 / 日粒度的 netWorthHistory[] |
| 活跃度 | txCount24h, tradeCount30d, avgTradeSizeUsd, activeChains[] |
| 分类 | walletType (EOA / 合约 / 交易所 / smart-money)、riskScore |
覆盖与新鲜度
- 跨链：默认按所有支持链聚合余额与 PnL；需要时按链过滤。
- 新鲜度：持仓在命中的转账 / 交易之后秒级刷新；净值历史按小时快照。
接入方式
REST
wallets/{address}/profile、/holdings、/trades、/pnl、/transfers。GraphQL
一次请求返回持仓 + 交易的 JOIN 结果。
WebSocket
逐钱包频道：
dex-wallet-balance:{chain}_{walletAddress}、dex-wallet-trade:{chain}_{walletAddress}、dex-wallet-token-pnl: / dex-wallet-pnl-list:。SDK：client.stream.subscribeWalletBalance / subscribeWalletTrade / subscribeWalletPnl。Kafka
消费
*.transfer + *.dex.trade 主题并按地址过滤构建。SDK
client.wallet.profile()、.holdings()、.pnl()。MCP
Agent 用
wallets_profile、wallets_activity。常见用例
- 零售用户的资产总览
- 大户 / smart money 跟单 feed
- “这个钱包是谁？“的轻量级预览
- 活动归因（空投、奖励）
- 作为合规初筛输入（配合 KYA）
计费
档案与持仓端点 1 read unit；时间序列 PnL 与历史按返回范围计费。下一步
Smart Money 聪明钱
基于 Wallets 精选的高胜率钱包 cohort。
KYA——Know Your Address
地址画像与风险分。