TraderSpy Market Briefing

A briefing is a fixed set of questions answered with fresh numbers, in an order a trader can scan in thirty seconds: where are the majors, how is the market positioned, what is the signal engine seeing, what stands out on the screener. The value is in the selection and the brevity, not in the volume of data — every tool call costs the user quota, so the playbook below is deliberately tight.

When to Use

• Use when the user asks "what's happening in crypto", for a market update or a morning brief, "how's the market today", "anything interesting right now", an overview or a weekly recap.
• Use when a conversation opens with a vague question about the crypto market, even a casual one.
• Do not use for a deep dive on one coin (@traderspy-technical-analysis), one trader (@traderspy-smart-money) or one signal (@traderspy-trading-signals).

The playbook (6 calls, all read-only)

1. Majors — get_price with ["BTCUSDT","ETHUSDT","SOLUSDT"] plus any coins the user has mentioned in the conversation (≤ 20 per call). Price, 24h change, 24h range.
2. Positioning — get_derivatives with ["BTC","ETH","SOL"] (add up to two of the user's coins). Funding label and annualized rate, open-interest change and regime, top-trader long share, taker flow. The notes[] are written to be quoted.
3. Movers — screen_symbols with no conditions, sortBy: "change24h", limit: 50, universe: 50, interval: "4h". One call returns all 50 most-traded pairs sorted by 24h change: the top five are the gainers, the last five the losers.
4. What is stretched — screen_symbols with [{"metric":"rsi","op":"lt","value":30}] on 4h, limit: 5. If it returns nothing, flip to rsi gt 70 — one of the two usually has names.
5. Signal engine — get_signal_stats with period: "24h" (or 7d for a weekly recap).
6. Freshest ideas — get_signals with limit: 5.

Smart-money lean is already in step 2 (positioning.topTraderLongPct); add get_positions (status: open, limit: 20) only when the user asks who specifically is positioned how.

Quota-aware variants. If the user is on a free key or asks for "just the headline", run steps 1, 2 and 5 only (three calls) and say what you skipped. For a weekly recap use 7d in step 5 and interval: "1d" in steps 3–4.

If any call fails or returns empty, keep the section with a one-line "unavailable right now" note rather than dropping it silently — a briefing with a hole is more honest than one that quietly narrowed.

Reading the pieces

• Funding: near the 0.01%/8h baseline is neutral; clearly positive means longs pay shorts (a crowded long is a risk, not a signal); negative means shorts pay. Quote the annualized figure — it is the number people feel.
• Open interest regime (openInterest.regime): new_longs (OI up, price up), short_covering (OI down, price up), new_shorts (OI up, price down), long_liquidation (OI down, price down), flat. This is the one line that explains WHY the majors moved.
• Top-trader long share: the tool labels long_heavy at a long/short ratio ≥ 1.5 (≈ 60%+ long) and short_heavy at ≤ 0.67 (≈ 40% or less); in between call it balanced. Top-trader positioning is the more informative one; the all-account ratio shows the crowd.
• Signal stats: winRate is hits ÷ (hits + stops) on signals created in the window; say total and pending next to it, and treat a 24h window with fewer than ~10 resolved signals as a small sample.
• Movers are the most-traded pairs by 24h volume sorted by change — a liquid-names list, not an all-market list. Say so if a small cap the user follows is missing.

The briefing format

ALWAYS use this structure, in this order, with real numbers from the calls — no placeholders:

Crypto brief — <date, UTC time of the calls>

1. Headline — one sentence: the majors' direction and the single most notable positioning fact.
2. Majors — a table: Symbol · Price · 24h % · 24h range.
3. Positioning — per major, one line: funding (label, annualized), OI regime, top-trader long %, and one quoted note.
4. Movers — top 5 gainers and top 5 losers among the most-traded pairs (symbol, price, 24h %).
5. Stretched — the oversold or overbought names with their RSI, or "none on the 4h" if empty.
6. Signal engine — total signals in the window, hit rate with the resolved count, then the

…