Documentação do HeyTraders

As perguntas à IA sobre este documento estão disponíveis na versão em inglês. Abrir a versão em inglês

Tipos de ordem

Escolher uma ordem

O HeyTraders apresenta um conjunto comum de conceitos de ordens nas corretoras conectadas. Uma corretora pode executar uma ordem nativamente ou o HeyTraders pode gerenciá-la, mas o gatilho, o preço, a quantidade e a proteção solicitados não são alterados silenciosamente. A disponibilidade continua dependendo da conta, da corretora e do mercado selecionados.

OrdemQuando usarPrincipal limitação
A mercadoA velocidade de execução importa mais que o preço exato.O preço final pode mudar durante a execução.
LimitadaVocê aceita negociar somente no preço escolhido ou melhor.A ordem pode permanecer no livro ou nunca ser executada.
ChaseVocê quer que uma ordem limitada post-only acompanhe a melhor compra ou venda.Alterar o preço pode perder a prioridade na fila; a execução não é garantida.
Stop a mercadoVocê quer uma ordem a mercado somente após o preço atingir um gatilho.Um movimento rápido pode causar slippage após o disparo.
Stop limitadaVocê quer uma ordem limitada somente após o preço atingir um gatilho.O gatilho pode disparar sem que a ordem limitada seja executada.
Take ProfitVocê quer sair ou entrar após atingir uma meta favorável.A execução a mercado pode ocorrer além do preço de disparo.
Take Profit limitadaVocê quer proteção de preço após um gatilho de take-profit.A ordem limitada resultante pode ficar sem execução.
Trailing StopVocê quer que a proteção acompanhe um movimento favorável.Uma reversão pode disparar a proteção antes de o mercado retomar a tendência.

No Polymarket, os preços são exibidos em centavos na interface. Um gatilho de 55 centavos equivale ao preço 0.55. Ordens de compra a mercado usam um orçamento em USDC; ordens de venda a mercado e ordens com formato limitado usam uma quantidade de cotas.

Ordens a mercado e limitadas

Uma ordem a mercado busca execução imediata contra a liquidez disponível. Ela é adequada quando entrar ou sair importa mais que um preço específico. O preço cotado é uma estimativa, e não um preço de execução garantido.

Uma ordem limitada define o pior preço aceitável. Uma compra pode ser executada no limite ou abaixo dele, e uma venda no limite ou acima dele. Qualquer quantidade não executada pode permanecer aberta quando a validade selecionada permitir.

Post-only é uma opção de ordem limitada em mercados compatíveis. Ela rejeita ou cancela uma ordem que retiraria liquidez imediatamente, portanto não deve ser usada quando a execução imediata for necessária.

Ordens Chase

Chase é uma ordem limitada que acompanha o preço, e não uma ordem a mercado ou trailing stop. O HeyTraders a gerencia em seus servidores, portanto fechar o navegador não a interrompe.

Em 15 de setembro de 2026, Chase está disponível pela rota Polymarket Perp gerenciada pelo HeyTraders. Essa rota é separada dos mercados de previsão Polymarket. Não presuma que Hyperliquid ou outra corretora conectada aceita Chase: verifique orders.chase em GET /v1/order-capabilities para a conta e o mercado selecionados. O painel de ordens só mostra Chase quando essa capacidade o permite.

Como o preço acompanha o livro

  • Uma compra acompanha a melhor oferta de compra; uma venda acompanha a melhor oferta de venda.
  • A rota gerenciada atual envia ordens limitadas post-only. Ela não cruza o spread intencionalmente nem se transforma em ordem a mercado para forçar a execução.
  • Quando o preço-alvo muda, o HeyTraders cancela/substitui a ordem filha pendente. Várias atualizações do livro podem ser reunidas no alvo mais recente; não há promessa de enviar uma ordem a cada atualização de cotação.
  • Execuções parciais contam para a quantidade total original. Por exemplo, após executar 4 de 10 unidades, Chase continua apenas com as 6 restantes. Se um cancelamento coincidir com uma execução tardia, a substituição aguarda a confirmação da quantidade executada em vez de reenviar o total original.

