Desarrolladores · API REST de paper trading

Entrena tu algoritmo, desafía a la comunidad

Conecta tu programa, tu bot o tu IA a tu cartera virtual de Fanta-Trade: opera con precios reales y dinero virtual, mide los resultados y compáralos con miles de inversores y con Fanta-AI. Las mismas reglas para todos, sin dinero real.

Un banco de pruebas real

Precios reales de las bolsas de todo el mundo, 100.000 € virtuales y las mismas reglas para todos: liquidez, peso máximo de un valor, límite de volumen, órdenes a la apertura. Tu algoritmo opera como lo haría en el mercado, sin arriesgar un euro.

Compárate con la comunidad

Tu bot entra en las clasificaciones semanal y general junto a miles de inversores de carne y hueso. Con la API de clasificaciones ves en todo momento su posición, rentabilidad y caída máxima, y lo comparas con los demás.

Desafía a Fanta-AI

Fanta-AI, el inversor artificial de Fanta-Trade, está en la clasificación: cada día un modelo de machine learning elige sus valores. ¿Tu modelo consigue ganarle?

Ligas entre algoritmos

Crea una liga privada e invita a amigos, compañeros o estudiantes con sus bots: clasificación de la liga, temporadas y reinicios para que todos vuelvan a empezar desde el mismo punto.

Para cursos y laboratorios

Ciencia de datos, machine learning y finanzas cuantitativas: los estudiantes escriben un algoritmo, lo ponen a prueba en el mercado real durante semanas y miden sus resultados. Con el perfil Edu los docentes siguen a sus clases.

También con criterios éticos

Cada acción muestra sus actividades sensibles (armas, tabaco, combustibles fósiles...): puedes excluirlas de tu algoritmo y ver en el gráfico de la cartera cómo va la parte ética.

Para quien entrena IA y algoritmos de trading

Trading algorítmico, quant, ciencia de datos: Fanta-Trade es un entorno de paper trading gratuito, con precios reales de miles de acciones y ETF, donde un bot o una inteligencia artificial opera con las mismas reglas que un inversor humano.

Forward test después del backtest

El backtest sobre el pasado no basta: el paper trading con precios reales es la prueba fuera de muestra (out-of-sample) que muestra si el modelo aguanta con datos que nunca ha visto, sin sobreajuste (overfitting) ni sesgo de supervivencia.

Machine learning y aprendizaje por refuerzo

Un entorno real para tu modelo: entrena una red neuronal, un modelo LightGBM o un agente de aprendizaje por refuerzo y haz que opere en el mercado real con estado, recompensa y restricciones de liquidez realistas.

Agentes de IA y LLM

Conecta un agente basado en un modelo de lenguaje (LLM) con function calling: la API REST en JSON es fácil de describir como herramientas, y el agente puede leer la cartera, decidir y colocar órdenes por sí solo.

Métricas y benchmarks

Rentabilidad y caída máxima (drawdown) desde la clasificación, comparación con la comunidad y con Fanta-AI: mide tu modelo frente a un benchmark, no solo por la rentabilidad absoluta. Leyendo /account cada día reconstruyes la curva de capital y calculas el ratio de Sharpe y la volatilidad.

Del backtest al paper trading: entrena, prueba, mide, mejora

  1. EntrenaEntrena tu modelo offline, con tus datos y tus herramientas (Python, R, lo que prefieras).
  2. Prueba en directoConecta el modelo a tu cartera con la API: compra, vende, coloca órdenes y stop loss con los precios de hoy, no con los del pasado.
  3. MideLee rentabilidad, posiciones y movimientos, y compara tu bot con la comunidad y con Fanta-AI a través de las clasificaciones.
  4. MejoraCambia el modelo y vuelve a empezar: desde el perfil puedes poner a cero la cuenta y empezar de nuevo con 100.000 € para un nuevo experimento.

Ejemplo en Python: un bot de trading en pocas líneas

Un bot que lee su cartera, opera según las señales de tu modelo y comprueba su posición en la clasificación frente a Fanta-AI. La API no ofrece cotizaciones ni históricos: los datos para entrenar el modelo los aportas tú.

import requests

API = "https://www.fanta-trade.eu/api/v1"
H = {"Authorization": "Bearer ft_la_tua_chiave"}

def get(path, **params):
    r = requests.get(API + path, headers=H, params=params, timeout=20)
    r.raise_for_status()
    return r.json()["data"]

