Como monitorar posições e atividade de wallets na Polymarket

No mercado de previsão da Polymarket, a atividade de uma carteira (wallet) é um indicador público de estratégia. Diferente de mercados centralizados, onde a execução pode ser ofuscada por algoritmos institucionais, a Polymarket opera sobre a rede Polygon, tornando cada posição e trade verificável publicamente. Monitorar wallets permite aos analistas entender como outros participantes estão posicionados, identificar tendências de acúmulo de certas probabilidades e avaliar a solidez das teses de mercado através do volume financeiro envolvido.

Este guia foca na utilização da Data API v2, que centraliza a leitura de portfólios, feeds de trades e estado de mercados em um contrato de resposta unificado. A distinção entre probabilidade (preço do ativo), execução (preço pago) e resultado realizado (PnL final) é crucial. Por exemplo, comprar o ativo 'Sim' a USDC 0.42 não significa que você tem 42% de certeza, mas sim que o mercado precifica essa probabilidade. Se o ativo resolva para USDC 1.00, o lucro é a diferença entre o valor de face e o custo médio de entrada.

O objetivo aqui é operacionalizar o acesso a esses dados. Não se trata de copiar trading (copy-trading), mas de utilizar dados on-chain para validar teses ou identificar dissonância entre o preço de mercado e a atividade de traders de alto convence. A transparência on-chain oferece uma vantagem assimétrica para quem sabe ler os dados corretamente.

A Data API v2 da Polymarket serve como a camada de abstração para dados on-chain. A base URL é https://data-api.polymarket.com/v2 e não requer autenticação para operações de leitura. Todos os endpoints compartilham um envelope de resposta padronizado contendo 'data' (o conteúdo) e 'pagination' (controle de paginação).

A paginação é baseada em cursores (cursor-based), o que significa que você não usa offsets numéricos simples. Para percorrer um grande conjunto de dados, você envia a primeira requisição, recebe um 'next_cursor' na resposta e o reinseri na requisição seguinte até que o cursor seja nulo. Essa abordagem garante a consistência dos dados mesmo enquanto novas transações ocorrem na blockchain durante sua consulta.

É fundamental compreender as unidades de medida: campos com sufixo '_usdc' representam valores em dólares estáveis, enquanto campos como 'size' ou 'volume' referem-se a shares (tokens) do resultado específico. A distinção é crítica: uma posição de 1000 shares a USDC 0.50 representa uma exposição de USDC 500. O erro de confundir unidades de token com valor monetário é a falha mais comum na análise de portfólios.

O endpoint '/v2/positions' é a ferramenta primária para auditar a exposição atual de uma carteira. Ele retorna uma lista de objetos 'Position' que detalham o status, o tamanho e a rentabilidade de cada posição. O parâmetro 'status' permite filtrar entre posições 'OPEN' (padrão, incluindo vencedoras que ainda não foram resgatadas), 'REDEEMABLE', 'MERGEABLE' ou 'CLOSED'.

Cada posição contém metadados ricos. O campo 'avgPrice' indica o preço médio de aquisição por share em USDC. 'currentValue' é a marcação a mercado (mark-to-market) baseada no preço atual do ativo. A métrica 'unrealizedPnl' calcula a diferença entre o valor atual e o custo de entrada, representando o lucro ou prejuízo latente. Um exemplo numérico: se você comprou 100 shares a USDC 0.40 (custo total USDC 40) e o preço atual é USDC 0.60, seu valor atual é USDC 60 e seu PnL não realizado é de USDC 20.

Para identificar onde uma carteira está mais exposta, você pode ordenar as posições por 'CURRENT_VALUE' ou por 'PRICE'. A ordenação por preço ('PRICE') é útil para identificar apostas 'long shot' (baixo preço, alta aposta) versus 'favorites' (alto preço, margem estreita). A API permite manter os filtros de usuário e status constantes durante a paginação, garantindo que você esteja olhando para o mesmo conjunto de dados.

Para entender a tática de execução, o endpoint '/v2/activity' fornece a linha do tempo das operações. Ao contrário das posições, que são um estado atual, a atividade é um registro permanente de eventos. Os tipos de eventos incluem 'TRADE' (compra/venda), 'SPLIT' (criação de pares Sim/Não), 'MERGE' (combinação de pares), 'REDEEM' (resgate de vencedores) e movimentações de capital ('DEPOSIT', 'WITHDRAWAL').

