PredictionToolkit
O que é Polymarket Data API?
Uma visão da carteira precisa de mais que o P&L total: relacione posições aos respectivos resultados, mantenha lado, preço, tamanho e horário dos negócios e separe exposição aberta, resultados de posições encerradas e volume negociado. As páginas de detentores de cotas são específicas de cada resultado; agrupe por asset ID em vez de reunir detentores de resultados sem relação.
Rankings exigem período e métrica explícitos. A amostra pública v2 salva usou data/pagination; limit=1 retornou uma página com mais resultados. Essa observação limitada não valida contabilidade, todos os endpoints ou ordens privadas.
Para quem é
- Desenvolvedores de painéis de carteiras.
- Pesquisadores de participação pública.
- Aplicativos que conciliam posições e histórico.
Funções e cobertura
- Posições e atividade
Leia exposição e atividade públicas para conciliar carteiras.
- Registros de negócios
Use lado, preço, tamanho, resultado, carteira e horário.
- Detentores de cotas por resultado e P&L
Una as páginas de detentores por asset ID. includePnl exige uma única condição e tamanho de página de no máximo 100.
- Contratos em aberto e volume
Consulte os contratos em aberto de até 20 condition IDs ou o total global. Distinga o volume ao vivo de um evento do volume negociado por uma carteira.
- Estado de resolução
Examine status, pagamentos e horário de atualização. expected_settlement_time estima o momento mais cedo possível da liquidação, não um prazo fixo.
- Rankings de traders e builders
Consulte a classificação do trader e as estatísticas de volume e usuários ativos dos builders. Carteiras fora do ranking podem não ter classificação. O padrão é o período de um dia com ordenação por P&L.
- Paginação e tipos
Siga a estrutura de resposta e o cursor de cada endpoint. Use os tipos do SDK quando disponíveis e examine os campos originais da API para identificar propriedades novas.
- Estrutura v2 salva
A amostra expôs data e pagination (limit, offset, has_more, next_cursor) e linhas user_id, rank, pnl, volume e user_name, diferentes do Gamma.
Fluxos de trabalho com Polymarket Data API
Crie uma visão da carteira
Consulte posições e atividade, una os IDs de token ou condição aos metadados do Gamma e separe exposição aberta, resultados de posições encerradas e volume negociado.
Estude participação
Consulte negócios e páginas de detentores de cotas de uma condição, agrupe por asset ID e acrescente os contratos em aberto.
Compare rankings com critério
Use período e métrica iguais; preserve empates e ausências sem convertê-las em zero.
Importe páginas completas
Salve time_period e métrica, leia data e mantenha o cursor opaco; uma linha não prova cobertura completa.
Preços e custo total
O guia não lista assinatura independente. Análise pública e operações autorizadas têm requisitos distintos.
Primeiros passos
Antes de começar: Não reúna registros de detentores de cotas de resultados sem relação.
- Leia os guias de análise e atividade e escolha uma consulta.
- Trate estrutura e paginação e una IDs estáveis.
- Use SecureClient apenas em operações que exigem autorização.
As páginas de detentores de cotas pertencem a resultados específicos; una por asset ID.
Links úteis
O que verificar
- Não reúna registros de detentores de cotas de resultados sem relação.
- includePnl exige uma condição e página ≤100.
- Escolha período explícito; padrões são dia e P&L.
- Estimativas não são prazos; confira status e pagamentos.
- A verificação salva de uma página não valida contabilidade, todos os esquemas, paginação completa ou ordens privadas.
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
Replique execuções, posições e saldos para análises, aplicações e alertas próprios.
- Acesso API · CLI
Leia preços e profundidade por token de resultado e trate ordens autenticadas por um processo separado de assinatura.
- 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 Data API
Pode enviar ordens?
Use CLOB para negociar.
Como difere do Gamma?
Gamma descreve eventos e mercados; Data API cobre posições, atividade e participação.
Uma resposta é todo o histórico?
Siga a paginação até completar o intervalo.
limit=1 significa que existe só um trader?
Não. A resposta salva incluía has_more e next_cursor: era uma página, não toda a população.