PolymarketScan
Análisis independiente de Polymarket: recibos de traders verificables, feeds de ballenas, API de agente gratuita y MCP. Sin consejos de trading.
Documentación
API de PolymarketScan — Datos Gratuitos de Polymarket
API REST gratuita para datos on-chain de Polymarket. Accede a perfiles de wallets, PnL, historial de trades, datos de mercado, tablas de clasificación, trades de ballenas y alertas. 30 req/min. Utilizada por más de 160 desarrolladores con más de 526,111 solicitudes atendidas.
Descripción General de la API
URL Base
https://gzydspfquuaudqeztorw.supabase.co/functions/v1/public-api
Límite de Tasa
30 solicitudes por minuto
Formato
REST / JSON
Desarrolladores
160+
Solicitudes Atendidas
526,111+
Costo
Gratis
Inicio Rápido
Pasa tu clave de API mediante el encabezado x-api-key o el parámetro de consulta api_key.
Endpoints de Datos
Perfil de Wallet
Obtén estadísticas de trading para una wallet: PnL, volumen, tasa de victorias, mejor trade.
GET ?endpoint=wallet_profile&address=0x1234...abcd&api_key=YOUR_KEY
Trades de Wallet
Obtén el historial de trades paginado para una wallet específica. Admite limit (máx. 500) y offset.
GET ?endpoint=wallet_trades&address=0x1234...abcd&limit=50&api_key=YOUR_KEY
PnL de Wallet
Obtén el resumen de PnL y la serie temporal diaria para una wallet.
GET ?endpoint=wallet_pnl&address=0x1234...abcd&api_key=YOUR_KEY
Lista de Mercados
Obtén los mercados activos de Polymarket ordenados por volumen de 24h. Admite paginación y filtro por categoría.
GET ?endpoint=markets&limit=10&category=crypto&api_key=YOUR_KEY
Datos de Mercado
Obtén datos detallados para un mercado específico por slug o market_id.
GET ?endpoint=market_data&slug=will-bitcoin-hit-100k&api_key=YOUR_KEY
Tabla de Clasificación
Obtén los mejores traders de Polymarket clasificados por PnL total. Admite limit (máx. 100).
GET ?endpoint=leaderboard&limit=25&api_key=YOUR_KEY
Trades de Ballenas
Trades grandes recientes superiores a $1,000 en todos los mercados de Polymarket.
GET ?endpoint=whale_trades&limit=10&api_key=YOUR_KEY
Trades de Ballenas por Mercado
Trades de ballenas para un mercado específico con estadísticas agregadas: volumen, división compra/venta, wallets únicas.
GET ?endpoint=market_whales&market_slug=will-bitcoin-hit-100k&min_size=5000&limit=20&api_key=YOUR_KEY
Depósitos y Retiros
Obtén todas las transacciones de depósito y retiro de USDC para una wallet de Polymarket en Polygon.
GET ?endpoint=deposits&address=0x1234...abcd&api_key=YOUR_KEY
GET ?endpoint=withdrawals&address=0x1234...abcd&api_key=YOUR_KEY
API de Alertas
Crea alertas de precio, liquidez, tiempo y ballenas. Requiere una clave de API con una dirección de wallet vinculada.
Alertas de Precio
Alerta cuando el precio de un resultado de mercado cruza un umbral (por encima o por debajo).
POST ?endpoint=alerts_create_price&token_id=123&outcome=Yes&above_threshold=0.8&api_key=YOUR_KEY
Alertas de Liquidez
Alerta basada en simulación de llenado: se activa cuando un trade de un tamaño determinado puede llenarse al precio objetivo.
POST ?endpoint=alerts_create_liquidity&token_id=123&outcome=Yes&side=BUY&size_shares=500&api_key=YOUR_KEY
Alertas de Tiempo
Alerta antes de que un mercado cierre/expire.
POST ?endpoint=alerts_create_time&market_end_date=2026-04-01T00:00:00Z&alert_before_minutes=30&api_key=YOUR_KEY
Alertas de Trades de Ballenas
Alerta cuando cualquier wallet (o una wallet específica) realiza un trade por encima de un umbral en USD.
POST ?endpoint=whale_alerts_create_trade&min_size_usd=10000&target_wallet=0x1234...abcd&api_key=YOUR_KEY
Alertas de Depósitos de Ballenas
Alerta sobre depósitos o retiros grandes de USDC para una wallet rastreada.
POST ?endpoint=whale_alerts_create_deposit&target_wallet=0x1234...abcd&min_amount_usd=50000&api_key=YOUR_KEY
Formato de Respuesta
Todas las respuestas devuelven JSON con los campos ok, data y response_time_ms. Los errores devuelven una cadena de error e información sobre el límite de tasa. Ejemplo de respuesta exitosa:
{"ok":true,"data":{...},"response_time_ms":142}
Servidor MCP
PolymarketScan también proporciona un servidor MCP (Model Context Protocol) para la integración con agentes de IA, permitiendo que los agentes de IA consulten directamente los datos de Polymarket mediante llamadas estructuradas a herramientas.
{"@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"]}}