Polymarket scraper API
The InsightSocial Polymarket API has 42 endpoints, from 20 credits a call. A market call costs 20 credits, about $0.02 on Pro, and your first 10 calls up to 100 credits each are free.
The Polymarket data API for events, markets, prices, order books, price history, trades, top holders and public wallet positions, as JSON, on the same key as every other platform.
42 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/polymarket/market?market_id_slug_or_condition_id=example-market-slug" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Polymarket data can you get?
Public Polymarket data only, in the same JSON envelope as every other platform. Every Polymarket endpoint is beta: inside data it returns Polymarket's own structure under our naming rules (snake_case keys, string ids, ISO times where Polymarket gives a timestamp), not the shared profile and post schema, and fields may change.
Events and markets
An event with all its markets, prices and resolution rules, one market's prices, volume and resolution state, and lists by volume, tag, date or title.
Prices, books and history
Prices and order books for up to 150 outcome tokens, a token's price history, the markets that moved most, and open interest and volume.
Trades, holders and wallets
A market's trade tape and largest holders, and a public wallet's positions, activity, profit and loss over time.
Context, comments and leaderboards
The written context and dated explanations of price moves on an event, its comments, the leaderboard and the biggest wins.
What people build with the Polymarket API
Market research and journalism
Track how the implied probability of an event moved over time, with the dated explanations Polymarket attaches to big moves.
Dashboards
Pull prices for up to 150 outcome tokens in one call and the day's biggest movers to keep a dashboard current.
Wallet and holder analysis
See who holds the most of each outcome in a market, and a public wallet's positions and profit and loss.
Polymarket API endpoints
All 42 Polymarket endpoints and their price in credits. 3 are metered: they show a range and charge what the call actually read.
| Endpoint | Credits | What it returns |
|---|---|---|
| /biggest-wins | 20 | List the largest winning positions on Polymarket by window and category. |
| /books | 20–1,880 | Get the order books of up to 150 Polymarket outcome tokens in one request. |
| /event | 20 | Get a Polymarket event with all its markets, prices and resolution rules. |
| /event/annotations | 20 | List the dated explanations of a Polymarket event's price moves. |
| /event/comments | 20 | List the comments and replies on a Polymarket event, newest or oldest first, with no depth limit. |
| /event/insights | 20 | Get the written market context shown on a Polymarket event page. |
| /events | 20 | List Polymarket events by volume, date, tag or title, with each event's markets. |
| /leaderboard | 20 | List Polymarket's leaderboard by profit or volume, by window and category. |
| /market | 20 | Get a Polymarket market's prices, volume, rules and resolution state. |
| /market/holders | 20 | List the largest holders of each outcome of a Polymarket market. |
| /market/resolution | 20 | Get how a Polymarket market resolved or is resolving, with the oracle's record. |
| /market/stats | 20 | Get a Polymarket market's open interest and taker volume. |
| /market/trades | 20 | List the public trade tape of one Polymarket market, newest first. |
| /markets | 20 | List Polymarket markets by volume, liquidity, tag or ids, with prices and rules. |
| /markets/batch | 20–1,260 | Get up to 100 Polymarket markets by condition id or token id. |
| /movers | 20 | List the Polymarket markets whose price moved most, with short price histories. |
| /perps/instrument/book | 20 | Get the Polymarket perps order book for one instrument. |
| /perps/instrument/klines | 20 | List Polymarket perps candles for one instrument. |
| /perps/instrument/trades | 20 | List recent Polymarket perps trades. |
| /perps/instruments | 20 | List Polymarket's perpetual futures instruments with leverage limits. |
| /perps/leaderboard | 20 | List the Polymarket perps leaderboard by profit. |
| /perps/tickers | 20 | List Polymarket perps prices, open interest and funding. |
| /prices | 20–1,880 | Get Polymarket prices for up to 150 outcome tokens in one request. |
| /search | 20 | Search Polymarket events, tags and profiles by keyword. |
| /series | 20 | List Polymarket event series such as league seasons and recurring markets. |
| /series/detail | 20 | Get one Polymarket series and, on request, its recent events. |
| /sports | 20 | List the sports and leagues Polymarket lists markets for. |
| /tag | 20 | Get one Polymarket topic tag, with the tags most related to it. |
| /tags | 20 | List Polymarket's topic tags. |
| /teams | 20 | List the sports teams and fighters Polymarket has markets for. |
| /token/price-history | 20 | List the price history of a Polymarket outcome token. |
| /trades | 20 | List Polymarket trades across all markets or one wallet. |
| /us/event | 20 | Get one event on the Polymarket US exchange with its markets. |
| /us/events | 20 | List events on the separate Polymarket US exchange with their markets. |
| /us/market | 20 | Get one market on the Polymarket US exchange, with its order book on request. |
| /us/series | 20 | List series on the Polymarket US exchange. |
| /user | 20 | Get a Polymarket user's public profile and headline statistics by wallet or username. |
| /user/activity | 20 | List a Polymarket wallet's trades, splits, merges and redemptions. |
| /user/pnl | 20 | List a Polymarket wallet's profit and loss over time. |
| /user/positions | 20 | List a wallet's open, closed and redeemable Polymarket positions with profit. |
| /user/stats | 20 | Get a Polymarket wallet's profit and loss, volume and biggest win. |
| /users | 20 | Search Polymarket users by name and get their wallet addresses. |
Parameters, response fields and examples for each endpoint are in the Polymarket API reference.
InsightSocial vs the official Polymarket API
Polymarket publishes public APIs for markets, prices, order books and trades that are free to read without a key; placing orders needs a wallet and signed requests.
| InsightSocial API | Official Polymarket API | |
|---|---|---|
| Access | One API key | Open for reading; no key needed |
| Shape | One envelope and cursor paging across every endpoint | Several separate APIs, each with its own shape |
| Trading | Not offered: read-only data | Orders through a signed wallet |
| Cost per call | 20 credits | Free to read |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Polymarket API cost?
Polymarket calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 500 market lookups at 20 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats and retries
A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Polymarket data in plain English. Same account, same credits.
Polymarket API: frequently asked questions
If you only need Polymarket, its own APIs are free to read and a fine choice. This one puts markets, prices, trades, wallets and comments behind one key and one response envelope, with the same paging, errors and credit balance as every other platform you read.
Yes. /v1/polymarket/token/price-history takes an outcome token_id from any market and returns its price over an interval or a date range, with the point spacing you choose.
No. It is read-only public data: markets, prices, books, trades and public wallet records. Nothing here is advice about any market.
They return Polymarket's own record shapes under our naming rules (snake_case keys, string ids and ISO times), so fields may change. Most endpoints are 20 credits a call. Bulk prices and order books are metered from 20 to 1,880 credits and markets in bulk from 20 to 1,260, by how much they read. Calls that fail or find nothing are free.
No. There is no Polymarket app, OAuth flow or review. One API key in the x-api-key header works for Polymarket and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Polymarket's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Polymarket API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google Ads Transparency scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hacker News scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Letterboxd scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yahoo Finance scraper API
- Yelp scraper API