--- url: "https://predictiontoolkit.com/pt-br/guides/polymarket-api-endpoints/" publisher: "PredictionToolkit" dateModified: "2026-11-02" --- [← Guias do Polymarket]() # Endpoints Polymarket: host e identificador corretos Por PredictionToolkit · Atualizado em 2026-11-02 **Conteúdo** - [Comece pela tarefa]() - [Preserve identificadores separados]() - [Confira a passagem ao livro]() - [Escolha leitura de carteira]() - [Separe traders e builders]() - [Confira resultado]() - [Limites e operações privadas]() 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. ## Continuar pesquisando - [Polymarket Gamma API: API de descoberta de eventos e mercados]() · contexto: Revise descoberta. - [Polymarket CLOB API: livros e gestão de ordens]() · contexto: Revise livros e ordens privadas. - [Polymarket Data API: transforme atividade pública em análise de carteiras]() · contexto: Revise posições e rankings. - [Chave de API e autenticação do Polymarket]() · contexto: Entenda autenticação. - [APIs e provedores de dados do Polymarket]() · contexto: Compare APIs.