--- url: "https://predictiontoolkit.com/pt-br/tools/polymarket-data-api/" publisher: "PredictionToolkit" dateModified: "2026-11-03" --- [← APIs de dados]() ![Logotipo de Polymarket Data API]() API de dados # Polymarket Data API: transforme atividade pública em análise de carteiras Polymarket Data API fornece posições, atividade de carteiras e participação públicas. Use Gamma para eventos e CLOB para livros ou negociação e una os identificadores estáveis à análise. [**4,0**de 5Avaliação editorial]() [Avaliação editorial]() [Ler o guia de análises públicas]() docs.polymarket.com **Disponível em:** API **Preços:** O guia não lista assinatura independente. Análise pública e operações autorizadas têm requisitos distintos. [Capturas de tela]() [Explorar alternativas]() [APIs de dados]() [Ferramentas oficiais de desenvolvimento]() ## Capturas de tela e interface Prévia do produto1 / 2 Documentação de análises públicas. ## O que é Polymarket Data API? Monte a visão da carteira a partir das posições e dos respectivos resultados, mantendo lado, preço, tamanho e horário de cada negócio. Mostre separadamente a exposição aberta, os resultados de posições encerradas e o volume negociado, sem resumir os três ao P&L total. As páginas de detentores de cotas pertencem a resultados individuais: agrupe os registros por asset ID e mantenha separados os detentores de resultados distintos. 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. ## Dados e métodos da API - **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. ## Tarefas de integração ### 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 os negócios e as páginas de detentores de cotas de uma condição e agrupe os registros de detentores por asset ID para examinar cada resultado. Acrescente as posições em aberto para ter uma visão da participação no mercado como um todo. ### 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 a métrica do ranking com cada resultado importado. Leia as linhas de data e preserve o cursor opaco de continuação para solicitar mais páginas; receber uma linha com sucesso não indica se o ranking está completo. ## Preços e custo total O guia não lista assinatura independente. Análise pública e operações autorizadas têm requisitos distintos. ## Acesso e configuração da API 1. Leia os guias de análise e atividade e escolha uma consulta. 2. Trate envelopes e paginação conforme o endpoint e depois vincule os IDs de condição ou evento aos metadados. Separe o valor das posições em aberto em USDC do volume taker em cotas de resultado. 3. Use SecureClient apenas em operações que exigem autorização. [Endpoint base da Data API]() ## Links úteis - [Comunidade Polymarket no Discord]() ### 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. ## Observações de agregados públicos Duas consultas de agregados sem autenticação usaram os IDs de condição e evento da mesma amostra Gamma; não houve consulta de carteiras. ### Consultar o valor das posições em aberto por condição Ação concluídaData da observação 2026-11-03T12:52:24.459971+00:00 **Ação:** Foi solicitado /v2/oi com o identificador de condição escolhido. **Resultado:** HTTP 200 retornou uma lista data com 1 linha, condition\_id correspondente e value numérico. O guia oficial define o valor das posições em aberto em USDC. **Escopo e limites:** Foram verificadas a forma do agregado e a junção de identificadores, não a reconstrução de saldos ou a correção da contabilidade subjacente. Esta resposta não tinha objeto pagination. [Fonte consultada]() ### Consultar volume de evento preservando a unidade Ação concluídaData da observação 2026-11-03T12:52:24.583387+00:00 **Ação:** Foi solicitado /v2/live-volume com o event\_id escolhido e examinada sua divisão por mercado. **Resultado:** HTTP 200 retornou data.taker\_volume\_total e uma lista conditions com 1 condition\_id correspondente e taker\_volume. O guia oficial define esses volumes em cotas de resultado, não em dólares. **Escopo e limites:** Foi examinada a resposta de um único evento. É volume taker acumulado, não posições em aberto, PnL de carteiras ou um fluxo de ordens; a amostra não valida todos os endpoints analíticos. [Fonte consultada]() Uma mesma condição pode ter um valor de posições em aberto em USDC e um volume taker em cotas. Preserve a unidade e o agrupamento de cada endpoint antes de compará-los. Nenhuma dessas respostas agregadas precisou dos cursores usados na listagem Gamma examinada. Mais detalhes ## Notas e avaliações Avaliação editorial **4,0**de 5 0 avaliação de usuário Redação do PredictionToolkit ### Nossa opinião sobre Polymarket Data API Esses endpoints públicos atendem a painéis de carteiras, análises de atividade e comparações de rankings. A paginação e as condições de P&L de cada endpoint determinam se essas comparações fazem sentido. **Critérios de avaliação:** Utilidade para a tarefa, escopo documentado, clareza de configuração e transparência do acesso e dos custos. **Data da avaliação:** 2026-10-01 **Documentação revisada:** 2026-10-01 Avaliação baseada em documentação. [Como avaliamos]() ### 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. **Seja a primeira pessoa a compartilhar sua experiência** Um exemplo específico ajuda a próxima pessoa a escolher a ferramenta certa. ## Ferramentas relacionadas [Explorar categoria]() ![Plataforma on-chain Goldsky e destinos de entrega]() ![Logotipo de Goldsky]()[Goldsky]() API de dados**4,0**Da redação Replique execuções, posições e saldos para análises, aplicações e alertas próprios. - Acesso API · CLI Crie um conjunto on-chain indexado. ![Documentação oficial de preços e livros Polymarket CLOB]() ![Logotipo de Polymarket CLOB API]()[Polymarket CLOB API]() API de dados**4,0**Da redação Leia preços e profundidade por token de resultado e trate ordens autenticadas por um processo separado de assinatura. - Acesso API Livros ao vivo e ordens. ![Documentação oficial de descoberta Gamma API Polymarket]() ![Logotipo de Polymarket Gamma API]()[Polymarket Gamma API]() API de dados**4,0**Da redação Descubra contratos e identificadores antes de consultar preços executáveis ou criar um catálogo. - Acesso API Metadados de eventos e mercados. ## Guias e fluxos de trabalho - [Chave de API e autenticação do Polymarket]() - [Endpoints do Polymarket: Gamma, CLOB e Data API]() - [O que é o Polymarket?]() ## 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. Neste perfil