Running Freqtrade Without Market Awareness is Risky

Remora blocks trades during high-risk market conditions - before your strategy enters them.

Your strategy decides what to trade. Remora lets you know if the current market conditions are safe to trade in.

Protect your Freqtrade strategy in 30 seconds

See exactly what to add to your existing strategy (green) vs what you already have (gray)

Step 0: Set your API key
Before running your strategy, set the environment variable:

                    export REMORA_API_KEY="your-api-key-here"
                
Get your free API key at remora-ai.com/signup.php
Step 1: Add Remora to your strategy
Insert the green code blocks into your existing strategy file:

                class MyStrategy(IStrategy):

    # ------------------ EXISTING STRATEGY LOGIC ------------------
    def populate_entry_trend(self, dataframe: DataFrame, metadata: dict) -> DataFrame:
        pair = metadata['pair']

        # Your existing entry conditions...
        # dataframe.loc[:, 'enter_long'] = 1  # example existing logic

        # ------------------ REMORA CHECK ------------------
        if not self.confirm_trade_entry(pair):
            dataframe.loc[:, 'enter_long'] = 0  # REMORA: Skip high-risk trades

        return dataframe

    # ------------------ ADD THIS NEW METHOD ------------------
    def confirm_trade_entry(self, pair: str, **kwargs) -> bool:
        import os
        import requests
        api_key = os.getenv("REMORA_API_KEY")
        headers = {"Authorization": f"Bearer {api_key}"} if api_key else {}

        try:
            r = requests.get(
                "https://remora-ai.com/api/v1/risk",
                params={"pair": pair},
                headers=headers,
                timeout=2.0
            )
            return r.json().get("safe_to_trade", True)  # REMORA: Block entry if market is high-risk
        except Exception:
            return True  # REMORA: Fail-open

                
            
Notes:
Inside your existing populate_entry_trend(), insert the green Remora check just before return dataframe.
After that, add the green confirm_trade_entry() method at the same indentation level as your other strategy methods.
Everything else in your strategy stays unchanged.

Removing Remora is as simple as deleting these lines. No lock-in, fully transparent.

Get Free API Key

What Remora Does for Freqtrade Users

Markets aren't always tradable - high volatility, choppy regimes, and extreme conditions can turn good strategies into losing ones.

Remora monitors real-time market conditions - volatility, regime, risk signals, and sentiment - and tells you if it's safe to trade right now.

Full transparency: Each recommendation comes with clear reasoning. You'll see exactly why a trade is allowed or blocked. No black box, no hidden logic.

Avoids trades during:

High volatility periods
Choppy or unfavourable regimes
Extreme market conditions (fear, panic, bear markets)

Result: Fewer bad trades, reduced drawdowns, and improved risk-adjusted performance - all while keeping your strategy exactly the same.

What Remora Does Not Do

It does not generate signals
It does not optimise your strategy
It does not change your indicators

Remora only answers one question: "Is now a good time to trade at all?"

Proof & Backtesting

Backtests across multiple strategies and market periods show that 30-60% of losing trades occur during high-risk conditions. Remora blocks entries during those periods.

View on GitHub Proven Results

Remora is Not a Freqtrade Plugin

Integration is transparent and auditable - not a black box. Remora is intentionally not a plugin. It's a simple API call that returns a boolean and the reasoning behind each decision, so you can inspect exactly why trades are blocked or allowed.

Your strategy logic stays exactly the same. Removing Remora is as simple as deleting a few lines. No lock-in, no dependencies, fully transparent.

Get Started

Start using Remora with Freqtrade - free, no credit card required.