Um livro de ordens é uma lista dinâmica, não uma negociação concluída

A Polymarket usa um livro central de ordens limitadas (Central Limit Order Book, ou CLOB), no qual os preços surgem das ordens enviadas pelos participantes do mercado, em vez de serem definidos pela plataforma. Cada resultado possui um ativo negociável e seu próprio livro de ordens em aberto. O livro agrupa ordens de compra e venda por níveis de preço, permitindo ao leitor ver o que está sendo oferecido naquele momento nos dois lados. Essa distinção é fundamental: uma entrada no livro registra uma ordem que permanece disponível para casamento. Ela não prova, por si só, que houve uma negociação, que todo o tamanho cotado continuará disponível instantes depois nem que outra ordem terá a mesma execução.

A resposta pública do livro de ordens identifica o mercado e o ativo correspondente ao resultado e, em seguida, retorna listas de bids e asks. Cada nível contém um preço e um tamanho. A mesma resposta pode incluir timestamp, hash do estado, tamanho mínimo da ordem, incremento de preço permitido, indicador de risco negativo e preço da última negociação. Esses campos descrevem a fotografia do livro e as restrições de negociação associadas; eles não transformam essa fotografia em um registro de transação. O hash do estado é especialmente útil ao comparar leituras, pois sua alteração indica que o estado do livro mudou. Portanto, uma leitura cuidadosa vincula cada observação ao identificador correto do resultado e a um estado específico do livro, em vez de tratar um preço isolado como evidência completa.

Bids e asks descrevem lados opostos do interesse disponível

Uma bid é uma ordem de compra em aberto: ela informa o preço que um participante está disposto a pagar pelo ativo do resultado e o tamanho disponível naquele nível. Uma ask é uma ordem de venda em aberto: ela informa o preço que um participante está disposto a aceitar e o tamanho correspondente. A bid mais alta é o preço de compra em aberto mais competitivo, enquanto a ask mais baixa é o preço de venda em aberto mais competitivo. Esses valores são chamados de best bid e best ask. Na representação documentada do livro, as bids aparecem em ordem crescente de preço e as asks em ordem decrescente, deixando os dois melhores preços no fim de suas respectivas listas. O leitor deve seguir essa ordenação documentada, sem presumir que o primeiro item seja sempre a melhor cotação.

O lado de uma ordem recebida determina quais cotações em aberto são relevantes. Uma compra imediata encontra as asks disponíveis, começando pela ask mais baixa; uma venda imediata encontra as bids disponíveis, começando pela bid mais alta. Por isso, um preço central exibido não deve ser confundido com uma cotação executável. O comprador não adquire automaticamente no ponto médio, e o vendedor não recebe automaticamente esse valor. O ponto de partida relevante está no lado oposto do livro. Ainda assim, a melhor cotação descreve apenas o primeiro nível disponível. Se o tamanho solicitado for maior que o disponível nesse nível, a execução poderá continuar em níveis adicionais, cada um com seu próprio preço e tamanho. Ler a melhor cotação sem considerar seu tamanho revela apenas parte do quadro.

Spread e preço exibido respondem a perguntas diferentes

O spread é a diferença entre a best ask e a best bid de um ativo de resultado específico. A Polymarket oferece um endpoint público de spread que retorna essa diferença para um identificador de token, enquanto o endpoint completo do livro fornece os níveis de preço que a formam. O spread resume a distância entre os dois lados em aberto mais competitivos; ele não mostra quanto tamanho existe em cada lado nem nos níveis seguintes. Um spread estreito significa que esses melhores preços estão próximos, enquanto um spread mais amplo significa que estão mais afastados. Essa é uma descrição do estado visível do livro, não uma previsão nem uma garantia de que determinado tamanho possa ser executado sem alcançar outro nível.

