Ejemplo de payload mínimo

La solicitud válida más pequeña. Los valores por defecto cubren el resto — paper trading, estrategia equilibrada, tamaño de cantidad fija, EMA/MACD/RSI/Bollinger/Ichimoku/VWAP activos.

{
  "name": "My BTC bot",
  "broker": "binance_spot",
  "symbol": "BTCUSDT",
  "quantity": "0.001"
}

Notas de uso

• Endpoint: POST /api/bots con Content-Type: application/json.
• Solo name, broker, symbol y quantity son obligatorios. El resto tiene valores por defecto sensatos.
• Cualquier campo opcional puede omitirse o ponerse a null. Los campos omitidos usan los valores por defecto de la plataforma.
• Campos numéricos como sensibilidad, threshold y stop/take-profit aceptan tanto un número JSON como un string numérico ('0.05'). Los periodos (ema_short_period, etc.) deben ser enteros.
• Pon simulation_mode = true para paper trading. Con simulation_mode = false debes proporcionar credential_id o api_key + secret_key inline (y passphrase en Coinbase).

Campos obligatorios

• name (string) — Nombre de visualización mostrado en tu panel.
• broker (string) — Slug del exchange (p. ej. binance_spot, coinbase, kraken, onchain).
• symbol (string) — Par de trading que el bot analizará y operará (p. ej. BTCUSDT).
• quantity (number) — Tamaño base de la orden usado por el modo de cantidad fija y como respaldo en los demás.

Mercado y flags

• timeframe (string) — Intervalo de velas usado para análisis (p. ej. 1m, 5m, 1h).
• watchlist (array<string>) — Símbolos extra opcionales para monitorear. Se usa junto con only_best_signal.
• chain (string) — Slug de red EVM para bots on-chain. Obligatorio cuando broker es "onchain".
• simulation_mode (boolean) — Flag de paper trading. true = sin órdenes reales, false = trading real.
• only_best_signal (boolean) — Si es true, el bot opera solo el mejor setup entre symbol + watchlist.
• is_minimal (boolean) — Si es true, ejecuta un conjunto reducido de indicadores para ahorrar recursos.

Tamaño de posición

• position_sizing_mode (string) — Uno de fixed_quantity, percent_of_equity, risk_per_trade.
• balance_allocation_pct (number) — Fracción decimal del saldo disponible por trade. La usa percent_of_equity.
• risk_per_trade_pct (number) — Fracción del capital en riesgo por trade. La usa risk_per_trade.
• leverage (integer) — Apalancamiento de futuros. 1 para spot.
• margin_type (string) — Margen de futuros: "isolated" o "cross".
• position_side (string) — "long", "short" u omítelo para usar el predeterminado del broker.

Sensibilidad de señal

• sensitivity_buy (number) — Multiplicador de la fuerza de señal alcista. Mayor = más ávido para entrar.
• sensitivity_sell (number) — Multiplicador de la fuerza de señal bajista. Mayor = más ávido para salir.
• threshold (number) — Fuerza agregada mínima de señal para actuar.
• selling_exponent (number) — Potencia aplicada al score agregado de venta antes del threshold.

Periodos y pesos de indicadores

• ema_short_period (integer) — Ventana corta de EMA (en velas).
• ema_long_period (integer) — Ventana larga de EMA (en velas).
• bollinger_period (integer) — Lookback de Bandas de Bollinger (en velas).
• signal_period (integer) — Periodo de la EMA de la línea de señal de MACD (en velas).
• tenkan_period (integer) — Periodo de Tenkan-sen (Ichimoku).
• kijun_period (integer) — Periodo de Kijun-sen (Ichimoku).
• senkou_span_b_period (integer) — Periodo de Senkou Span B (Ichimoku).
• chikou_span_period (integer) — Periodo de Chikou Span (Ichimoku).
• ema_exponent (number) — Peso aplicado al score de EMA en la señal agregada.
• bollinger_exponent (number) — Peso aplicado al score de Bollinger.
• macd_exponent (number) — Peso aplicado al score de MACD.
• rsi_exponent (number) — Peso aplicado al score de RSI.
• vwap_exponent (number) — Peso aplicado al score de VWAP.
• ichimoku_exponent (number) — Peso aplicado al score de Ichimoku.
• indicator_config (object) — Anulaciones opcionales y detalladas por indicador. Objeto libre.

Stop loss y take profit

• stop_loss_partial (number) — Distancia del stop-loss parcial inicial como fracción decimal (0,05 = 5%).
• stop_loss_lower_half_average (number) — Distancia del stop-loss promedio mitad inferior.
• stop_loss_last (number) — Distancia del stop-loss final.
• stop_loss_trailing_start (number) — Nivel de ganancia en el que se activa el trailing stop.
• stop_loss_trailing_end (number) — Offset del trailing stop una vez activo.
• take_profit_partial (number) — Distancia del take-profit parcial inicial.
• take_profit_lower_half_average (number) — Distancia del take-profit promedio mitad inferior.
• take_profit_last (number) — Distancia del take-profit final.
• take_profit_trailing_start (number) — Nivel de ganancia en el que se activa el trailing take-profit.
• take_profit_trailing_end (number) — Offset del trailing take-profit una vez activo.

Credenciales

• credential_id (string) — ID de una credencial de exchange guardada previamente. Preferida sobre las claves inline.
• api_key (string) — Clave de API inline. Úsala solo cuando credential_id no esté disponible.
• secret_key (string) — Secreto de API inline. Obligatorio junto con api_key.
• passphrase (string) — Obligatorio para trading real en Coinbase.

Vínculos y propiedad

• strategy_id (string) — ID opcional de estrategia guardada para clonar.
• org_id (string) — ID opcional de organización; por defecto, tu cuenta personal.