# Freqtrade Review en Español: Cómo instalar tu bot de trading (Guía para devs)

Canonical URL: https://luisalejandro.org/blog/posts/freqtrade-review-en-espanol-como-instalar-tu-bot-de-trading-guia-para-devs

Published: 2025-08-11

Categories: Trading Algorítmico

Es común hoy en día meterse en conversaciones sobre crypto y encontrarse a alguien preguntando por el "bot mágico" que lo va a hacer millonario mientras duerme. Si estás buscando eso, este no es tu post. Cierra la pestaña y sigue buscando, con suerte. Pero si eres developer, te gusta meter las manos en el código y entiendes que un *passive income* se construye con cabeza y no con humo, entonces quédate. Hoy vamos a hacer una **freqtrade review** a fondo, una herramienta que, para nosotros los que programamos, es un caramelo.

[Freqtrade](https://www.freqtrade.io/en/stable/) es un bot de trading de criptomonedas, pero con una diferencia clave: es software libre, escrito en Python, y tú tienes el control absoluto. No es una caja negra que te cobra una suscripción mensual como 3Commas. Aquí no hay promesas vacías, solo código que puedes auditar, modificar y adaptar a tu antojo. Es una navaja suiza para el trading algorítmico, y lo mejor de todo, es gratis. Funciona conectándose a tu exchange a través de una API y ejecuta las estrategias que tú le programas. Simple y poderoso.

Pero antes de que te emociones y conectes la tarjeta de crédito, déjame ser muy claro, y esto es lo más importante que leerás hoy: la clave del éxito aquí no es la codicia, es la paciencia. La filosofía es **probar, probar y volver a probar**. Primero se testea en el pasado (backtesting), luego se simula en tiempo real sin dinero (dry-run), y solo cuando estás seguro, pones dinero real. Para visualizar este proceso disciplinado, imagina el flujo de trabajo que seguiremos.



<span class="figure figure-right-40" data-figure-src="https://cdn.cosmicjs.com/d0f28da0-7655-11f0-9e3b-31d18aecc798-a-clean-and-modern-flowchart-diagram-with-three-ma-1754873923134.jpg" data-figure-href="https://imgix.cosmicjs.com/d0f28da0-7655-11f0-9e3b-31d18aecc798-a-clean-and-modern-flowchart-diagram-with-three-ma-1754873923134.jpg" data-figure-alt="A clean and modern flowchart diagram with three main steps. Step 1 is labeled 'Backtesting' with a historical data icon. An arrow leads to Step 2, labeled 'Dry-Run' with a simulation icon. A final arrow points to Step 3, labeled 'Live Trading' with a rocket icon. The style is minimalist, using a tech-blue and dark gray color palette."></span>

<!-- Uploaded to Cosmic CDN -->

<!-- Generated image metadata: a-clean-and-modern-flowchart-diagram-with-three-ma-1754873923134.json -->

## Antes de Empezar: ¿Qué Necesitas?

Si le tienes miedo a la terminal, esto puede que te abrume un poco. Para **instalar Freqtrade** y sacarle provecho, necesitas sentirte cómodo con algunas cosas básicas del mundo developer:

1.  **La línea de comandos:** Sabes moverte por directorios, ejecutar scripts y no te asusta una pantalla negra.
2.  **Docker:** Entiendes qué es un contenedor y por qué nos facilita la vida. Si no, la [documentación oficial de Docker](https://docs.docker.com/get-started/) es tu amiga.
3.  **JSON:** Sabes leer y editar un archivo de configuración en formato JSON.
4.  **Python (básico):** No necesitas ser un gurú, pero si quieres crear tus propias estrategias, debes entender la sintaxis básica de Python.

Si cumples con esto, estás del otro lado. Esto es un proyecto para nosotros, la comunidad de software.

## Paso 1: Instalación con Docker (La Vía Rápida)

Olvídate de instalar dependencias y pelearte con versiones de Python. Docker nos soluciona esto en dos patadas. Lo primero es crear la estructura de directorios que usará el bot.

```bash
# Descargamos el docker-compose.yml oficial
curl https://raw.githubusercontent.com/freqtrade/freqtrade/stable/docker-compose.yml -o docker-compose.yml

# Creamos el directorio para los datos del usuario
docker-compose run --rm freqtrade create-userdir

# Creamos una configuración de ejemplo para empezar
docker-compose run --rm freqtrade new-config --config user_data/config.json
```

¡Listo! Con esos tres comandos ya tienes Freqtrade instalado y una carpeta `user_data` con todo lo necesario: estrategias de ejemplo, configuraciones y espacio para tus datos. El resultado debería ser una estructura de directorios limpia y organizada como esta:



<span class="figure figure-right-40" data-figure-src="https://cdn.cosmicjs.com/d136c290-7655-11f0-9e3b-31d18aecc798-a-clean-screenshot-of-a-computer-terminal-with-a-d-1754873947198.jpg" data-figure-href="https://imgix.cosmicjs.com/d136c290-7655-11f0-9e3b-31d18aecc798-a-clean-screenshot-of-a-computer-terminal-with-a-d-1754873947198.jpg" data-figure-alt="A clean screenshot of a computer terminal with a dark theme. The output of the 'tree user_data' command is displayed, showing a clear directory structure with subfolders like 'backtest_results', 'data', 'hyperopts', and 'strategies'. The text in the terminal is crisp and easy to read."></span>

<!-- Uploaded to Cosmic CDN -->

<!-- Generated image metadata: a-clean-screenshot-of-a-computer-terminal-with-a-d-1754873947198.json -->

## Paso 2: El Corazón del Bot - El `config.json`

Ahora viene la parte divertida: configurar el cerebro de nuestro bot. Abre el archivo `user_data/config.json`. Aquí es donde le dices **cómo usar Freqtrade**. Hay muchas opciones, pero estas son las cruciales para empezar:

```json
{
    "max_open_trades": 3,
    "stake_currency": "USDT",
    "stake_amount": 100,
    "dry_run": true,
    "exchange": {
        "name": "binance",
        "key": "TUS_DATOS_AQUI",
        "secret": "TUS_DATOS_AQUI",
        "pair_whitelist": [
            "BTC/USDT",
            "ETH/USDT"
        ]
    },
    "strategy": "SampleStrategy"
}
```

Vamos a desglosar este **freqtrade config json example**:

*   `"max_open_trades"`: ¿Cuántas operaciones puede tener abiertas al mismo tiempo? Empieza con un número bajo.
*   `"stake_currency"`: La moneda con la que vas a operar (USDT, BTC, etc.).
*   `"stake_amount"`: ¿Cuánto dinero usará por cada operación?
*   `"dry_run": true`: **¡ESTO ES OBLIGATORIO AL PRINCIPIO!** El bot simulará las operaciones sin usar dinero real. No cambies esto a `false` hasta que hayas hecho muchas pruebas.
*   `"exchange"`: Aquí configuras tu exchange. Freqtrade es compatible con los grandes como Binance, Kraken, KuCoin, etc. Necesitarás tus claves API. Si usas Binance, [aquí explican cómo crearlas](https://www.binance.com/es/support/faq/como-crear-claves-api-e70865d423b94595951d3821966236b3). En `"pair_whitelist"` pones la lista de pares que quieres que el bot vigile.
*   `"strategy"`: El nombre de la estrategia que vas a usar. Por ahora, dejemos la que viene de ejemplo.

## Paso 3: Probando la Estrategia - El Backtesting

Aquí es donde la magia ocurre y donde te ahorras un montón de dinero. El [backtesting](https://www.freqtrade.io/en/stable/backtesting/) es, simplemente, simular tu estrategia con datos históricos del mercado. Es como subir a tu estrategia a una máquina del tiempo para ver cómo se habría comportado en el pasado. Si una estrategia pierde dinero en los últimos 3 años de datos, ¿por qué crees que va a ganar mañana?

Primero, necesitamos descargar esos datos históricos.

```bash
# Descarga los datos para los pares en tu config.json
# Para velas de 5 minutos y 1 hora, de los últimos 30 días
docker-compose run --rm freqtrade download-data --timeframes 5m 1h --days 30
```

Una vez que tienes los datos, puedes correr el backtest.

```bash
# Ejecuta el backtesting sobre los datos que descargaste
docker-compose run --rm freqtrade backtesting --strategy SampleStrategy
```

La terminal te mostrará una tabla detallada con las ganancias o pérdidas por par, el número de trades y la duración promedio. Analiza esto con calma. ¿La estrategia es rentable? ¿Tiene caídas (drawdowns) muy grandes? ¿Funciona bien en todos los pares? Esta es tu herramienta más valiosa, y el resultado se verá similar a este informe detallado.



<span class="figure figure-right-40" data-figure-src="https://cdn.cosmicjs.com/d182e6c0-7655-11f0-9e3b-31d18aecc798-a-stylized-representation-of-a-freqtrade-backtesti-1754873969318.jpg" data-figure-href="https://imgix.cosmicjs.com/d182e6c0-7655-11f0-9e3b-31d18aecc798-a-stylized-representation-of-a-freqtrade-backtesti-1754873969318.jpg" data-figure-alt="A stylized representation of a Freqtrade backtesting report in a terminal. It shows a table with columns like 'Pair', 'Trades', 'Avg Profit %', 'Tot Profit BTC'. The final 'TOTAL' row is highlighted, showing positive overall profit. The aesthetic is clean, modern, and data-focused, with a dark background and syntax highlighting colors."></span>

<!-- Uploaded to Cosmic CDN -->

<!-- Generated image metadata: a-stylized-representation-of-a-freqtrade-backtesti-1754873969318.json -->

## El Siguiente Nivel: Dry-Run y Más Allá

Cuando encuentres una estrategia que te da buenos resultados en el backtesting, el siguiente paso es dejarla correr en modo `dry_run: true`. El bot se conectará al exchange en tiempo real, te notificará por Telegram (si lo configuras) cuándo compraría o vendería, pero sin ejecutar la orden. Es la prueba de fuego final.

Si quieres ir todavía más lejos, Freqtrade incluye una herramienta llamada [Hyperopt](https://www.freqtrade.io/en/stable/hyperopt/). Básicamente, usa machine learning para probar miles de combinaciones de los parámetros de tu estrategia (los valores de los indicadores, los stop-loss, etc.) y te dice cuáles son los óptimos. Es una locura de poder, pero requiere más tiempo y conocimiento.

En resumen, y para que quede claro: **Freqtrade en español** es una herramienta para gente paciente y metódica. No es una maquinita de imprimir dinero. Es un proyecto de ingeniería, un desafío técnico que, si lo haces bien, puede darte una satisfacción enorme y un ingreso extra.

¿Y tú, compañero? ¿Ya has experimentado con bots de trading? ¿Qué te parece la filosofía del software libre aplicada a las finanzas? ¡Te leo en los comentarios