screen_symbols
Screen MANY crypto futures symbols at once on one timeframe — "which coins are oversold on 4h", "what is above its 200 EMA with rising volume", "show me squeezes". Give up to 3 AND-ed conditions from a fixed metric list (RSI, stochastic, CCI, MFI, Williams %R, ADX, ROC, MACD histogram, ATR%, volume ratio, Bollinger %B / width, price vs EMA, EMA spread, SuperTrend, change %, price) with lt / gt / crossAbove / crossBelow. Scans the most-traded symbols by 24h volume (default 50, max 100) or an explicit list; every row carries the metric values plus bias, trend, RSI, ADX, ATR% and 24h change. With NO conditions and explicit symbols it is a side-by-side comparison table ("compare BTC, ETH, SOL"). ONE quota unit however many symbols — always prefer this over calling get_technical_indicators in a loop.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return | |
| sortBy | No | volume (24h quote volume), change24h, or metric (the first condition's metric). Default: metric when conditions are given, else volume. | |
| symbols | No | Explicit symbols to scan (≤ 100, e.g. ["BTC","ETH","SOL"]). Omit to scan the most-traded symbols instead. With no `conditions`, every listed symbol is returned as a comparison table. | |
| interval | No | Candle timeframe to evaluate on | 4h |
| universe | No | How many of the most-traded symbols (by 24h volume) to scan when `symbols` is omitted (max 100) | |
| sortOrder | No | desc | |
| conditions | No | Up to 3 conditions, AND-ed. Examples: RSI oversold = {"metric":"rsi","op":"lt","value":30}; above the 200 EMA = {"metric":"priceVsEma","op":"gt","value":0,"period":200}; golden cross = {"metric":"emaSpread","op":"crossAbove","value":0,"period":50,"period2":200}; MACD bullish cross = {"metric":"macdHistogram","op":"crossAbove","value":0}; dumped 5% in a day = {"metric":"changePct","op":"lt","value":-5,"period":24}. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sortBy | No | ||
| matched | No | Symbols satisfying every condition (all scanned symbols when no conditions) | |
| results | No | One row per matching symbol: { symbol, price, change24hPct, volume24hUsd, values { "<metric label>": value }, bias, trend, rsi14, adx14, atrPct, volumeRatio, squeeze } | |
| interval | No | ||
| returned | No | ||
| universe | No | { source: top_by_volume | explicit, requested, scanned, missing[] } | |
| warnings | No | ||
| sortOrder | No | ||
| conditions | No | Human-readable conditions, e.g. "RSI(14) < 30" |