Polymarket API
Polymarket API — programmatic access to every signal in PolyAlertHub
The PolyAlertHub Polymarket API is a REST + JSON interface for markets, traders, whales, fresh-wallet insiders, leaderboards, and paper trading — built for AI agents, trading bots, quant research, and internal dashboards.
REST endpoints + JSON
Bearer API keys
Trader, whale & fresh-wallet data
50 req / 60s baseline
Per-key rate-limit headers
What is it
A first-class developer API for Polymarket intelligence
Every PolyAlertHub signal — markets, traders, whales, fresh-wallet insiders, leaderboards, paper trading — is available as a clean REST endpoint with a stable JSON shape, Bearer auth, and rate-limit headers.
api.polyalerthub.com · v1
Bearer poly_••••
Endpoints
40+
Rate Limit
50/min
Uptime
99.9%
GET
/elite/getMarketInsights
Event analytics with smart-money signals
GET
/elite/getTopTraders
Ranked traders by PnL / win rate
GET
/elite/getWhaleTrades
Recent whale trades across markets
GET
/elite/getInsiderAnalytics
Fresh-wallet detection dashboard data
POST
/elite/paper-trade/createOrder
Submit a simulated order
auth: Bearer · format: JSON
X-RateLimit-Remaining: 47
Why it matters
Polymarket is great. The default surface area for builders isn't.
Scraping Polymarket is fragile
On-chain feeds and the public UI shift constantly. A stable, versioned API removes a whole category of maintenance work for your team.
Agents need retrieval, not pages
LLM agents want structured JSON they can reason over. PolyAlertHub endpoints are shaped for retrieval — flat, named, deterministic.
Analytics are pre-computed
PnL, win rate, scores, whale signals, and fresh-wallet detection are baked into the API. You consume answers, not raw trades.
Built for production
Bearer auth, per-key rate-limit headers, JSON-only responses, and a documented OpenAPI spec — wire it in once and ship.
How it works
Five steps from subscription to live agent
- 01
Subscribe to the Elite plan
API access is gated to the Elite tier. Upgrade once and every endpoint unlocks for your account.
- 02
Mint an API key
Generate a labelled Bearer key from /api-keys. Keys are per-account; rotate or revoke any key without affecting the others.
- 03
Authenticate every request
Send Authorization: Bearer <key> on every call. The same key works across every /elite/* endpoint.
- 04
Call the endpoint you need
Hit market, trader, whale, insider, or paper-trade endpoints. Responses are plain JSON — agent-ready, no scraping, no SDK lock-in.
- 05
Build agents, bots, dashboards
Wire the data into LLM agents for retrieval, into trading bots for execution, or into internal dashboards for monitoring.
What's inside
Every PolyAlertHub data surface, exposed as REST
Market insight endpoints
Pull enriched market data — events, tags, series, and smart-money signal annotations — through a single retrieval-friendly JSON shape.
Trader analytics endpoints
Ranked top traders, per-wallet stats, leaderboards, and full performance metrics ready to drop into dashboards, agents, or bots.
Whale & insider analytics
Programmatic access to whale trades, whale positions, fresh-wallet insider analytics, consensus signals, convergence, and unusual activity.
Paper trading sandbox
End-to-end paper-trading endpoints — create orders, manage positions, and read PnL — so you can backtest a strategy before going live.
Bearer auth via API keys
Standard Bearer-token auth. Mint, label, and revoke keys from your account; every key is scoped to your subscription's Elite entitlements.
Rate-limit headers
Every response includes X-RateLimit-* headers so clients and agents can self-throttle cleanly without hitting hard 429s.
Access
Built-in tools for every step of integration
OpenAPI spec
Full /api-docs spec with every endpoint, parameter, and response shape — copy-pasteable into any HTTP client or LLM tool.
API key management
Mint, label, rotate, and revoke Bearer keys from /api-keys. Multiple keys per account for separating environments.
Direct support
Email [email protected] for integration help, custom rate limits, or commercial / white-label conversations.
Compare
PolyAlertHub API vs. building it yourself
| Attribute | PolyAlertHub Polymarket API | Roll your own |
|---|---|---|
| Data scope | Markets, traders, whales, fresh wallets, leaderboards, paper trading | Raw CLOB endpoints with no analytics layer |
| Auth model | Bearer API keys, rotate/revoke per key | Public endpoints with no entitlement model |
| Rate limits | 50 req / 60s with X-RateLimit-* headers | Unspecified — silent 429s common |
| Response shape | Stable JSON, retrieval-friendly for agents | Raw on-chain payloads requiring parsing |
| Analytics enrichment | PnL, win-rate, scores, smart-money signals built in | Compute everything yourself |
| Paper trading | Full sandbox endpoints included | Not available |
Use cases
Designed for builders, agents, and quants
AI agent retrieval
Plug PolyAlertHub endpoints into a retrieval tool so your agent can answer 'who are the top Polymarket traders this week' with live data.
Quant + bot research
Stream trader, whale, and fresh-wallet analytics into research notebooks and bot strategies without scraping Polymarket directly.
Internal dashboards
Build private desks, trading rooms, or risk dashboards on top of the same data we use in PolyAlertHub.
Academic & journalism research
Pull historical leaderboard, whale, and insider analytics for write-ups, papers, and on-chain market structure research.
FAQ
Frequently asked questions
Related
Keep exploring PolyAlertHub
Polymarket API product page →
Overview of plans, endpoints, and getting-started flow.
API keys →
Mint, label, rotate, and revoke your Bearer keys.
API documentation →
Full OpenAPI spec for every /elite/* endpoint.
Polymarket Top Traders →
Same data exposed in the product surface.
Polymarket Whales Tracker →
Whale analytics endpoints visualised in-app.
Polymarket Insiders →
Fresh-wallet insider analytics endpoints in product form.
Build on top of Polymarket — without scraping it
Subscribe to Elite, mint a key, and start calling /elite/* in minutes. Agents, bots, dashboards — same API, same data, same SLA.