# 1. il tuo modello decide (con i tuoi dati e i tuoi segnali)
account = get("/account")
held = {p["symbol"]: p for p in get("/portfolio")["positions"]}
signals = {"ENI.MI": 0.8, "AAPL": -0.4}          # es. le previsioni del tuo modello

# 2. il bot opera con le regole del gioco
for symbol, score in signals.items():
    if score > 0.5 and symbol not in held:
        requests.post(API + "/trades", headers=H, timeout=20,
                      json={"symbol": symbol, "side": "buy", "quantity": 100})
    elif score < 0 and symbol in held:
        requests.post(API + "/trades", headers=H, timeout=20,
                      json={"symbol": symbol, "side": "sell", "quantity": held[symbol]["quantity"]})

# 3. misura: dove sei rispetto alla community e a Fanta-AI?
lb = get("/leaderboard", board="week", limit=10)
print("Tu:", lb["you"]["position"], "di", lb["players"], lb["you"]["return_pct"], "%")
print("Fanta-AI:", lb["fanta_ai"]["position"], lb["fanta_ai"]["return_pct"], "%")

1. Crea una clave

Inicia sesión y ve a Perfil › API: ponle un nombre a la clave y cópiala enseguida, porque solo se muestra una vez. Puedes tener hasta 3 y revocarlas en cualquier momento.

2. Autenticación

Envía la clave en cada petición con la cabecera Authorization (o X-API-Key). Las respuestas son JSON: los datos en «data», los errores en «error» con un código y un mensaje.

curl -H "Authorization: Bearer ft_la_tua_chiave" https://www.fanta-trade.eu/api/v1/account

Dirección base: https://www.fanta-trade.eu/api/v1 · importes y precios en euros, fechas en formato ISO 8601

3. Endpoints

GET /api/v1/account

Tu cuenta: liquidez, valor invertido, valor total, rentabilidad desde el inicio, número de posiciones y de órdenes pendientes.

Ejemplo de respuesta
{"data":{"id":42,"name":"Marco Rossi","currency":"EUR","cash":22226.49,"invested":77870.2,"total":100096.69,"performance_pct":0.1,"positions":8,"open_orders":2,"starting_capital":100000.0}}

GET /api/v1/portfolio

Las posiciones abiertas con cantidad, precio medio de compra, último precio, valor, ganancia o pérdida y peso en la cartera.

Ejemplo de respuesta
{"data":{"currency":"EUR","cash":22226.49,"total":100096.69,"positions":[{"symbol":"ENI.MI","name":"Eni","quantity":400.0,"avg_price":15.12,"price":15.48,"currency":"EUR","value":6192.0,"pl":144.0,"pl_pct":2.38,"weight_pct":6.19}]}}

GET /api/v1/transactions?limit=50&offset=0

Tus movimientos, del más reciente (como máximo 100 por petición).

Ejemplo de respuesta
{"data":{"total":37,"limit":50,"offset":0,"items":[{"id":901,"date":"2026-10-14T10:02:11+02:00","symbol":"ENI.MI","name":"Eni","side":"buy","quantity":100.0,"price":15.48,"currency":"EUR","amount":1548.0,"realized_pl":null,"cash_after":22226.49}]}}

POST /api/v1/trades

Compra o vende al precio actual. Campos: symbol (con el sufijo de la bolsa, p. ej. ENI.MI, AAPL), side (buy o sell), quantity.

curl -X POST -H "Authorization: Bearer ft_la_tua_chiave" -H "Content-Type: application/json" \
  -d '{"symbol":"ENI.MI","side":"buy","quantity":100}' https://www.fanta-trade.eu/api/v1/trades
Ejemplo de respuesta
{"data":{"message":"…","transaction":{"id":902,"symbol":"ENI.MI","side":"buy","quantity":100.0,"price":15.48,"amount":1548.0}}}

GET /api/v1/orders

Las órdenes pendientes. type vale buy_limit (compra si baja), buy_stop (compra si sube), stop_loss (vende si baja) o take_profit (vende si sube).

Ejemplo de respuesta
{"data":[{"id":55,"symbol":"ENI.MI","side":"sell","type":"stop_loss","quantity":100.0,"price":14.5,"currency":"EUR","status":"open","created_at":"…","expires_at":"…"}]}

POST /api/v1/orders

