Negociação real

A negociação real executa uma estratégia com dados de mercado em tempo real e pode enviar ordens reais a uma conta de corretora conectada quando a conta, as permissões e a política beta atual permitem o modo de negociação real.

Use a negociação real somente depois de entender a estratégia, revisar um backtest e observar seu comportamento na simulação. Solicitar o modo de negociação real não confirma que ele está ativo: examine o modo efetivo e o estado da assinatura retornados.

Script da estratégia

Os scripts de estratégias ao vivo usam dados de mercado em tempo real. O script deve ser determinístico, explícito nas referências a tickers e conservador no dimensionamento de posições, pois as intenções emitidas podem se tornar ordens simuladas ou ordens reais na corretora, conforme o modo selecionado.

Use literais completos de ticker quando a estratégia precisar negociar um mercado específico, por exemplo BINANCE:BTC/USDT. Use context['ticker'] quando a mesma lógica precisar executar em todo o universo ao vivo selecionado.

Scripts ao vivo devem evitar premissas válidas apenas em dados históricos. Verifique tamanho das ordens, alavancagem, tipo de mercado e comportamento de saída antes de habilitar a negociação real.

No modo tick, use o valor escalar price ou get_data(ticker).price para a observação atual do mercado. Uma avaliação por tick não injeta as variáveis soltas open, high, low, close ou volume, e um snapshot de get_data(ticker) sem qualificação não tem séries de candles. Solicite explicitamente o histórico de candles com um período, como em get_data(ticker, "1m").close.

Para lógica vetorial MTF, calcule os indicadores no histórico de candles solicitado e una o resultado calculado com align_timeframe(..., base_time=time) antes de combiná-lo com a linha do tempo da estratégia. Leituras escalares no fluxo de ticks, como get_data(ticker, "1m").close[-1], já se referem ao histórico mais recente disponível e não precisam dessa união vetorial.

Para estratégias Polymarket, use variáveis ao vivo que correspondam aos dados de mercados de previsão:

• price: preço de probabilidade mais recente em tempo real
• get_data(context['ticker']).price: a mesma observação atual do resultado por meio de um snapshot de mercado
• get_data(context['ticker']).book: livro de ofertas em tempo real, quando disponível
• get_data(context['ticker'], '1m').close: histórico de candles concluídos, formado por negociações ao vivo

Estratégias Polymarket aceitam negociação simulada e real. Elas não aceitam backtests.

Modelos de estratégias

Os modelos ao vivo são pontos de partida para execução. Eles geram lógica de estratégia para simulação ou negociação real, mas o usuário ainda precisa confirmar símbolos, período gráfico, dimensionamento, alavancagem e permissões da corretora.

Uma estratégia pode selecionar no máximo 20 símbolos no universo. O mesmo limite se aplica a todos os modelos de múltiplos símbolos e às estratégias Custom DSL. Modelos com papéis nomeados, como as duas pernas de Pair Trading ou Arbitrage, coletam esses papéis separadamente em vez de impor um limite de universo menor.

O Free inclui uma estratégia simulada ativa e nenhuma execução no modo de negociação real. O Pro inclui três estratégias simuladas e três reais ativas. O Ultra inclui cinco de cada e é obrigatório para avaliação por eventos em nível de tick. Todos os planos usam o mesmo caminho de execução do Broker; o Ultra não recebe prioridade na execução de ordens. Consulte Planos de assinatura.

Ao escolher um modelo para uso real:

• Comece com simulação, a menos que a estratégia já tenha sido validada.
• Prefira lógicas simples de sinal, grid, DCA ou pares antes de avançar para universos maiores.
• Considere modelos transversais e de arbitragem como mais arriscados, pois coordenam múltiplos símbolos ou plataformas.
• Use Custom DSL somente quando o comportamento do script e os controles de risco estiverem totalmente compreendidos.

Requisitos

• Uma conta de corretora conectada
• Chave de API ou autorização de carteira correta
• Permissões de negociação habilitadas
• Saques desabilitados nas chaves de API
• Restrição por IP confiável quando a corretora oferecer esse recurso
• Conta com saldo

Os recursos ao vivo estão em beta. A elegibilidade e os limites de uso são avaliados no momento da solicitação; confie nos escopos, respostas e erros estruturados retornados em vez de uma cota fixa.

Para configurar uma corretora, consulte Corretoras compatíveis.

Antes de começar

Confirme:

• conta de corretora
• símbolo e tipo de mercado
• lado e comportamento da posição
• tamanho da ordem
• alavancagem
• tipo de ordem
• comportamento na simulação
• permissões da chave de API

Começar com pouco

Use primeiro um tamanho que você se sinta confortável em testar. Acompanhe os primeiros sinais e ordens reais antes de aumentar o tamanho.

Gerenciar o ciclo de vida

Trate assinar, pausar, retomar, trocar de modo e cancelar a assinatura como ações que precisam ser verificadas. Após assinar, pausar, retomar ou trocar de modo, consulte a assinatura e confirme seu estado efetivo. Após cancelar a assinatura, confirme que ela não existe ou retorna SUBSCRIPTION_NOT_FOUND. Revise tanto as ordens ativas na corretora em GET /v1/orders/open quanto as ordens gerenciadas em GET /v1/orders/working-orders. Antes de depender de uma pausa ou cancelamento de assinatura para controlar riscos, cancele qualquer ordem que não deva continuar ativa e confirme seu estado final.

Ajuda do agente

O agente pode ajudar a explicar a estratégia, resumir as configurações de risco, revisar a conta de corretora conectada e preparar uma lista de verificação para negociação real.

A negociação real usa dinheiro real. Interrompa a estratégia se o comportamento não corresponder às suas expectativas.