TraderSpy Smart Money

TraderSpy follows thousands of top-ranked accounts on four exchanges and records their positions as they open, change and close. This skill turns that feed into answers about positioning and about individual traders. Positions are observations of what other people did with their own money — present them as evidence, never as instructions.

When to Use

• Use when the user asks what whales or top traders are buying, shorting or holding, or whether big accounts are long or short a coin.
• Use when the user asks who ranks highest on an exchange or across exchanges, or wants to research one trader's record and open positions.
• Use for "smart money", "whale watch" or "what are the pros doing".
• Not for funding rate, open interest or long/short ratios of the whole market (@traderspy-technical-analysis), and not for AI signals (@traderspy-trading-signals).

Tools

Always pass source with a trader id. get_trader_profile and get_trader_position_history default to Binance; a Hyperliquid address (0x…) or an OKX id looked up on the wrong exchange returns nothing. Take source from the row you got the id from.

Reading the data

Symbols differ per exchange. Hyperliquid rows use bare coins (BTC, ZEC) and prefix tokenized stocks with xyz: (xyz:AVGO); Binance, Bybit and OKX rows use BTCUSDT. When the user asks about "BTC positions", pass symbol: "BTC" — the filter matches both BTC and BTCUSDT exactly — and read the symbol field before summing anything. Tokenized stocks (xyz:AVGO) are not reachable through the filter; fetch without symbol and pick them out.

Position rows: side LONG / SHORT, size in coins, entryPrice, markPrice, leverage, unrealizedPnl (open rows) or pnl + roi (closed rows), openTime / closeTime, isOpen, lastEvent (increase, partial_close, or null when the last change was the open itself). Notional ≈ size × markPrice; use notional, not row count, when you say "whales are net long".

Freshness. Binance and Bybit snapshots refresh every 5–15 minutes, Hyperliquid every 15 minutes plus live fills, OKX every 10–60 minutes. On a free-tier key the feed is delayed 15 minutes — if get_positions returns nothing newer than that, say the feed is delayed rather than "no activity".

Leaderboard rows (get_top_traders) carry the exchange's own ranking snapshot: roi, pnl, assets (account size), winRate (null on Hyperliquid — the exchange does not publish it), rankings[] with the same trader across every window, and smartScore when TraderSpy has scored them. traderName is a shortened address when the account has no public name. A trader who is #1 on 30-day ROI with assets of $5k is a different animal from #19 with $3.4M — quote both.

Smart score (get_elite_leaderboard, 0–100, recomputed daily): realized PnL 30% (all-time blended with the last 30 days), effective win rate 22%, ROI edge 18%, consistency 14%, longevity 10%, trade depth 6%, plus a recency bonus (up to +9) and a staleness penalty (down to −12 after about three weeks idle). scoreBreakdown shows each part, rationale[] is a ready-made plain-language justification, metrics has the raw counts (closedTrades, profitFactor, realizedPnl30d, openPositionCount, worstDayPnl). reliabilityMultiplier below 1 means a short history dragged the score down — say so when a 6-day-old account ranks top-5.

Market stats aggregate every tracked position, thousands of them, so realizedPnl can be a

…