Exemplo de payload mínimo

A menor requisição válida. Os padrões cuidam do resto — paper trading, estratégia equilibrada, tamanho de quantidade fixa, EMA/MACD/RSI/Bollinger/Ichimoku/VWAP ativos.

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

Notas de uso

• Endpoint: POST /api/bots com Content-Type: application/json.
• Apenas name, broker, symbol e quantity são obrigatórios. Todos os outros campos têm padrões razoáveis.
• Qualquer campo opcional pode ser omitido ou definido como null. Campos omitidos recaem nos padrões da plataforma.
• Campos numéricos como sensibilidade, threshold e stop/take-profit aceitam tanto número JSON quanto string numérica ('0.05'). Períodos (ema_short_period etc.) precisam ser inteiros.
• Use simulation_mode = true para paper trading. Com simulation_mode = false é preciso fornecer credential_id ou api_key + secret_key inline (e passphrase na Coinbase).

Campos obrigatórios

• name (string) — Nome de exibição mostrado no seu painel.
• broker (string) — Slug da corretora (ex.: binance_spot, coinbase, kraken, onchain).
• symbol (string) — Par de trading que o bot vai analisar e operar (ex.: BTCUSDT).
• quantity (number) — Tamanho base da ordem usado pelo modo de quantidade fixa e como fallback nos demais.

Mercado & flags

• timeframe (string) — Intervalo dos candles usado para análise (ex.: 1m, 5m, 1h).
• watchlist (array<string>) — Símbolos extras opcionais para monitorar. Usado junto com only_best_signal.
• chain (string) — Slug da rede EVM para bots on-chain. Obrigatório quando broker é "onchain".
• simulation_mode (boolean) — Flag de paper trading. true = sem ordens reais, false = trading real.
• only_best_signal (boolean) — Se true, o bot opera apenas o melhor setup entre symbol + watchlist.
• is_minimal (boolean) — Se true, executa um conjunto reduzido de indicadores para economizar recursos.

Tamanho da posição

• position_sizing_mode (string) — Um de fixed_quantity, percent_of_equity, risk_per_trade.
• balance_allocation_pct (number) — Fração decimal do saldo disponível por trade. Usada por percent_of_equity.
• risk_per_trade_pct (number) — Fração do patrimônio em risco por trade. Usada por risk_per_trade.
• leverage (integer) — Alavancagem de futuros. 1 para spot.
• margin_type (string) — Margem de futuros: "isolated" ou "cross".
• position_side (string) — "long", "short" ou omita para usar o padrão da corretora.

Sensibilidade do sinal

• sensitivity_buy (number) — Multiplicador da força do sinal de alta. Maior = mais ávido para entrar.
• sensitivity_sell (number) — Multiplicador da força do sinal de baixa. Maior = mais ávido para sair.
• threshold (number) — Força agregada mínima do sinal para agir.
• selling_exponent (number) — Potência aplicada ao score agregado de venda antes do threshold.

Períodos & pesos dos indicadores

• ema_short_period (integer) — Janela curta da EMA (em candles).
• ema_long_period (integer) — Janela longa da EMA (em candles).
• bollinger_period (integer) — Lookback das Bandas de Bollinger (em candles).
• signal_period (integer) — Período da EMA da linha de sinal do MACD (em candles).
• tenkan_period (integer) — Período da Tenkan-sen (Ichimoku).
• kijun_period (integer) — Período da Kijun-sen (Ichimoku).
• senkou_span_b_period (integer) — Período da Senkou Span B (Ichimoku).
• chikou_span_period (integer) — Período da Chikou Span (Ichimoku).
• ema_exponent (number) — Peso aplicado ao score da EMA no sinal agregado.
• bollinger_exponent (number) — Peso aplicado ao score de Bollinger.
• macd_exponent (number) — Peso aplicado ao score do MACD.
• rsi_exponent (number) — Peso aplicado ao score do RSI.
• vwap_exponent (number) — Peso aplicado ao score do VWAP.
• ichimoku_exponent (number) — Peso aplicado ao score do Ichimoku.
• indicator_config (object) — Sobrescritas opcionais e detalhadas por indicador. Objeto livre.

Stop loss & take profit

• stop_loss_partial (number) — Distância do stop-loss parcial inicial como fração decimal (0,05 = 5%).
• stop_loss_lower_half_average (number) — Distância do stop-loss da média da metade inferior.
• stop_loss_last (number) — Distância do stop-loss final.
• stop_loss_trailing_start (number) — Nível de lucro em que o trailing stop é ativado.
• stop_loss_trailing_end (number) — Offset do trailing stop após ativado.
• take_profit_partial (number) — Distância do take-profit parcial inicial.
• take_profit_lower_half_average (number) — Distância do take-profit da média da metade inferior.
• take_profit_last (number) — Distância do take-profit final.
• take_profit_trailing_start (number) — Nível de lucro em que o trailing take-profit é ativado.
• take_profit_trailing_end (number) — Offset do trailing take-profit após ativado.

Credenciais

• credential_id (string) — ID de uma credencial de corretora salva anteriormente. Preferida em relação às chaves inline.
• api_key (string) — Chave de API inline. Use apenas quando credential_id não estiver disponível.
• secret_key (string) — Segredo de API inline. Obrigatório junto com api_key.
• passphrase (string) — Obrigatório para trading real na Coinbase.

Vínculos & propriedade

• strategy_id (string) — ID opcional de uma estratégia salva para clonar.
• org_id (string) — ID opcional de organização; padrão é sua conta pessoal.