traderspy-smart-money

用途

TraderSpy Smart Money 用于回答关于“大户”或顶级交易者持仓的问题。它追踪四个交易所（Binance、Hyperliquid、Bybit、OKX）上数千个高排名账户，记录其开仓、调整与平仓行为，并把这些观察整理成可查询的数据。

适用场景包括：用户想知道鲸鱼或顶级交易者正在买入、做空或持有某个币种；某个币种上大账户是多头还是空头；某交易所或跨交易所谁排名最高；研究单个交易者的历史记录与当前持仓；以及“聪明钱”“鲸鱼观察”“专业玩家在做什么”这类问题。

不适用于：全市场资金费率、未平仓合约量、多空比（属于 traderspy-technical-analysis 技能），以及 AI 交易信号（属于 traderspy-trading-signals 技能）。

主要能力

该技能提供以下工具：

• get_elite_leaderboard：按 smart score 给出的跨交易所前 10 名，附带评分理由。
• get_top_traders：按交易所和时间窗口排名的交易者，支持 source（all/binance/hyperliquid/bybit/okx）、timeRange（24h/3D/7D/30D）、rankingType（ROI/PNL）、sortBy（ROI/PNL/SCORE），limit 不超过 200。
• get_positions：持仓动态，支持 status（open/closed/all）、source、symbol，limit 不超过 50，支持 offset 分页。
• get_trader_profile：单个交易者的指标与最新持仓，需要 traderId 和 source。
• get_trader_position_history：单个交易者已平仓交易的分页记录，需要 traderId、source、page，limit 不超过 50。
• get_market_stats：所有追踪持仓的聚合数量与盈亏，支持 source 和 period（4h/8h/24h/7d）。
• get_exchanges：当前追踪的交易所列表。

查询交易者时必须同时传入 source。get_trader_profile 与 get_trader_position_history 默认 Binance；Hyperliquid 地址（0x…）或 OKX id 在错误交易所查询会返回空结果，因此 source 应取自获得该 id 的那一行数据。

数据读取要点

不同交易所的符号格式不同：Hyperliquid 使用裸币种（BTC、ZEC），代币化股票带 xyz: 前缀（如 xyz:AVGO）；Binance、Bybit、OKX 使用 BTCUSDT。查询“BTC 持仓”时可传 symbol: "BTC"，过滤器会精确匹配 BTC 与 BTCUSDT；求和前应先读取 symbol 字段。代币化股票无法通过过滤器直接获取，需不带 symbol 拉取后自行筛选。

持仓行包含：side（LONG/SHORT）、size（币数量）、entryPrice、markPrice、leverage、unrealizedPnl（未平仓行）或 pnl 与 roi（已平仓行）、openTime/closeTime、isOpen、lastEvent（increase、partial_close，若最后一次变化就是开仓本身则为 null）。名义价值约等于 size × markPrice；观察样本应使用名义价值而非行数。聚合前需确认各合约的面值/单位；排行榜样本不能代表全市场净敞口。

数据新鲜度：Binance 与 Bybit 快照每 5–15 分钟刷新，Hyperliquid 每 15 分钟加实时成交，OKX 每 10–60 分钟。免费密钥下数据延迟 15 分钟；若 get_positions 返回的最新数据不晚于该延迟，应说明数据延迟，而不是“没有活动”。

排行榜行（get_top_traders）包含交易所自身的排名快照：roi、pnl、assets（账户规模）、winRate（Hyperliquid 为 null，该交易所不公布）、rankings[]（同一交易者在各窗口的排名），以及 TraderSpy 评分后的 smartScore。没有公开名称的账户，traderName 为缩写地址。30 天 ROI 第一但账户仅 5 千美元的交易者，与资产 340 万美元的第 19 名，是不同性质的样本，应同时引用两项。

Smart score（get_elite_leaderboard，0–100，每日重算）由以下部分构成：已实现盈亏 30%（历史与近 30 天混合）、有效胜率 22%、ROI 优势 18%、一致性 14%、持续性 10%、交易深度 6%，另加新近度奖励（最高 +9）与停滞惩罚（约三周无活动后最低 −12）。scoreBreakdown 展示各部分，rationale[] 是现成的通俗理由，metrics 提供原始计数（closedTrades、profitFactor、realizedPnl30d、openPositionCount、worstDayPnl）。reliabilityMultiplier 低于 1 表示历史过短拉低了评分；若一个 6 天账户排进前 5，应予以说明。