A documentação conceitual da Polymarket diferencia o preço de mercado exibido dos preços disponíveis para um comprador ou vendedor. Normalmente, o preço exibido é o ponto médio entre a best bid e a best ask. Quando o spread ultrapassa dez centavos, a interface mostra o preço da última negociação. Nenhuma dessas convenções significa que uma nova ordem será executada no número exibido. O ponto médio é um cálculo entre duas cotações, enquanto o último preço negociado registra um casamento anterior. A ask atual continua sendo a melhor cotação relevante para uma nova compra, e a bid atual continua sendo a melhor cotação relevante para uma nova venda. Leitores cuidadosos identificam a função de cada número: ponto médio, última negociação, best bid, best ask ou preço de execução confirmado.

A profundidade relaciona níveis de preço ao tamanho executável

A profundidade é lida na sequência de níveis de preço e tamanho, não apenas na melhor cotação. No lado das asks, ela mostra quanto tamanho de venda em aberto está disponível na ask mais baixa e em preços progressivamente maiores. No lado das bids, mostra quanto tamanho de compra em aberto está disponível na bid mais alta e em preços progressivamente menores. Para examinar um tamanho considerado, o leitor pode somar os tamanhos dos níveis a partir do melhor preço até alcançar esse valor. O conjunto resultante descreve a liquidez visível que precisaria ser casada. Essa é uma interpretação dos níveis publicados e permanece vinculada à fotografia, pois ordens em aberto podem ser casadas ou canceladas à medida que o livro muda.

A profundidade também explica por que o limite solicitado e a combinação final de preços de execução são fatos separados. Uma ordem capaz de casar com mais de um nível pode receber execuções em vários preços, desde que eles respeitem seu limite e suas regras de execução. O tamanho mínimo da ordem e o incremento de preço do livro são restrições adicionais apresentadas com a fotografia e devem permanecer distintos da profundidade. O tamanho mínimo determina se a quantidade da ordem é aceita; o incremento define passos válidos de preço; a profundidade descreve o tamanho em aberto ao longo desses passos. Um registro disciplinado preserva, em campos diferentes, o identificador do resultado, o lado, o tamanho solicitado, o limite, o timestamp ou hash do livro e a evidência posterior do fill. Reuni-los sob um único rótulo, como preço de mercado, elimina informações necessárias para explicar a execução.

Uma ordem enviada não equivale a um fill confirmado

A Polymarket documenta todas as ordens como ordens limitadas no nível do protocolo. O que normalmente se chama de ordem a mercado é uma ordem limitada precificada para negociar imediatamente contra a liquidez em aberto. Uma ordem limitada convencional pode permanecer no livro até encontrar outra ordem, conforme sua duração e as demais instruções. Uma ordem Good Till Cancelled pode continuar ativa até ser executada ou cancelada, enquanto uma Good Till Date usa uma expiração definida. Para execução imediata, Fill and Kill casa a liquidez disponível naquele momento e cancela o restante; Fill or Kill exige a execução imediata de todo o tamanho solicitado ou cancela a ordem. Essas instruções definem o tratamento da parte não casada, mas o envio ainda não comprova um fill.

A resposta da ordem fornece a evidência necessária para manter esses estados separados. Uma ordem aceita pode aparecer como live quando está em aberto, matched quando encontra liquidez imediatamente ou delayed quando está apta a ser casada, mas sujeita a um atraso no casamento. Quando uma ordem recebe execução total ou parcial, a resposta documentada associa a ela os identificadores das negociações resultantes e também pode incluir hashes de transação. Esses registros são evidências de execução mais fortes do que a solicitação, a mensagem de envio bem-sucedido ou uma fotografia anterior do livro. Uma revisão cuidadosa segue uma sequência: identifica o resultado correto, lê os dois lados e sua profundidade, registra o spread e as restrições, preserva as instruções enviadas e depois verifica a resposta e as negociações resultantes. Essa sequência explica o ocorrido sem converter cotações disponíveis em fills que nunca foram confirmados.

Como este guia foi preparado

Este artigo foi preparado com assistência de IA e concluído com revisão automatizada de estrutura, uso de fontes, segurança das afirmações e consistência bilíngue.

Fontes e leitura adicional

Veja o fluxo na prática.

O passo a passo conecta esses conceitos à interface do PolyRust.

Ler o passo a passo