PredictionToolkit
O que é Polymarket CLOB API?
Dados públicos do livro incluem bids, asks e restrições de negociação. Outros endpoints fornecem ponto médio, spread e última operação. Confira o lado do preço e os identificadores antes de usar uma captura em uma interface ou serviço de execução.
Uma consulta pública CTF registrada nas fontes retornou identificadores correspondentes ao resultado selecionado no Gamma. Isso é mais restrito que testar acesso privado: assinatura, envio, cancelamento, execuções e latência sustentada não foram exercitados. Credenciais API e autorização da ordem pela carteira continuam sendo requisitos distintos.
Para quem é
- Desenvolvedores criando interfaces de negociação ou serviços de execução.
- Pesquisadores medindo spread e profundidade disponível.
- Aplicações que precisam controlar diretamente assinatura e transporte.
Funções e cobertura
- Livros de tokens de resultado
Leia bids, asks, tamanho de tick, ordem mínima, hash de estado e identificadores de mercado.
- Preços por lado
BUY retorna o melhor ask e SELL retorna o melhor bid.
- Preços de referência
Obtenha ponto médio, spread e último preço negociado separadamente.
- Solicitações em lote
Solicitações compatíveis de livros e preços aceitam até 500 itens.
- Gestão de ordens
Use a superfície autenticada para enviar ordens assinadas, cancelar e gerenciar seu estado.
- Camadas de autenticação
A assinatura de carteira L1 cria ou deriva credenciais; L2 assina solicitações privadas, enquanto outra assinatura de carteira autoriza a ordem.
- Mapeamento observado
A amostra pública retornou market, asset_id, timestamp, bids e asks. market correspondeu ao conditionId Gamma e asset_id ao token de resultado solicitado.
Fluxos de trabalho com Polymarket CLOB API
Mostre preços executáveis
Resolva tokens pelo Gamma, consulte o livro e mostre melhor bid, ask e profundidade. Identifique o ponto médio separadamente dos preços disponíveis no livro.
Construa um serviço de ordens
Estabeleça credenciais e assinatura exata, acompanhe estado e implemente cancelamento e reconciliação antes de automatizar a geração.
Valide a passagem ao livro
Compare asset_id com o token selecionado e market com conditionId. Preserve o timestamp: leitura bem-sucedida não demonstra execução ao preço.
Preços e custo total
Leituras públicas de mercado não exigem credenciais. A documentação de integração não lista assinatura API separada; taxas da plataforma se aplicam a operações elegíveis.
Primeiros passos
Antes de começar: A documentação coloca os melhores níveis no final dos arrays do livro.
- Descubra mercado e IDs de tokens associados aos resultados pelo Gamma.
- Faça uma consulta pública de livro ou preço.
- Respeite tick e tamanho mínimo de ordem.
- Para operações privadas, configure assinatura de carteira e credenciais L2.
- Mantenha a serialização exata do corpo consistente com sua assinatura.
Os arrays documentados colocam o melhor bid e ask nas últimas entradas; não presuma que o primeiro nível é o melhor.
Links úteis
O que verificar
- A documentação coloca os melhores níveis no final dos arrays do livro.
- O ponto médio não é necessariamente executável.
- Um token nunca negociado pode retornar null na última operação.
- Gamma market id, conditionId e token de resultado são identificadores diferentes.
- Só uma captura pública foi verificada; ordens privadas, execuções e latência sustentada não foram testadas.
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 categoria
Crie aplicações tipadas com leituras públicas, varreduras retomáveis, tópicos ao vivo e ações autenticadas separadas.
- Idioma TypeScript · JavaScript
Consulte posições, negócios, detentores de cotas e rankings mantendo os IDs dos resultados e o contexto da paginação.
- Acesso API
Descubra contratos e identificadores antes de consultar preços executáveis ou criar um catálogo.
- Acesso API
Guias e fluxos de trabalho
Perguntas frequentes sobre Polymarket CLOB API
Preciso de carteira para preços públicos?
Não. Leituras públicas de mercado não exigem credenciais.
Onde encontro IDs de tokens?
Use descoberta e metadados Gamma.
Ponto médio é preço de compra?
Não. Compra usa ask; ponto médio calcula a média do melhor bid e ask.
Por que assinaturas API e de carteira?
L2 autentica a solicitação e a carteira autoriza a ordem.
book.market deve ser Gamma id?
Não na amostra CTF verificada: market correspondeu ao conditionId hexadecimal. Gamma id identifica metadados e book.asset_id o token selecionado.