市场统计聚合了所有被追踪的持仓（数千条），因此即使头部交易者在盈利，realizedPnl 也可能为很大的负数；追踪范围包含已跌出排行榜的交易者。该数据适合看数量与交易所分布，不宜解读为“聪明钱在亏钱”。

使用方式

需要在客户端连接 TraderSpy 托管的 MCP 服务器（https://mcp.traderspy.app/mcp，Streamable HTTP），通过 OAuth 或从 https://traderspy.app/mcp 获取的个人密钥授权。免费 TraderSpy 账户即可使用。未连接服务器时该技能没有数据可查。工具调用按天计量：免费版 300 次，高级版 5,000 次。

常见工作流：

• “鲸鱼在 SOL 上做什么？”→ 调用 get_positions，symbol 指定币种、status: open、limit 50。若需要全市场聚合，应设定明确预算后分页；否则把前 50 行标注为样本。按方向汇总可比的名义价值，列出最大的两三个账户及其入场价和杠杆，并说明最新入场的时间。若未平仓行很少，可加 status: closed 查看最近一天的平仓情况。
• “现在最好的交易者是谁？”→ 先调用 get_elite_leaderboard（跨交易所、基于评分），再按用户需要调用 get_top_traders 获取特定交易所或窗口的原始 ROI/PnL。应说明 7 天 ROI 排名可能奖励某一周的运气，smart score 的设计正是为了惩罚这种情况。
• “该不该跟单交易者 X？”/“研究这个交易者”→ 调用 get_trader_profile 加一到两页 get_trader_position_history。从历史中计算用户真正需要的信息：已平仓行的胜率、典型持仓时长（closeTime − openTime）、典型杠杆、单一币种集中度、最差单笔交易，以及近一个月是否与历史纪录相符。以档案形式呈现。是否跟单由用户决定，该连接器无法跟随任何人。
• “专业玩家是多头还是空头？”（全市场）→ 对主要币种调用 get_positions status: open，并结合 get_market_stats；若需所有账户的全交易所多空比，应改用 technical-analysis 的 get_derivatives。

呈现规范

持仓按一行一个持仓展示，字段包括：Trader、Exchange、Side、Size (notional)、Entry、Mark、Lev、uPnL、Opened。

交易者展示包括：名称、交易所、评分或排名、窗口、ROI、PnL、账户规模、胜率（Hyperliquid 显示“n/a”），随后是两行理由。先给出回答问题的关键数字，地址按返回结果缩短，并始终说明 ROI 属于哪个窗口。

限制

• 需要连接托管 MCP 服务器，并完成授权；否则无数据可用。
• 工具调用按天计量：免费版 300 次，高级版 5,000 次。
• 所有工具均为只读，不提供下单、平仓、修改订单、提币或转账功能。
• 输出为供用户自行研究的市场数据与分析，不构成投资建议。
• 免费密钥下持仓行延迟 15 分钟；排行榜、档案与统计不延迟。
• 只能看到 TraderSpy 在四个交易所追踪的账户，看不到同一交易者在其他场所的持仓，因此追踪到的多头可能只是对冲的一腿。
• 持仓是他人用自有资金、对冲与离场行为的结果，无法完整看到，只能作为持仓证据呈现，不能作为跟单建议；领跑者的多头也可能只是对冲的一腿。
• 历史 ROI 与胜率描述的是过去样本，排行榜不应作为未来谁会赢的预测；应指出历史过短和样本过小的问题。
• 只引用工具返回的内容；数据延迟或字段为 null 时应明确说明。
• 当回答涉及具体交易想法时，应以一句通俗的话结尾：加密衍生品风险高，这是市场信息而非财务建议。

相关技能

traderspy-technical-analysis：提供 get_derivatives，用于全交易所资金费率、未平仓合约量与多空比。 traderspy-trading-signals：提供 AI 信号而非交易者持仓。