TraderSpy Market Screener

Duas ferramentas, um vocabulário. screen_symbols avalia até três condições combinadas com AND nos pares mais negociados (ou uma lista que você fornecer) em um único timeframe, em UMA unidade de cotação. backtest_condition pega as mesmas condições, um símbolo e um timeframe, e reporta o que o preço fez após cada ocorrência passada — com a linha de base incondicional para que a vantagem seja separada da deriva da fita.

Juntas, elas respondem às duas perguntas que os traders realmente fazem: "o que se encaixa neste padrão agora?" e "este padrão significou algo antes?"

Quando Usar

• Use quando o usuário quiser encontrar, filtrar, ranquear ou comparar várias moedas por condições técnicas: "quais moedas estão sobrevendidas no 4h", "o que está acima da sua EMA de 200 com volume crescente", "mostre-me squeezes de Bollinger", "encontre-me setups".
• Use para tabelas de comparação lado a lado como "compare BTC, ETH e SOL".
• Use quando o usuário perguntar o que aconteceu após uma condição no passado: "como a ETH se saiu depois que o RSI caiu abaixo de 30", "um cruzamento dourado no BTC diário é realmente altista".
• Nunca responda a isso chamando get_technical_indicators moeda por moeda. Para uma leitura profunda de uma moeda, use @traderspy-technical-analysis.

O vocabulário de condições

Uma condição é { metric, op, value, period?, period2? }. op é lt / gt (valor mais recente) ou crossAbove / crossBelow (um evento de uma barra: a barra anterior estava do outro lado).

Períodos limitados a 2–200. As condições são combinadas com AND; não há OR — execute duas varreduras para um OR e mescle. Métricas desconhecidas são rejeitadas, então atenha-se à tabela (a lista completa de receitas está em references/condition-cookbook.md).

Screening (screen_symbols)

Argumentos: interval (padrão 4h), conditions (≤ 3), universe (5–100 mais negociados por volume de 24h, padrão 50) OU symbols (≤ 100, explícito), limit (≤ 50 linhas), sortBy volume / change24h / métrica, sortOrder.

Escolha o timeframe do horizonte do usuário: intraday → 1h (ou 15m), swing → 4h, posição → 1d. Amplie universe para 100 quando o usuário quiser small caps ou a primeira varredura encontrou pouco.

Cada linha de resultado carrega os valores da métrica sob seus róticos (values["RSI(14)"]), mais price, change24hPct, volume24hUsd, bias, trend, rsi14, adx14, atrPct, volumeRatio, squeeze. Quando matched > returned, diga isso e ofereça aumentar limit.

Modo de comparação: symbols sem conditions retorna cada símbolo listado como uma tabela — é assim que você responde "compare BTC, ETH e SOL" ou "como minhas cinco moedas se parecem no diário".

Traduza a intenção para condições antes de chamar, e diga o que você traduziu:

• "sobrevendido" → rsi lt 30 (ou 35 para uma rede mais ampla); "profundamente sobrevendido" adicione bbPercentB lt 0
• "sobrecomprado" → rsi gt 70
• "em uma tendência de alta" → priceVsEma gt 0 period 200 + supertrend gt 0
• "com volume crescente" → volumeRatio gt 1.5
• "apertando" → bbWidthPct lt 4 em 4h (menor em 1h) — então ordene por métrica ascendente
• "despencou hoje" → changePct lt -5 period 24 em 1h, ou period 6 em 4h
• "cruzamento dourado" → emaSpread crossAbove 0 period 50 period2 200 em 1d

Backtesting (backtest_condition)

Argumentos: symbol, interval, conditions (mesmo vocabulário), horizons em barras (≤ 4; padrão ≈ 4h / 1d / 3d: 1h → [4, 24, 72], 4h → [6, 18, 42], 1d → [1, 3, 7]).

O estudo roda em toda a fita armazenada — até 1000 velas, então aproximadamente 41 dias em 1h, 166