--- name: signal-engine-production-d88d.up.railway.app description: signal-engine-production-d88d.up.railway.app provides discrete, single-shot trading signals for four crypto assets (BTC, ETH, SOL, DOGE) across four strategy types: VWAP reversion, EMA 5 breakout, RSI reversion swing, and RSI 7 extremes. Each signal response includes direction (long/short/null), confidence score, take-profit and stop-loss percentages, hold time, and a reasoning string. The host does not execute trades, stream prices, or support assets outside the four listed symbols. host: signal-engine-production-d88d.up.railway.app --- # signal-engine-production-d88d.up.railway.app Signal Engine is a signal-generation service targeting short-term crypto trading agents that need pre-computed, strategy-specific entry signals before placing or evaluating a trade. It exposes four distinct technical strategies as separate endpoints, each returning a structured signal payload with risk parameters. It serves agents that need to select a strategy by ID and symbol, then act on the returned direction and levels. It does not provide portfolio management, order routing, historical backtests, or multi-asset coverage beyond BTC, ETH, SOL, and DOGE. ## When to use this host Use this host when an agent needs a structured, ready-to-act trading signal for BTC, ETH, SOL, or DOGE from one of four specific short-term strategies (VWAP reversion, EMA 5 breakout, RSI reversion swing, RSI 7 extremes). It is appropriate for pre-trade decision logic where the agent selects a strategy by ID and needs direction, score, and risk levels in a single call. Do not use this host for: fused multi-strategy signals (the skills themselves reference a /v1/signal/{symbol} endpoint not exposed here); assets outside BTC, ETH, SOL, DOGE; historical signal lookups or backtesting; continuous price streaming; order execution; or long-term position sizing. For price data or order routing, use a dedicated market-data or exchange-connectivity host instead. ## Capabilities ### VWAP Reversion Signals Returns mean-reversion signals based on VWAP deviation for a given asset, including long/short direction, confidence score, TP/SL percentages, hold time, and reasoning. Suited for short-term reversion entries. - **`fetch-vwap-reversion-signal`** — Returns a live VWAP reversion trading signal for BTC, ETH, SOL, or DOGE, including direction (long/short), confidence score, take-profit/stop-loss percentages, hold time, and reasoning. ### EMA 5 Breakout Signals Returns directional breakout signals based on EMA 5 logic, indicating whether a breakout condition is currently active along with score, TP/SL levels, and expected hold duration. - **`fetch-ema5-breakout-signal`** — Returns the current EMA 5 breakout trading signal (long/short/null) with stop-loss, take-profit, hold time, and reasoning for a given crypto asset. ### RSI Reversion Swing Signals Returns swing trade signals derived from RSI reversion logic, providing entry direction, confidence score, TP/SL targets, hold time, and a human-readable rationale. - **`fetch-rsi-reversion-swing-signal`** — Returns an RSI reversion swing trading signal (long/short/null) for BTC, ETH, SOL, or DOGE, including score, take-profit/stop-loss percentages, hold time, and reasoning. ### RSI 7 Extremes Signals Returns signals triggered by RSI 7 extreme readings (overbought/oversold), including score, stop-loss, take-profit, and hold time when a signal condition is met. - **`fetch-rsi7-extremes-signal`** — Returns an RSI 7 extremes trading signal (long/short/null) for a supported crypto asset, including score, stop-loss, take-profit, and hold time when a signal is present. ## Workflows ### Multi-Strategy Signal Consensus *Use when an agent needs to compare signals across multiple strategies for the same asset before committing to a trade direction, reducing reliance on any single indicator.* 1. **`fetch-vwap-reversion-signal`** — Fetch the VWAP reversion signal for the target asset to get mean-reversion direction and confidence. 2. **`fetch-ema5-breakout-signal`** — Fetch the EMA 5 breakout signal for the same asset to check whether a trend-following breakout is active. 3. **`fetch-rsi-reversion-swing-signal`** — Fetch the RSI reversion swing signal to add a third directional read based on RSI-based swing logic. 4. **`fetch-rsi7-extremes-signal`** — Fetch the RSI 7 extremes signal to check for extreme overbought/oversold conditions that may confirm or contradict the other signals. ## Skill reference ### `fetch-vwap-reversion-signal` **VWAP Reversion Signal** — Returns a VWAP reversion trading signal for a given crypto asset, including direction (long/short), confidence score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs a short-term mean-reversion trade signal based on VWAP deviation for BTC, ETH, SOL, or DOGE, including entry direction, risk levels, and expected hold duration. *Not for:* Do not use for trend-following or breakout strategies; use ema_5_breakout or rsi_7_extremes strategy endpoints instead. Not suitable for assets outside BTC, ETH, SOL, DOGE. **Inputs:** - `strategy_id` (string, required) — Strategy identifier (path parameter). Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker (path parameter). Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns a VWAP reversion signal object with direction (short), confidence score (100), tp_pct (0.8), sl_pct (1.2), hold_time_sec (360), reasoning text, context_source, and related endpoint suggestions. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/vwap_reversion/SOL` --- ### `fetch-vwap-reversion-signal` **BTC VWAP Reversion Signal** — Returns a VWAP reversion trading signal for a given crypto asset, including direction, confidence score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs a VWAP-based mean-reversion trade signal for BTC, ETH, SOL, or DOGE, including entry direction, score, TP/SL levels, and hold duration before placing or evaluating a trade. *Not for:* Do not use for fused multi-strategy signals across all strategies; use /v1/signal/{symbol} instead. Not suitable for long-term position sizing or non-VWAP strategies. **Inputs:** - `strategy_id` (string, required) — Strategy identifier as a path parameter. Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker as a path parameter. Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns a VWAP reversion signal object for BTC with direction (short), score (94.74), tp_pct, sl_pct, hold_time_sec, reasoning, and related endpoint links. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/vwap_reversion/BTC` --- ### `fetch-ema5-breakout-signal` **EMA 5 Breakout Signal** — Returns the current EMA 5 breakout trading signal (long/short/null) with stop-loss, take-profit, and hold time for a given crypto asset. *Use when:* Use when an agent needs to check whether a live EMA 5 breakout signal is active for BTC, ETH, SOL, or DOGE before deciding to enter or skip a trade. *Not for:* Do not use for RSI or VWAP-based signals; use the rsi_7_extremes, rsi_reversion_swing, or vwap_reversion strategy endpoints instead. Not suitable for historical signal lookups. **Inputs:** - `strategy_id` (string, required) — Strategy identifier passed as a path parameter. Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker passed as a path parameter. Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns strategy_id and symbol echoed back, with signal=null and reason='no_signal' when no breakout is detected; when active, returns signal direction plus score, sl_pct, tp_pct, hold_time_sec, and reasoning. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/ema_5_breakout/BTC` --- ### `fetch-ema5-breakout-signal` **EMA 5 Breakout Signal** — Returns the current EMA 5 breakout trading signal for a given crypto asset, including direction, confidence score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs a short-term directional trading signal based on EMA 5 breakout logic for BTC, ETH, SOL, or DOGE, including entry confidence, TP/SL levels, and recommended hold duration. *Not for:* Do not use for fused multi-strategy signals across all strategies — use /v1/signal/{symbol} instead. Not suitable for assets outside BTC, ETH, SOL, DOGE. **Inputs:** - `strategy_id` (string, required) — Strategy identifier (path parameter). Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker (path parameter). Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns a JSON object with signal direction (long/short/none), confidence score, TP/SL percentages, 300-second hold time, plain-text reasoning, and related endpoint suggestions for SOL using the EMA 5 breakout strategy. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/ema_5_breakout/SOL` --- ### `fetch-rsi-reversion-swing-signal` **RSI Reversion Swing Signal** — Returns a live RSI-based swing trading signal for a given crypto asset, including direction, confidence score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs an actionable swing trade signal for BTC, ETH, SOL, or DOGE based on the RSI Reversion strategy, including entry direction, TP/SL levels, and hold duration. *Not for:* Do not use for fused multi-strategy signals across all strategies; use the /v1/signal/{symbol} endpoint instead. Not suitable for assets outside BTC, ETH, SOL, DOGE. **Inputs:** - `strategy_id` (string, required) — Strategy identifier (path parameter). Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker (path parameter). Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns a signal object with direction (short), RSI-based confidence score, 1% TP, 1.5% SL, 300-second hold time, reasoning text, and related endpoint links for SOL. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/rsi_reversion_swing/SOL` --- ### `fetch-ema5-breakout-signal` **EMA 5 Breakout Signal** — Returns the current EMA 5 breakout trading signal (long/short/null) with stop-loss, take-profit, hold time, and reasoning for a given crypto asset. *Use when:* Use when an agent needs to check whether a current EMA 5 breakout condition exists for BTC, ETH, SOL, or DOGE before entering a trade, including signal score, stop-loss/take-profit percentages, and expected hold duration. *Not for:* Do not use for non-breakout strategies such as RSI or VWAP reversion — use the rsi_7_extremes, rsi_reversion_swing, or vwap_reversion strategy endpoints instead. Not suitable for assets outside BTC, ETH, SOL, DOGE. **Inputs:** - `strategy_id` (string, required) — Strategy identifier as a path parameter. Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker as a path parameter. Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns strategy_id, symbol, and either a signal ('long'/'short') with score, sl_pct, tp_pct, reasoning, hold_time_sec, and strategy_name, or signal=null with a reason string when no breakout condition is met. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/ema_5_breakout/ETH` --- ### `fetch-rsi-reversion-swing-signal` **Signal Engine RSI Reversion Swing** — Returns the current RSI reversion swing trade signal (long/short/none) for BTC, ETH, SOL, or DOGE, including confidence score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs a discrete directional trade signal for a crypto asset based on RSI reversion logic, including entry confidence, TP/SL targets, and a human-readable rationale before placing or evaluating a swing trade. *Not for:* Do not use for fused multi-strategy signals across all strategies — use /v1/signal/{symbol} instead. Not suitable for continuous price streaming or order execution. **Inputs:** - `strategy_id` (string, required) — Strategy identifier, must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. Passed as a path parameter. - `symbol` (string, required) — Crypto asset ticker to evaluate. Must be one of: BTC, ETH, SOL, DOGE. Passed as a path parameter. **Returns:** Returns a JSON object with signal='short', RSI-based score, tp_pct=1.0, sl_pct=1.5, hold_time_sec=300, a reasoning string, and related endpoint suggestions. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/rsi_reversion_swing/BTC` --- ### `fetch-rsi-reversion-swing-signal` **RSI Reversion Swing Signal** — Returns an RSI reversion swing trading signal (long/short/null) for BTC, ETH, SOL, or DOGE, including score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs a discrete RSI-based swing trade signal for a supported crypto asset, including entry direction, confidence score, TP/SL levels, and a human-readable reasoning string before placing or evaluating a trade. *Not for:* Do not use for fused multi-strategy signals across all strategies — use /v1/signal/{symbol} instead. Not suitable for assets outside BTC, ETH, SOL, DOGE. **Inputs:** - `strategy_id` (string, required) — Strategy identifier (path parameter). Must be 'rsi_reversion_swing' for this endpoint. - `symbol` (string, required) — Crypto asset ticker (path parameter). One of: BTC, ETH, SOL, DOGE. **Returns:** Returns a signal object with direction ('short'), score (44.16), tp_pct (1.0), sl_pct (1.5), hold_time_sec (300), reasoning string, context_source, and related endpoint suggestions; signal is null with a reason field when no setup is present. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/rsi_reversion_swing/ETH` --- ### `fetch-rsi7-extremes-signal` **RSI 7 Extremes Signal** — Returns an RSI 7 extremes trading signal (long/short/null) for a supported crypto asset, including score, stop-loss, take-profit, and hold time when a signal is present. *Use when:* Use when an agent needs a discrete trade signal for BTC, ETH, SOL, or DOGE based on the RSI 7 extremes strategy, including entry score, sl_pct, tp_pct, and hold_time_sec before placing or evaluating a trade. *Not for:* Do not use for assets outside BTC, ETH, SOL, DOGE, or for strategies other than rsi_7_extremes (use the appropriate strategy_id endpoint instead). Not suitable for continuous streaming price data. **Inputs:** - `strategy_id` (string, required) — Strategy identifier as a path parameter. Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker as a path parameter. Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns strategy_id, symbol, a null signal, and reason='no_signal' when no trade condition is met; returns signal='long'/'short' with score, sl_pct, tp_pct, reasoning, and hold_time_sec when a signal is active. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/rsi_7_extremes/DOGE` --- ### `fetch-vwap-reversion-signal` **VWAP Reversion Signal** — Returns a live VWAP reversion trading signal for BTC, ETH, SOL, or DOGE, including direction (long/short), confidence score, take-profit/stop-loss percentages, hold time, and reasoning. *Use when:* Use when an agent needs a single-shot VWAP reversion trade signal for a supported crypto asset, including entry direction, TP/SL levels, and hold duration before placing or evaluating a trade. *Not for:* Do not use for fused multi-strategy signals across all strategies — use the /v1/signal/{symbol} endpoint instead. Not suitable for continuous streaming price feeds or assets outside BTC, ETH, SOL, DOGE. **Inputs:** - `strategy_id` (string, required) — Strategy identifier (path parameter). Must be one of: ema_5_breakout, rsi_7_extremes, rsi_reversion_swing, vwap_reversion. - `symbol` (string, required) — Crypto asset ticker (path parameter). Must be one of: BTC, ETH, SOL, DOGE. **Returns:** Returns a VWAP reversion signal object with direction (short), score (100), tp_pct (0.8), sl_pct (1.2), hold_time_sec (360), reasoning text, context_source, and related endpoint suggestions. **Example:** `GET https://signal-engine-production-d88d.up.railway.app/v1/arena/vwap_reversion/ETH` ---