A cotação pode mudar antes de a corretora receber a substituição. Nesse caso, post-only pode impedir a execução imediata, e cancelar/substituir pode perder a prioridade na fila. Chase não garante execuções como maker, presença contínua no melhor preço nem conclusão da quantidade solicitada.

Distância máxima de Chase

A distância máxima de Chase é opcional. Ela é uma diferença absoluta de preço na moeda de cotação do mercado, não uma porcentagem, valor em pontos-base ou contagem de ticks. A âncora é o primeiro preço-alvo válido de Chase normalizado pelo tick, e não o preço da substituição mais recente.

  • Compra: limita quanto o alvo pode subir acima da âncora.
  • Venda: limita quanto o alvo pode cair abaixo da âncora.
  • Um movimento favorável não redefine a âncora.
  • Se a distância for excedida, Chase para e cancela sua ordem filha ainda ativa. Um alvo exatamente na distância ainda está dentro do limite.

Em uma compra ancorada em 100 com distância de 5, a melhor compra em 105 está dentro do limite; 106 o excede. Uma queda para 99 não redefine o limite superior de 105. Deixar a configuração vazia significa ausência de limite de distância definido pelo usuário, e não distância zero.

Enviar, acompanhar e interromper Chase

No painel de ordens, selecione Chase, escolha o lado e a quantidade e, se desejar, defina a distância máxima de Chase. Você não informa um preço limite fixo nem escolhe GTC/IOC para Chase; a rota gerenciada atual controla a execução post-only das ordens filhas.

Acompanhe a ordem Chase em execução para ver o total executado e a quantidade restante. Os IDs individuais das ordens filhas na plataforma podem mudar quando o preço é atualizado. Para interromper Chase, cancele a ordem gerenciada principal, e não apenas uma ordem filha na plataforma. O cancelamento não reverte execuções concluídas nem encerra a posição resultante. Para alterar a instrução de Chase, primeiro confirme que ela parou e depois crie uma nova ordem com a quantidade que ainda pretende negociar.

Se os dados de mercado ficarem indisponíveis, a atualização de preço é pausada. Uma interrupção prolongada sem solução pode encerrar Chase e cancelar sua ordem filha pendente; isso não aciona uma alternativa de ordem a mercado. Verifique o estado da ordem em execução em vez de supor que uma solicitação aceita já foi executada ou que o cancelamento é instantâneo.

Consulte o exemplo da API Chase para o formato da solicitação e o cancelamento da ordem principal.

Ordens Stop e Take Profit

Ordens stop e take-profit separam o gatilho da ação que vem depois:

  • Stop a mercado e Take Profit enviam uma ação a mercado quando o gatilho é satisfeito.
  • Stop limitada e Take Profit limitada enviam uma ação limitada quando o gatilho é satisfeito.

A comparação do gatilho inclui a igualdade. Se um gatilho recém-criado já estiver satisfeito, ele pode disparar imediatamente. Gatilhos gerenciados pelo Broker observam o mark price nos derivativos e o último preço negociado nos mercados spot e de previsão; mudanças apenas nas ofertas de compra e venda não os disparam. As referências de gatilhos nativos podem ser diferentes; consulte a documentação da corretora selecionada quando a ordem for roteada nativamente.

Uma ordem limitada disparada não significa execução. Em um mercado rápido, o preço pode passar tanto pelo gatilho quanto pelo limite antes que a ordem limitada chegue à plataforma.

Como funcionam os gatilhos gerenciados

Um gatilho nativo da corretora é mantido e avaliado por ela. Um gatilho gerenciado pelo HeyTraders é diferente: o HeyTraders armazena a instrução, acompanha o fluxo canônico de dados de mercado em seus servidores e envia a ordem filha selecionada somente depois de satisfazer a condição de disparo. Fechar o navegador não desliga um gatilho gerenciado em execução.

