PolymarketScan
Análises independentes da Polymarket - recibos verificáveis de traders, feeds de baleias, Agent API gratuito e MCP. Sem conselhos de negociação.
Documentação
API PolymarketScan — Dados gratuitos da Polymarket
API REST gratuita para dados on-chain da Polymarket. Acesse perfis de carteira, 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 requisições
30 requisições por minuto
Formato
REST / JSON
Desenvolvedores
160+
Solicitações Atendidas
526,111+
Custo
Grátis
Início Rápido
Envie sua chave de API via cabeçalho x-api-key ou parâmetro de consulta api_key.
Endpoints de Dados
Perfil da Carteira
Obtenha estatísticas de negociação para uma carteira: PnL, volume, taxa de vitória, melhor negociação.
GET ?endpoint=wallet_profile&address=0x1234...abcd&api_key=YOUR_KEY
Negociações da Carteira
Obtenha histórico de negociações paginado para 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 para uma carteira.
GET ?endpoint=wallet_pnl&address=0x1234...abcd&api_key=YOUR_KEY
Lista de Mercados
Obtenha mercados ativos da Polymarket ordenados por volume de 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 para 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
Negociações grandes recentes acima de $1,000 em todos os mercados da Polymarket.
GET ?endpoint=whale_trades&limit=10&api_key=YOUR_KEY
Negociações de Baleias do Mercado
Negociações de baleias para um mercado específico com estatísticas agregadas: volume, divisão 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 de USDC para uma carteira 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 um 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 ao 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 de um mercado fechar/expirar.
POST ?endpoint=alerts_create_time&market_end_date=2026-04-01T00:00:00Z&alert_before_minutes=30&api_key=YOUR_KEY
Alertas de Negociação 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ósito de Baleias
Alerta sobre depósitos ou saques grandes de USDC para uma carteira rastreada.
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 campos ok, data e response_time_ms. Erros retornam uma string de erro e informações de limite de taxa. 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"]}}