BTC bot (btc-futures) · todos los endpoints responden application/json (GET).
Los endpoints de macro y operaciones requieren el secret compartido entre bots en un header. Ambos headers equivalen al mismo valor (secret MACRO_TOKEN de la app):
curl -H "X-Bot-Token: $MACRO_TOKEN" https://btc-futures.fly.dev/api/macro curl -H "X-Macro-Token: $MACRO_TOKEN" https://btc-futures.fly.dev/api/operaciones
Cada operación expuesta incluye su mercado para que cualquier bot sepa si el dato es futuros cripto forex metal. En trading-bots-finn.fly.dev existe el mismo contrato (/api/operaciones, /api/macro) con los mercados restantes.
| Ruta | Descripción | Parámetros |
|---|---|---|
/ | Landing (HTML) | — |
/api/state | Estado actual del bot: precio/mark, posición, SL/TP, pesos del modelo | — |
/api/trades | Log completo de operaciones enriquecido (OPEN, ADOPTED, PARTIAL_TP, CLOSE, PROTECT, RECONCILE) con pnl por CLOSE | — |
/api/predictions | Historial de predicciones del modelo | — |
/api/ticks | Últimos ~1440 ticks (≈4 h) para gráfico | — |
/api/klines | Velas BTC. market=p perp público; market=s spot (historia desde 2017) |
interval (1m…1w), limit ≤1500, market p|s, startTime/endTime (ms) |
/api/depth | Clusters de profundidad / liquidez | — |
/api/score | Scorecard: acierto por señal del modelo | — |
/api/stats | Diagnóstico: acierto y retorno medio a ~1 h por dirección | — |
/api/account | Balance y posiciones de la cuenta (testnet) | — |
Velas de 13 instrumentos sin exponer credenciales: cripto, forex e índices. Fuente: sesión cTrader (vía trading-bots-finn) donde aplica + Yahoo Finance como respaldo. Solo lectura, cacheado 60 s.
| Ruta | Descripción | Parámetros |
|---|---|---|
/api/market/pairs | Lista de pares soportados | — |
/api/market/klines | Velas OHLC por par. Con rango usa Yahoo con historia larga (p.ej. 1h/730d ≈17k velas, 1d/10y). 15m/30m son Yahoo (máx 60d) | pair, interval 15m|30m|1h|4h|1d, limit ≤20000, rango (1y, 2y, 5y, 10y, max, 730d…) |
/api/market/pools | Pools de liquidez (libro Binance futuros + pivotes): imanes arriba/abajo, barrido y MSS (solo cripto) | pair (BTC/USD, ETH/USD, SOL/USD) |
/api/market/macro | Sentimiento macro (FRED): VIX y régimen, DXY broad, rendimiento real 10Y, spread 10y-2y, curva y próximo evento de alto impacto | — |
curl -s "https://btc-futures.fly.dev/api/market/pools?pair=BTC/USD" | python3 -m json.tool
# respuesta: {pair, symbol, price, signal, sweep, mss, support, resistance,
# magnets_arriba:[{price,qty}], magnets_abajo:[{price,qty}]}
curl -s "https://btc-futures.fly.dev/api/market/klines?pair=XAU/USD&interval=1h&limit=200" \
| python3 -c "import sys,json;d=json.load(sys.stdin);print(d['pair'],len(d['klines']),'velas')"
# respuesta: {pair, interval, limit, klines:[{t,o,h,l,c,v}]} (t en segundos)
Pares: BTC/USD, ETH/USD, SOL/USD, GBP/JPY, EUR/JPY, USD/JPY, GBP/USD, AUD/JPY, XAU/USD, US500, NAS100, US30, GER40.
| Ruta | Descripción | Respuesta |
|---|---|---|
/api/macro |
Macro FRED cacheado para oro/divisas: Fed funds (DFF), rendimiento real 10Y (DFII10), 10Y/2Y/30Y, T-bill 3M, spread 10Y-2Y (T10Y2Y), breakeven 10Y (T10YIE), índice del dólar broad (DTWEXBGS), VIX (VIXCLS); features derivadas (real_yield_10y, spread_10y2y, breakeven_10y, vix, dxy_broad, vix_regimen, curva_regimen) y próximo evento alto impacto | {series:{DFF, DFII10, …}, features:{real_yield_10y, spread_10y2y, …}, events:[…], next_event:{date, release, dias_restantes}, generado_en} |
/api/operaciones |
Operaciones cerradas de este bot con mercado:"futuros" y PnL calculado — para aprendizaje/calibración multi-bot |
{mercado:"futuros", operaciones:[{event, side, entry, close_price, reason, qty, duration_s, pnl_usd, pnl_pct, …}], predicciones:[…]} |
# Macro para oro y divisas (real yield, DXY, VIX, eventos): curl -s -H "X-Bot-Token: $MACRO_TOKEN" https://btc-futures.fly.dev/api/macro | python3 -m json.tool # Operaciones cerradas (mercado = futuros) para aprender: curl -s -H "X-Bot-Token: $MACRO_TOKEN" https://btc-futures.fly.dev/api/operaciones | python3 -m json.tool # trading-bots-finn expone el mismo contrato con mercados cripto/forex/metal: curl -s -H "X-Bot-Token: $MACRO_TOKEN" https://trading-bots-finn.fly.dev/api/operaciones
Backtest re-calibrado con historia larga (velas H1 servidas por la sesión cTrader de trading-bots-finn, solo lectura). SL/TP reales de configuración y TP modelado a 3×SL. No incluye comisiones ni deslizamiento.
| Par [tf] | Historia (velas/días) | Señales | Acierto total | Acierto últ. 90d | EV estimado (1:3) |
|---|---|---|---|---|---|
| USD/CHF [scalping] | 15.999 / ~666 | 967 | 49.0% | 50.7% | +0.96R |
| XAU/USD [scalping] | 15.999 / ~666 | 2.562 | 58.0% | 80.8% | +1.32R |
| USD/JPY [scalping] | 15.999 / ~666 | 763 | 51.0% | 51.1% | +1.04R |
| SOL/USD [scalping] | 21.999 / ~916 | 1.844 | 37.7% | 51.1% | +0.51R |
| LTC/USD [scalping] | 21.999 / ~916 | 1.780 | 45.2% | 54.1% | +0.81R |
| AUD/JPY [swing] | 15.999 / ~666 | 183 | 51.9% | 47.6% | +1.08R |
Lectura: XAU/USD scalping es el más fuerte (58% total y 80% en los últimos 90 días). Los demás se mantienen en ~50% (EV ≈ +1R con 1:3). SOL/USD es el más irregular: 37.7% en todo el histórico pero 51% reciente. Nota: el filtro de régimen ("rango") no elimina señales en estos pares — el umbral actual queda inerte en ellos.
Endpoint de solo lectura que sirve historia H1 de cualquier par configurado, paginando la sesión cTrader del propio bot (sin segunda conexión, sin coste). Fuente de los datos del backtest anterior.
# Requiere el dashboard token de trading-bots-finn:
curl -s -H "Authorization: Bearer $DASHBOARD_TOKEN" \
"https://trading-bots-finn.fly.dev/api/klines?pair=USD/CHF&dias=900&page=2000" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['par'], len(d['bars']),'velas H1')"
# Parámetros: pair (XAU/USD, USD/JPY, SOL/USD, LTC/USD, AUD/JPY, BTC/USD…), dias, page (velas por página).
# Respuesta: {par, periodo:"H1", dias, velas, bars:[{open,high,low,close,time}]}
La profundidad depende del broker (en la cuenta actual ~666 días para FX/metal y ~916 días para SOL/LTC).