A referência do gatilho depende do tipo de mercado:

Tipo de mercadoReferência do gatilho gerenciado
Derivativos com mark price da plataformaMark price
CLOBs spot e de mercados de previsão, incluindo PolymarketÚltimo preço negociado

Mudanças na melhor compra, melhor venda e ponto médio não disparam um gatilho gerenciado. Isso evita o disparo por uma cotação inserida ou retirada sem negociação. Se a fonte necessária de mark price ou último negócio estiver indisponível, inválida ou se o mercado de previsão já tiver sido resolvido, o HeyTraders aguarda; ele não inventa um preço de disparo nem usa o livro de ofertas como alternativa.

A comparação inclui a igualdade. Um gatilho <= dispara quando a referência está igual ou abaixo do gatilho; um gatilho >= dispara quando está igual ou acima. Assim, um gatilho já satisfeito quando aceito pode disparar sem esperar um novo cruzamento.

Após o disparo de um gatilho gerenciado:

  1. O HeyTraders registra a transição do gatilho e envia a ação configurada pela conta conectada.
  2. Uma ação a mercado executa contra a liquidez disponível quando chega à plataforma. Ela pode executar em outro preço, parcialmente ou não executar.
  3. Uma ação limitada é enviada no limite configurado. Ela pode executar integralmente, parcialmente, permanecer no livro, expirar ou ficar sem execução conforme sua validade.

O preço de disparo nunca é uma promessa de preço de execução. A entrega dos dados de mercado, o processamento do gatilho, o envio da ordem e o casamento na plataforma acontecem em sequência; por isso o mercado pode mudar entre o evento observado e a execução. Um gatilho gerenciado em execução também depende da disponibilidade dos dados de mercado do HeyTraders, do serviço de ordens gerenciadas e da conta de corretora conectada.

Os mercados de previsão Polymarket não oferecem um mark price de derivativos para esse fim. Ordens Stop, Take Profit, pernas com gatilho OCO e Trailing Stop gerenciadas pelo HeyTraders para Polymarket usam o último preço negociado do token de resultado. Essas instruções não são ordens Stop pendentes no Polymarket antes de dispararem. Ordens Polymarket a mercado, IOC/FAK, FOK e limitadas comuns continuam sendo ordens nativas da plataforma e são enviadas diretamente, sem avaliação por essa lógica de gatilhos gerenciados.

Livros Polymarket com pouca liquidez tornam essa diferença especialmente importante. Um Stop a mercado gerenciado prioriza o envio de uma saída executável após o disparo, mas não garante a quantidade ou o preço executado. Um Stop limitado gerenciado controla o preço limite, mas pode deixar a posição parcial ou totalmente aberta se não houver liquidez naquele preço.

Proteção móvel

Um trailing stop se move apenas na direção favorável. Em uma posição comprada, acompanha o maior preço observado; em uma vendida, o menor. Quando o preço reverte pela distância de trailing configurada, a ação de proteção é enviada.

Configurações opcionais de ativação podem adiar o trailing até o preço atingir um nível escolhido ou se mover favoravelmente por uma porcentagem escolhida. Um stop inicial pode proteger a posição antes da ativação. Somente um método de ativação pode ser usado por vez.

A proteção móvel gerenciada pelo HeyTraders reage a eventos do mercado. Ela não usa uma agenda fixa de disparo a cada segundo e não coloca um stop pendente na corretora enquanto ainda está acompanhando o preço.

Ordens bracket e OCO

Um bracket combina uma entrada com uma ou mais saídas de proteção. As pernas de take-profit, stop-loss e trailing continuam vinculadas à entrada e ficam ativas conforme a política de execução selecionada.

A proteção pode ser ativada de três maneiras:

AtivaçãoComportamento
Execução totalAguarda a execução de toda a quantidade de entrada.
Qualquer execuçãoAtiva após a primeira execução positiva com o tamanho de proteção configurado.
Execução proporcionalArma e redimensiona a proteção à medida que aumentam as execuções acumuladas da entrada.