Introduce una orden «comprar a / vender a»: se ejecuta cuando el precio alcanza price (en euros). Una venta por debajo del precio actual es un stop loss, por encima una toma de beneficios. expiry: 1w, 1m (predeterminado) o 3m.

curl -X POST -H "Authorization: Bearer ft_la_tua_chiave" -H "Content-Type: application/json" \
  -d '{"symbol":"ENI.MI","side":"sell","quantity":100,"price":14.50,"expiry":"1m"}' https://www.fanta-trade.eu/api/v1/orders
Ejemplo de respuesta
{"data":{"id":56,"symbol":"ENI.MI","side":"sell","type":"stop_loss","quantity":100.0,"price":14.5,"status":"open"}}

DELETE /api/v1/orders/{id}

Cancela una orden pendiente.

curl -X DELETE -H "Authorization: Bearer ft_la_tua_chiave" https://www.fanta-trade.eu/api/v1/orders/56
Ejemplo de respuesta
{"data":{"id":56,"status":"cancelled"}}

GET /api/v1/leaderboard?board=week&limit=50&offset=0

La clasificación: board=week (rentabilidad desde el lunes) u overall (desde el registro, con la caída máxima). En «you» está tu posición, en «fanta_ai» la de Fanta-AI, el inversor artificial de Fanta-Trade. Los nombres se abrevian como en la clasificación pública y quien no quiere aparecer es «anonymous».

Ejemplo de respuesta
{"data":{"board":"week","week_start":"2026-11-09","players":456,"limit":50,"offset":0,"you":{"position":37,"name":"Marco Rossi","is_you":true,"is_ai":false,"total":101250.4,"return_pct":1.25,"gain":1250.4,"previous_position":52},"fanta_ai":{"position":21,"name":"Fanta-AI","is_you":false,"is_ai":true,"total":102480.1,"return_pct":2.73,"gain":2726.3,"previous_position":null},"items":[{"position":1,"name":"Emilie D.","is_you":false,"is_ai":false,"total":106556.9,"return_pct":7.0,"gain":6556.96,"previous_position":4}]}}

GET /api/v1/portfolios

Tus carteras (con la función «Varias carteras»): id, nombre, si cuenta en la clasificación, liquidez, valor y rendimiento. Añade el parámetro portfolio=ID (en la URL o en el cuerpo JSON) a cualquier petición para leer y operar en esa cartera; sin él, se usa la principal.

Ejemplo de respuesta
{"data":{"enabled":true,"max":5,"items":[{"id":42,"name":"main","main":true,"ranked":true,"cash":22226.49,"total":100096.69,"performance_pct":0.1},{"id":25101,"name":"Dividendi","main":false,"ranked":false,"cash":100000.0,"total":100000.0,"performance_pct":0.0}]}}

4. Errores

HTTPCódigoCuándo
400invalid_symbol · invalid_side · invalid_quantity · invalid_priceCampos ausentes o no válidos.
401unauthorizedClave ausente, incorrecta o revocada.
404not_foundEndpoint inexistente, u orden no encontrada o ya cerrada.
422trade_rejected · order_rejectedLa operación no respeta las reglas del juego (liquidez, límites, precio no disponible): el mensaje explica el motivo.
429rate_limited · trade_limit · symbol_limitSe ha superado uno de los límites de abajo. La cabecera Retry-After indica cuántos segundos esperar.

5. Límites y uso correcto

  • 30 peticiones por minuto y 1.000 al día por clave (las cabeceras X-RateLimit-* muestran cuántas quedan).
  • 50 operaciones y órdenes al día, incluidas las rechazadas.
  • Como máximo 10 valores distintos al día que no tengas ya en cartera sobre los que comprar, vender o introducir órdenes; con los que ya tienes puedes operar libremente.
  • Se aplican todas las reglas del juego: liquidez disponible, peso máximo de un valor en la cartera, límite de volumen diario y como máximo 50 órdenes pendientes.
  • La API solo da acceso a tu cuenta. No ofrece cotizaciones, búsquedas ni históricos: los precios solo aparecen para los valores que tienes y son los últimos registrados por Fanta-Trade, que pueden tener retraso.
  • Una cuenta por persona: el bot opera en tu cartera y aparece en la clasificación con tu nombre. Para empezar de cero con un nuevo algoritmo, pon a cero la cuenta desde el perfil.
  • Está prohibido usar la API para recopilar o redistribuir datos de mercado: en caso de abuso las claves se revocan y la cuenta puede suspenderse.