Guia da API do Polymarket: Mercados ao Vivo, WebSockets e Pesquisa Histórica
Polymarket expõe interfaces de mercado atuais fortes. A decisão arquitetônica é onde a superfície oficial ao vivo termina e um livro histórico continuamente gravado começa.
A superfície do desenvolvedor do Polymarket cobre a descoberta de mercado, preços, negociações e atualizações ao vivo do livro de ordens CLOB. Use a documentação oficial para definições de endpoint e comportamento do local atuais. Para pesquisa histórica, decida primeiro se uma série de preços é suficiente ou se a estratégia precisa da escada de compra/venda que existia em cada momento da decisão; apenas um arquivo continuamente capturado pode fornecer este último depois que a atualização ao vivo passou.
Mapeie a tarefa para a superfície de dados
| Tarefa | Dados necessários | Fonte típica |
|---|---|---|
| Descobrir mercados atuais | Eventos, mercados, resultados e identificadores | APIs oficiais do Polymarket |
| Monitorar a liquidez atual | Lances ao vivo, ofertas, tamanhos e alterações de preço | WebSocket CLOB oficial |
| Plotar uma série de probabilidade | Preços históricos de resultados | Superfície de histórico de preços oficial |
| Reproduzir execução | Escadas de compra/venda passadas com carimbos de data/hora | Arquivo gravado continuamente |
| Comparar com spot | Observações de livro unidas a uma referência subjacente | Provedor de pesquisa normalizado |
Por que os identificadores e os carimbos de data/hora vêm primeiro
Uma integração do Polymarket cruza eventos, mercados, condições e identificadores de token. Armazene esses relacionamentos com os valores de origem brutos em vez de tratar um título legível por humanos como uma chave. Um título pode mudar; um estudo de execução deve ainda unir o mesmo token de resultado ao mesmo registro gravado.
Mantenha os carimbos de data/hora de origem e recebimento separadamente. O tempo de origem descreve o evento do local, enquanto o tempo de recebimento descreve quando seu sistema o observou. A combinação deles em um único campo torna a latência e os erros de ordenação impossíveis de auditar.
O que DepthFeed adiciona
DepthFeed grava atualizações CLOB do Polymarket orientadas a eventos, constrói observações de livro completo normalizadas e as serve por meio das mesmas formas REST e WebSocket usadas para Kalshi. As linhas históricas incluem preços e tamanhos de escadas em vez de apenas um único ponto de probabilidade.
Esse registro suporta a reprodução de VWAP com consciência de profundidade no Backtest Lab, consultas de API históricas e auditorias de execução do próximo livro para atividade pública da carteira. A cobertura ausente permanece explícita e o arquivo não afirma reproduzir a liquidez oculta, a prioridade da fila ou o impacto no mercado de um pedido real.
Lista de verificação de integração
- Use a documentação oficial do Polymarket como a autoridade para endpoints e regras de negociação atuais.
- Persista identificadores de evento, condição e token de resultado juntos.
- Semente um livro completo antes de aplicar alterações incrementais de preço.
- Mantenha os carimbos de data/hora de origem e recebimento em vez de substituir um pelo outro.
- Use o histórico de preços para gráficos e as escadas históricas completas para a reprodução de execução.
- Teste lacunas, reconexões e atualizações duplicadas antes de confiar em um backtest.
Key takeaways
- 01A API oficial do Polymarket é a autoridade correta para o estado atual do local.
- 02As atualizações CLOB ao vivo devem ser semeadas e ordenadas para reconstruir um livro completo.
- 03Uma série de probabilidade histórica não revela a profundidade de repouso passada.
- 04DepthFeed adiciona escadas completas gravadas e um esquema de pesquisa entre locais.
- 05Os identificadores, os carimbos de data/hora e o comportamento de dados ausentes devem ser projetados antes da lógica da estratégia.
Polymarket expõe interfaces de mercado atuais fortes. A decisão arquitetônica é onde a superfície oficial ao vivo termina e um livro histórico continuamente gravado começa.
Começar grátis