PolymarketScan

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, leaderboards, trades de ballenas y alertas. 30 req/min. Utilizada por más de 160 desarrolladores con más de 526,111 solicitudes atendidas.

Resumen de la API

URL Base

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

Límite de Solicitudes

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.

GET https://gzydspfquuaudqeztorw.supabase.co/functions/v1/public-api?endpoint=markets&limit=10&api_key=YOUR_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 un resumen de PnL y series temporales diarias 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

Leaderboard

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 únicos.

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 tamaño determinado puede ejecutarse 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 solicitudes. 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"]}}