O que é Polymarket Gamma API?
Um evento agrupa perguntas; um mercado binário é um contrato YES/NO com regras e datas próprias. Separe ID, slug e tokens em vez de tratar cada URL de evento como um mercado executável.
A resposta verificada de /markets/keyset contém markets e next_cursor. Uma amostra de mercado CTF incluía id, conditionId e arrays outcomes e clobTokenIds codificados em JSON; rótulos de resultados e tokens devem manter os índices alinhados. A amostra não comprova campos idênticos nem livro CLOB disponível em cada versão do protocolo.
Para quem é
- Criar catálogos pesquisáveis.
- Obter definições e tags para pesquisa.
- Ligar jogos, equipes e contratos esportivos.
Funções e cobertura
- Eventos
Consulte um evento ou percorra páginas.
- Mercados
Obtenha contratos binários e identificadores.
- Tags e filtros
Restrinja categoria, status e atributos compatíveis.
- Séries
Agrupe eventos recorrentes por tema.
- Esportes
Descubra ligas, equipes, vencedor, handicap e totais.
- Ligação com jogos
Use ID do jogo para mercados relacionados sem adivinhar slugs.
- Resposta keyset
Leia markets e next_cursor e analise arrays codificados de resultados/tokens quando presentes.
Fluxos de trabalho com Polymarket Gamma API
Criar catálogo
Percorra eventos abertos, preserve IDs e slugs e associe resultados a tokens. Atualize status separado dos preços.
Ligar esportes
Identifique o jogo e a ordem das equipes e use seu ID para descobrir mercados de estatísticas específicas e linhas adicionais.
Resolver um link
Busque evento ou mercado por URL/slug e passe IDs às consultas de livros.
Associar livro CTF
Separe id Gamma e conditionId. Mantenha a ordem de resultados e tokens; use o token no CLOB e pare se faltar token ou livro habilitado.
Preços e custo total
A descoberta pública dispensa autenticação. O guia não indica assinatura separada para essas leituras.
Primeiros passos
Antes de começar: Catálogo completo exige paginação.
- Escolha nível de evento, mercado ou série.
- Solicite uma página pequena filtrada.
- Preserve IDs, slugs, tags e associações de tokens.
- Use CLOB para preços executáveis e livros.
Um evento pode conter vários mercados, não apenas um contrato YES/NO.
Links úteis
O que verificar
- Catálogo completo exige paginação.
- Regras e datas pertencem a cada contrato.
- Ordem mandante/visitante pode mudar após reagendamento.
- Campos CTF da amostra não garantem tokens ou livros em toda versão.
Mais detalhes
Notas e avaliações
Avaliações dos usuários 0
O limite de avaliações publicadas para que a nota principal passe a usar as notas dos usuários é 5.
Um exemplo específico ajuda a próxima pessoa a escolher a ferramenta certa.
Ferramentas relacionadas
Explorar categoriaGuias e fluxos de trabalho
Perguntas frequentes sobre Polymarket Gamma API
Evento e mercado são diferentes?
Um evento agrupa perguntas; mercado binário representa uma pergunta YES/NO.
Gamma envia ordens?
Não. Isso cabe ao CLOB.
Como encontro mercados esportivos relacionados?
Use ID do jogo e o fluxo atual de listagem.
Toda lista é um array direto?
Não. /markets/keyset retornou objeto com markets e next_cursor. Ajuste o parser à rota.


