Busca de mercados Up/Down da Polymarket
Cole um slug como btc-updown-5m-1780949100 e veja a janela, os preços de referência, o resultado e o volume desse mercado, incluindo mercados cujos livros de ofertas a Polymarket não serve mais.
Como ler o slug
Todo mercado cripto Up/Down da Polymarket tem um slug com um formato fixo e previsível. Depois que você aprende a lê-lo, consegue montar o slug de qualquer janela em vez de procurá-lo.
btc-updown-5m-1780949100
│ │ │ └── Unix timestamp: when the window OPENS, in UTC
│ │ └────── Timeframe: 5m | 15m | 1h | 4h | 24h
│ └───────────── Always "updown"
└───────────────── Coin: btc | eth | solA armadilha: o campo startDate da API indica quando o objeto do mercado foi criado, não quando o trading começa — muitas vezes um dia ou mais antes. O timestamp do slug é o verdadeiro início da janela, e endDate é esse valor mais o timeframe.
O que a Polymarket guarda
Depois que um mercado é resolvido, a Polymarket guarda o registro do mercado e uma série de preços esparsa, e descarta o livro de ofertas. Pedir o livro de um mercado liquidado retorna 404. O histórico de preços volta com cerca de um ponto por minuto, e só quando você informa um início e um fim explícitos:
curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"} 404
curl -s "https://clob.polymarket.com/prices-history?market=$TOK&startTs=$START&endTs=$END&fidelity=1"
# about 6 points for a 5-minute market
curl -s "https://clob.polymarket.com/prices-history?market=$TOK&interval=max"
# {"history":[]} for older marketsA busca acima funciona porque esses mercados foram gravados enquanto estavam ativos. Mais sobre o funcionamento em Mercados Up/Down explicados, e as estatísticas agregadas de resolução estão nas páginas de dados de mercado.
Perguntas frequentes
- Como busco um mercado btc-updown-5m da Polymarket?
- Cole o slug — por exemplo btc-updown-5m-1780949100 — na busca acima. Você recebe a janela de trading, o preço de referência na abertura e no fechamento, qual lado venceu e o volume final. Uma URL completa de evento da Polymarket também funciona; o slug é extraído dela. Se você omitir o timestamp do final, recebe o mercado mais recente dessa série.
- O que significa o número no final de um slug Up/Down da Polymarket?
- É o timestamp Unix do momento em que a janela de trading abre, em UTC. Em btc-updown-5m-1780949100, o mercado abre nesse timestamp e fecha 5 minutos depois. Note que isso não é o mesmo que o campo startDate da API, que registra quando o objeto do mercado foi criado e pode ser um dia ou mais antes.
- Por que não encontro um mercado mais antigo da Polymarket?
- Por dois motivos. A Polymarket retorna 404 para o livro de ofertas de um mercado resolvido e guarda só cerca de um ponto por minuto de histórico de preços. A PolyTest mantém um arquivo móvel de 31 dias, então um mercado resolvido há mais de 31 dias também não está aqui. A essa altura, o livro de ofertas não existe mais em nenhum lugar que conheçamos.
- Posso obter o livro de ofertas de um mercado específico da Polymarket?
- Sim, pela API da PolyTest, para qualquer mercado dentro da janela de 31 dias. Cada mercado tem snapshots pontuais com 8 níveis de profundidade nos dois lados, com resolução abaixo de um segundo, que é o que você precisa para simular execuções realistas. A API da própria Polymarket não consegue fornecer isso para um mercado resolvido.