TraderSpy Market Screener

TraderSpy Market Screener combines two read-only tools. screen_symbols evaluates technical conditions across liquid pairs or an explicit symbol list, while backtest_condition studies subsequent price behavior after historical occurrences on one symbol and timeframe. The shared vocabulary lets a current screen and its historical study use the same definition instead of changing the pattern between steps.

A condition includes a metric, comparison operator, value, and optional periods. Less-than and greater-than compare the latest value; crossAbove and crossBelow identify a one-bar crossing event. Supported metrics cover oscillators such as RSI, stochastic, CCI, MFI, and Williams R; trend measures such as ADX, EMA distance, EMA spread, and Supertrend; and volatility, volume, Bollinger bands, change, or price. Periods are bounded from two to two hundred. At most three conditions are combined with AND. An OR requires separate scans whose results are merged.

Screening uses a timeframe matched to the user's horizon and either a volume-ranked universe or explicit symbols. The universe supports up to one hundred most-traded pairs, and an explicit list supports up to one hundred symbols. Returned rows include price, daily change, volume, bias, trend, RSI, ADX, ATR percentage, volume ratio, squeeze status, and labeled condition values. The default interval is 4h, the default universe is 50, and the universe range is 5-100. Returned rows are limited to fifty. If more symbols match than are returned, the report discloses the truncation. Explicit symbols without conditions create a comparison table.

Use it for oversold or overbought lists, trend and volume filters, Bollinger squeezes, watchlists, side-by-side comparisons, or historical questions about a condition. The condition translation is stated before calling the tool. Separate archetypes such as mean reversion, trend continuation, and breakout can receive their own scans. A one-coin deep read belongs to the technical-analysis skill, and funding or positioning is added only when the question requires it.

Screens describe current chart facts; backtests describe a historical sample. Neither determines a trade or sizing decision. A missing symbol is reported as unscanned rather than as a failed match. The connector has no order, transfer, withdrawal, or position-closing capability.

Inputs are the user's condition, timeframe, universe or symbol list, and optional historical return horizons. A comparison request can be:

Compare BTC, ETH and SOL on the daily.

Backtesting examines up to one thousand stored candles. An occurrence is the first bar of a continuous matching run, so repeated consecutive bars count as one episode. Up to four horizons are expressed in bars. Results include sample count, average and median return, win rate, average best and worst excursions, best and worst returns, unconditional average return, and edge relative to that baseline. Current condition values, active status, the last occurrence, and the last five episodes provide additional context. Default horizons are [4, 24, 72] on 1h, [6, 18, 42] on 4h and [1, 3, 7] on 1d. Table headings reuse returned labels such as RSI(14) and EMA spread(50,200), so the reader can identify the actual tested periods.

Reports attach edge to sample size, explain differences between median and average, and show adverse excursions beside win rates. Conflicting horizons are retained rather than selecting the most flattering result. Episodes too recent for a horizon remain null instead of being counted as zero. Coverage limits are explicit, particularly when short intraday history captures only one regime.

The workflow needs a hosted TraderSpy MCP connection over Streamable HTTP with OAuth or a personal key. A free account is sufficient; daily quotas are 300 calls on the free tier and 5,000 on premium. Without the server, the skill has no data. Historical coverage is roughly 41 days on one-hour bars, 166 days on four-hour bars, and three years on daily bars.
Condition recipes translate intent explicitly: oversold RSI below 30, overbought above 70, a 200 EMA trend with Supertrend confirmation, or a 50/200 EMA crossing event. Volatility recipes distinguish a 4h Bollinger-width threshold of 4 from 2.5 on 1h. A squeeze suggests expansion, not its direction. Backtest pairings can study a daily golden cross over [5, 10, 20, 40] bars or a capitulation day over [1, 3, 7, 14]. Crypto derivatives remain high-risk; these are historical and current market facts for research.