Use execução proporcional quando entradas parcialmente executadas precisarem de proteção sem criar uma saída maior que a posição executada. Níveis escalonados de take-profit ou stop-loss podem dividir a quantidade protegida por porcentagem ou quantidade explícita.

OCO vincula duas ordens para que a conclusão de uma cancele a outra. A proteção bracket usa a mesma relação de cancelamento entre saídas incompatíveis. Uma execução pode coincidir com o cancelamento na corretora; por isso o estado final das ordens e posições continua sendo a fonte oficial.

A proteção também pode ser associada a uma posição existente, a uma ordem ativa na plataforma ou a uma ordem já gerenciada pelo HeyTraders. As pernas anexadas continuam fazendo parte da mesma ordem gerenciada, em vez de aparecerem como ordens principais sem relação entre si.

TWAP, VWAP e Iceberg

TWAP e VWAP dividem uma ordem maior em parcelas menores:

  • TWAP distribui as parcelas ao longo da duração selecionada.
  • VWAP dimensiona cada parcela usando os pesos de volume e o cronograma configurados.

O HeyTraders pode gerenciar TWAP e VWAP mesmo quando a corretora não os oferece como tipos nativos. Cada parcela continua seguindo as regras normais de precisão, saldo e execução do mercado conectado. A proteção associada à ordem principal acompanha as execuções acumuladas das parcelas e se redimensiona conforme a política de ativação selecionada.

Iceberg está disponível somente quando a corretora selecionada informa suporte nativo a iceberg. A plataforma repõe a quantidade visível até que a ordem total seja executada ou cancelada; o HeyTraders não apresenta uma ordem simulada em parcelas como iceberg nativo.

Validade da ordem

A validade determina por quanto tempo uma ordem pode permanecer ativa:

ConfiguraçãoComportamento
GTCPermanece ativa até ser executada ou cancelada.
GTTPermanece ativa até o horário de expiração escolhido.
IOCExecuta imediatamente o máximo possível e cancela o restante.
FOKExecuta imediatamente toda a quantidade ou cancela a ordem inteira.
Post OnlyApenas adiciona liquidez; não pode executar imediatamente como taker.

Nem toda configuração é válida para toda ordem ou corretora. O painel mostra as opções compatíveis com a conta e o mercado selecionados. GTT exige uma expiração explícita; o HeyTraders não adiciona uma expiração curta a uma ordem limitada que seria GTC.

Estado da ordem

Aceita significa que o HeyTraders admitiu a solicitação para processamento. Isso ainda não comprova envio à corretora, uma ordem pendente no livro ou execução. As ordens em execução expõem as pernas atuais de entrada e proteção enquanto o HeyTraders as gerencia.

Execuções parciais aumentam a quantidade executada sem indicar que a quantidade restante foi concluída. No Polymarket, Matched é provisório enquanto a corretora confirma a liquidação; a interface pode mostrar esse estado como Em liquidação. O estado confirmado ou liquidado é a fonte final para execução concluída.

Cancelar uma ordem gerenciada principal encerra o restante de seu fluxo, mas não desfaz execuções. Cancelar uma perna de proteção mantém as pernas irmãs compatíveis. Editar uma ordem ativa na plataforma pode mudar seu ID ou sua prioridade na fila; portanto atualize a ordem após uma alteração.

Disponibilidade

O painel usa a conta conectada e o mercado selecionado para determinar quais tipos de ordem, valores de validade, modos de proteção e operações de edição estão disponíveis. Um recurso pode ser fornecido pela corretora ou gerenciado pelo HeyTraders; a ausência de suporte nativo, por si só, não significa que ele esteja indisponível.

Para campos da solicitação, comportamento dos endpoints, exemplos e esquemas de resposta, use o tópico da API de ordens e GET /v1/openapi.json.