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.

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.