Ordens

Use esta seção para entender como o HeyTraders envia e gerencia ordens nas corretoras conectadas.

O HeyTraders oferece ordens diretas e determinados fluxos de ordens gerenciadas nas corretoras conectadas. O comportamento disponível depende da conta conectada, da corretora e do símbolo.

Comece aqui

• /v1/docs/orders/order-types explica o comportamento de ordens a mercado, limitadas, com gatilho, bracket, OCO, iceberg nativo quando disponível e trailing stop.
• Ordens Chase explica o acompanhamento post-only de compra/venda, a distância máxima de Chase, as execuções parciais e como interromper a ordem gerenciada.
• /v1/docs/api/orders documenta os dados das solicitações públicas.

Como as ordens funcionam

Ordens diretas

Ordens diretas são ordens individuais enviadas à corretora. Ordens a mercado, limitadas, stop-loss e take-profit são os exemplos mais comuns.

Ordens de proteção

Ordens de proteção associam saídas a uma posição ou ordem de entrada. Stop loss, take profit, take profit escalonado e ordens bracket pertencem a essa categoria.

Direção de Stop e Take Profit

stop e take_profit usam o mesmo mecanismo de gatilho: “quando o preço atingir um nível, disparar uma ordem”. O nome indica apenas a direção do gatilho em relação ao preço atual, e não um “acima/abaixo” absoluto:

• Stop dispara quando o preço se move na direção desfavorável (execução pior que agora): uma compra acionada quando o preço sobe ou uma venda acionada quando ele cai. Isso abrange tanto saídas de stop-loss quanto entradas de rompimento.
• Take Profit dispara quando o preço se move na direção favorável (execução melhor que agora): uma compra acionada quando o preço cai ou uma venda acionada quando ele sobe.

A direção segue o lado da ordem, portanto a condição do gatilho é totalmente determinada por lado + tipo:

A ideia de que “take-profit é para cima e stop-loss é para baixo” só vale para uma posição comprada, que é encerrada vendendo. Para uma posição vendida, encerrada comprando, a relação se inverte: take-profit é para baixo e stop-loss é para cima. A regra constante é take-profit = direção de lucro, stop = direção de perda da posição que está sendo encerrada.

Em um gatilho gerenciado pelo HeyTraders, um preço de disparo já satisfeito pelo preço atual no momento da criação (por exemplo, uma compra take_profit em 0.15 quando o preço está em 0.13) pode disparar imediatamente. Para expressar diretamente “disparar quando o preço cruzar X”, sem inferência de posição/lado, use uma condição simples de preço (>= / <=) em vez de stop/take_profit.

market e limit são independentes dessa direção: eles apenas determinam qual ordem é enviada quando o gatilho dispara. Uma ordem a mercado busca execução imediata, mas não garante execução ou preço. Uma ordem limitada não pode ser executada a um preço pior que seu limite, mas pode permanecer sem execução. stop_market, stop_limit, take_profit_market e take_profit_limit combinam a direção (stop/tp) com o tipo de ordem após o disparo (market/limit).

Ordens gerenciadas

Os fluxos OCO, bracket e trailing-stop coordenam múltiplas condições ou pernas de ordem. Sua disponibilidade e configurações dependem da conta conectada, da corretora e do símbolo.

Capacidade nativa e gerenciada

Antes de habilitar um tipo de ordem, consulte GET /v1/order-capabilities com account_id, exchange e symbol. O endpoint exige o escopo read e acesso à conta. Ele informa disponibilidade, roteamento, valores de validade permitidos, precisão e possibilidade de substituir ou alterar ordens ativas. Trate-o como a autoridade atual de disponibilidade, e não como um esquema dos dados da solicitação.

Para alavancagem, margem, limites de quantidade e reduce_only específicos da conta, consulte GET /v1/accounts/{account_id}/symbol-capabilities com symbol e, quando necessário, exchange.

Diferenças entre corretoras

Nem todas as corretoras oferecem cada recurso de ordem da mesma forma. Consulte as observações específicas em /v1/docs/supported-exchanges antes de usar comportamentos avançados de ordens na negociação real.

Antes de negociar com dinheiro real

Antes de enviar ordens reais:

• confirme a conta de corretora conectada
• confirme símbolo, lado, tamanho e alavancagem
• confirme as capacidades retornadas para a conta e o símbolo conectados
• ensaie o fluxo no modo de simulação quando aplicável
• use o menor tamanho viável na primeira ordem real
• acompanhe a primeira execução real