PolymarketScan

API PolymarketScan — Dados Gratuitos da Polymarket

API REST gratuita para dados on-chain da Polymarket. Acesse perfis de carteiras, PnL, histórico de negociações, dados de mercado, rankings, negociações de baleias e alertas. 30 req/min. Usada por mais de 160 desenvolvedores com mais de 526.111 solicitações atendidas.

Visão Geral da API

URL Base

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/public-api

Limite de Solicitações

30 solicitações por minuto

Formato

REST / JSON

Desenvolvedores

160+

Solicitações Atendidas

526.111+

Custo

Gratuito

Início Rápido

Envie sua chave de API pelo cabeçalho x-api-key ou pelo parâmetro de consulta api_key.

GET https://gzydspfquuaudqeztorw.supabase.co/functions/v1/public-api?endpoint=markets&limit=10&api_key=YOUR_KEY

Endpoints de Dados

Perfil da Carteira

Obtenha estatísticas de negociação de uma carteira: PnL, volume, taxa de vitórias, melhor negociação.

GET ?endpoint=wallet_profile&address=0x1234...abcd&api_key=YOUR_KEY

Negociações da Carteira

Obtenha histórico paginado de negociações de uma carteira específica. Suporta limit (máx. 500) e offset.

GET ?endpoint=wallet_trades&address=0x1234...abcd&limit=50&api_key=YOUR_KEY

PnL da Carteira

Obtenha resumo de PnL e série temporal diária de uma carteira.

GET ?endpoint=wallet_pnl&address=0x1234...abcd&api_key=YOUR_KEY

Lista de Mercados

Obtenha mercados ativos da Polymarket ordenados por volume em 24h. Suporta paginação e filtro por categoria.

GET ?endpoint=markets&limit=10&category=crypto&api_key=YOUR_KEY

Dados do Mercado

Obtenha dados detalhados de um mercado específico por slug ou market_id.

GET ?endpoint=market_data&slug=will-bitcoin-hit-100k&api_key=YOUR_KEY

Ranking

Obtenha os principais traders da Polymarket classificados por PnL total. Suporta limit (máx. 100).

GET ?endpoint=leaderboard&limit=25&api_key=YOUR_KEY

Negociações de Baleias

Grandes negociações recentes acima de US$ 1.000 em todos os mercados da Polymarket.

GET ?endpoint=whale_trades&limit=10&api_key=YOUR_KEY

Negociações de Baleias por Mercado

Negociações de baleias para um mercado específico com estatísticas agregadas: volume, divisão de compra/venda, carteiras únicas.

GET ?endpoint=market_whales&market_slug=will-bitcoin-hit-100k&min_size=5000&limit=20&api_key=YOUR_KEY

Depósitos e Saques

Busque todas as transações de depósito e saque em USDC para uma carteira da Polymarket na Polygon.

GET ?endpoint=deposits&address=0x1234...abcd&api_key=YOUR_KEY

GET ?endpoint=withdrawals&address=0x1234...abcd&api_key=YOUR_KEY

API de Alertas

Crie alertas de preço, liquidez, tempo e baleias. Requer uma chave de API com endereço de carteira vinculado.

Alertas de Preço

Alerta quando o preço de um resultado de mercado cruza um limite (acima ou abaixo).

POST ?endpoint=alerts_create_price&token_id=123&outcome=Yes&above_threshold=0.8&api_key=YOUR_KEY

Alertas de Liquidez

Alerta baseado em simulação de preenchimento — dispara quando uma negociação de determinado tamanho pode ser preenchida no preço-alvo.

POST ?endpoint=alerts_create_liquidity&token_id=123&outcome=Yes&side=BUY&size_shares=500&api_key=YOUR_KEY

Alertas de Tempo

Alerta antes do fechamento/expiração de um mercado.

POST ?endpoint=alerts_create_time&market_end_date=2026-04-01T00:00:00Z&alert_before_minutes=30&api_key=YOUR_KEY

Alertas de Negociações de Baleias

Alerta quando qualquer carteira (ou uma carteira específica) faz uma negociação acima de um limite em USD.

POST ?endpoint=whale_alerts_create_trade&min_size_usd=10000&target_wallet=0x1234...abcd&api_key=YOUR_KEY

Alertas de Depósitos de Baleias

Alerta sobre grandes depósitos ou saques em USDC para uma carteira monitorada.

POST ?endpoint=whale_alerts_create_deposit&target_wallet=0x1234...abcd&min_amount_usd=50000&api_key=YOUR_KEY

Formato de Resposta

Todas as respostas retornam JSON com os campos ok, data e response_time_ms. Erros retornam uma string de erro e informações de limite de solicitações. Exemplo de resposta de sucesso:

{"ok":true,"data":{...},"response_time_ms":142}

Servidor MCP

O PolymarketScan também fornece um servidor MCP (Model Context Protocol) para integração com agentes de IA, permitindo que agentes de IA consultem diretamente dados da Polymarket por meio de chamadas de ferramentas estruturadas.

{"@context":"https://schema.org","@type":"WebPage","name":"PolymarketScan API — Free Polymarket Data API for Developers and AI Agents","url":"https://polymarketscan.org/api","description":"Free REST API for Polymarket on-chain data. Access wallet profiles, PnL, trade history, market data, leaderboards, whale trades, and alerts. 30 req/min. Used by 160+ developers with 526,111+ requests served.","mainEntity":{"@type":"SoftwareApplication","name":"PolymarketScan API","applicationCategory":"DeveloperApplication","operatingSystem":"Web","description":"Free REST API for Polymarket on-chain data. Access wallet profiles, PnL, trade history, market data, leaderboards, whale trades, and alerts. 30 req/min. Used by 160+ developers with 526,111+ requests served.","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"featureList":["Wallet PnL and trade history","Real-time market odds and volume","Whale trade tracking","Price and liquidity alerts","Polymarket leaderboard","MCP server for AI agents","30 requests per minute free tier"]}}