包含什麼
| 欄位組 | 舉例 |
|---|---|
| 身份 | 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.getPnl()、client.wallet.getNetWorth()、client.wallet.getTokensBalance()。MCP
Agent 用
wallets_profile、wallets_activity。常見用例
- 零售使用者的資產總覽
- 大戶 / smart money 跟單 feed
- “這個錢包是誰？“的輕量級預覽
- 活動歸因（空投、獎勵）
- 作為合規初篩輸入（配合 KYA）
計費
檔案與持倉端點 1 read unit；時間序列 PnL 與歷史按返回範圍計費。下一步
Smart Money 聰明錢
基於 Wallets 精選的高勝率錢包 cohort。
KYA——Know Your Address
地址畫像與風險分。