Endpoints Polymarket: host e identificador corretos

Por PredictionToolkit · Atualizado em 2026-11-02

Gamma, CLOB e Data API respondem a perguntas diferentes. Este guia separa as solicitações documentadas das verificações públicas registradas nas fontes; os serviços são operados pelos provedores, não por este diretório.

Comece pela tarefa

• Descoberta: https://gamma-api.polymarket.com GET /markets/keyset?closed=false&limit=1.
• Livro: https://clob.polymarket.com GET /book?token_id={outcome token ID}.
• Ranking: https://data-api.polymarket.com GET /v2/leaderboard?time_period=day&limit=1. As três consultas públicas não precisam de credenciais.

Preserve identificadores separados

Um evento agrupa mercados. Gamma id identifica os metadados e conditionId a condição on-chain. No mercado CTF da amostra, outcomes e clobTokenIds eram arrays codificados em JSON e pareados por índice. Analise ambos e confira se têm o mesmo tamanho antes de selecionar um token. Pare se os campos estiverem ausentes, desalinhados ou inadequados ao protocolo. Não substitua uma condição ou token pelo Gamma id numérico.

Confira a passagem ao livro

O registro obteve mercado aberto e livro sem autenticação, ambos HTTP 200. Gamma retornou markets e next_cursor; CLOB, market, asset_id, bids, asks e timestamp. market correspondeu a conditionId e asset_id ao token. Repetir pode trazer outro mercado, vazio ou erro/livro ausente. Preço da amostra não é cotação atual.

Escolha leitura de carteira

As rotas documentadas de Data incluem GET /v2/positions?user={proxy wallet}&limit=1 e GET /v2/activity?user={proxy wallet}. Use um endereço público de carteira proxy que você tenha direito de examinar; nenhuma carteira foi consultada na verificação registrada. As posições usam OPEN por padrão. Use condition como filtro de condição, não Gamma id. Leituras paginadas esperam data e pagination, com condition_id e token_id nas posições. Siga o next_cursor opaco até null; pagination.offset é metadado de exibição, não um parâmetro de solicitação. Confira os padrões, filtros, limites e resultados vazios de cada rota.

Separe traders e builders

A solicitação de traders retornou HTTP 200 e uma linha user_id, com data/pagination, has_more e next_cursor; apenas a primeira página foi verificada. GET /v2/builders/leaderboard?time_period=day&limit=1 descreve, por sua vez, integrações builder_code, volume atribuído e usuários ativos; ficou restrito à revisão documental. Identifique PNL versus VOLUME, período e unidades. O P&L diário avaliado difere do P&L realizado de toda a vida; volume são cotas de resultado, não USD nem lucro garantido. Rankings não identificam pessoas nem comprovam integrações.

Confira resultado

• Registre host, rota e acesso público/privado.
• Separe Gamma id, conditionId e token; compare book.market e asset_id.
• Preserve data/pagination e cursores, não páginas numéricas.
• Declare user_id ou builder_code, métrica, período e unidades.

Limites e operações privadas

O CLOB privado GET /data/orders precisa de autenticação HMAC L2; enviar uma ordem exige também assinatura de carteira. A atividade pública da carteira não é o estado de suas ordens privadas nem uma identidade humana. As verificações registradas cobriram uma página Gamma, um livro CTF e uma página de traders, não a contabilidade de carteiras, todas as páginas, solicitações privadas, assinaturas, ordens ou latência. Não garantem histórico ou disponibilidade futura. Não envie endereços, chaves, segredos ou assinaturas ao diretório.