Remora for Freqtrade

Add market risk filtering to your Freqtrade strategies in 30 seconds

No plugins, no dependencies, fail-open safety. Your strategy stays the same.

Remora acts as a simple gate in front of your strategy, blocking entries during high-risk market conditions.

Quick Start

Get your API key → Paste this into your strategy → Block entries when Remora says no

1. Get your API key

export REMORA_API_KEY="your-api-key"

2. Add to your strategy

Add this method to your strategy class:

import os
import requests

def confirm_trade_entry(self, pair: str, **kwargs) -> bool:
    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)
    except Exception:
        return True  # Fail-open

Then block entries when Remora says no:

if not self.confirm_trade_entry(pair):
    dataframe.loc[:, 'enter_long'] = 0

Done. Removing Remora is as simple as deleting these lines.

Examples & Advanced Usage

Complete working examples, caching patterns, and advanced usage available in the Remora Freqtrade repository.

Remora is Not a Freqtrade Plugin

Integration is transparent and auditable. Remora is intentionally not a plugin — it's a simple API call that returns a boolean. Your strategy logic stays exactly the same.

Removing Remora is as simple as deleting a few lines. No lock-in, no dependencies, fully transparent.

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 backtests repository → | Evidence & Results →

Get Started

Start protecting your Freqtrade strategies today. No credit card required.

Get Free API Key API Documentation

Remora Risk Engine