Um detalhe operacional crítico: por padrão, a API exclui depósitos e saques. Para visualizá-los, é necessário passar o parâmetro 'exclude_deposits_withdrawals=false'. Isso é vital para analisar o fluxo de capital: um trader pode estar fazendo posições grandes usando capital recém-depositado, o que indica alta convicção de curto prazo.

Ao analisar 'TRADE', verifique o campo 'isCombo'. Se for 'true', a operação está associada a uma posição combinada (lógica de múltiplos resultados), o que altera como você interpreta o 'outcome' e o 'conditionId'. A API também permite filtrar por período ('start' e 'end' em segundos epoch), o que facilita a análise de performance trimestral ou diária de uma carteira específica.

Para uma visão agregada de performance, a Polymarket oferece endpoints dedicados para estatísticas. O endpoint '/v2/user-stats' retorna métricas de vida inteira, como o número de mercados distintos onde o usuário operou. Já '/v2/user-pnl' fornece uma série temporal de PnL acumulado, permitindo visualizar a equidade (equity curve) da carteira ao longo do tempo.

A série de PnL é particularmente útil para avaliar a consistência. Um trader pode ter um PnL total alto, mas se a curva for volátil com 'drawdowns' aprofundados, o risco de ruína foi alto. Você pode solicitar intervalos personalizados (ex: 1d, 7d, 1y) para analisar a estabilidade da performance.

O endpoint '/v2/user-volume' mede o volume negociado em um período selecionado. Diferenciar volume em 'shares' versus 'USDC' é importante para comparar traders. Um trader de alto volume em USDC pode estar apenas apostando em mercados de alta liquidez (como eleições), enquanto um de alto volume em shares pode estar operando muitos mercados menores. A métrica 'tradeCount' ajuda a estimar a frequência de operação.

Ao trabalhar com a Data API, é imperativo respeitar os limites de taxa (rate limits). A API pública possui limites por IP para evitar abuso. Respostas de erro podem incluir um header 'Retry-After', indicando o tempo esperado para a nova tentativa. Além disso, a API possui duas vertentes distintas: a plataforma descentralizada global (polymarket.com) e a plataforma dos EUA (polymarket.us), que possuem APIs separadas. Este guia foca na plataforma global/descentralizada.

Do ponto de vista da análise, tenha cuidado ao interpretar o 'status' das posições. Uma posição 'OPEN' com valor de face (USDC 1.00) pode ser tecnicamente 'REDEEMABLE', mas o usuário pode ter demorado para fazer o resgate (redemption) na blockchain. O PnL realizado só é contabilizado quando o resgate é processado. Portanto, o PnL não realizado pode conter ganhos 'no paper' que ainda não foram materializados em USDC.

Finalmente, considere a latência. A API é uma visão estruturada do estado on-chain. Em momentos de alta volatilidade, a sincronização entre a blockchain Polygon e a API pode ter pequenos atrasos. Para decisões de trading em tempo real, a API de CLOB (Central Limit Order Book) para preços e execução é mais apropriada do que a Data API para estados de portfólio.

Monitorar posições e atividade de wallets na Polymarket é um processo sistemático que combina a consulta da Data API v2 com a interpretação financeira dos campos retornados. Ao dominar a estrutura de posições, o histórico de atividade e as métricas de PnL, você transforma dados brutos on-chain em inteligência de mercado. Não se trata de prever o futuro, mas de entender a psicologia e a alocação de capital dos participantes atuais.

A ferramenta mais poderosa que você pode construir a partir desses dados é um dashboard personalizado que trackea carteiras de alto desempenho e alerta sobre novas posições em mercados específicos. A transparência da blockchain é a sua maior aliada, desde que você saiba exatamente onde procurar e como ler as nuances do status das posições.

Para profissionalizar sua análise de mercados de previsão, integre esses dados com fundamentos externos. A AI Midas ajuda a cruzar a atividade on-chain com notícias e odds esportivas para identificar valor real. Inicie sua jornada com os nossos relatórios especializados.