InsightSocial

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"
200 OKJSON
{
"success": true,
"platform": "polymarket",
"endpoint": "/v1/polymarket/market",
"schema_version": "2",
"data": {
"market": {
"id": "559652",
"slug": "example-market-slug",
"question": "Will the example event happen by December 31?",
"event_id": "30829",
"status": "open",
"outcomes": [
{
"name": "Yes",
"token_id": "54533043819946592547",
"price": 0.1485
},
{
"name": "No",
"token_id": "87854174148074652060",
"price": 0.8515
}
],
"last_trade_price": 0.149,
"best_bid": 0.148,
"best_ask": 0.149,
"volume": {
"total": 28147074.62,
"day": 12531.92
}
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

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.

EndpointCreditsWhat it returns
/biggest-wins20List the largest winning positions on Polymarket by window and category.
/books20–1,880Get the order books of up to 150 Polymarket outcome tokens in one request.
/event20Get a Polymarket event with all its markets, prices and resolution rules.
/event/annotations20List the dated explanations of a Polymarket event's price moves.
/event/comments20List the comments and replies on a Polymarket event, newest or oldest first, with no depth limit.
/event/insights20Get the written market context shown on a Polymarket event page.
/events20List Polymarket events by volume, date, tag or title, with each event's markets.
/leaderboard20List Polymarket's leaderboard by profit or volume, by window and category.
/market20Get a Polymarket market's prices, volume, rules and resolution state.
/market/holders20List the largest holders of each outcome of a Polymarket market.
/market/resolution20Get how a Polymarket market resolved or is resolving, with the oracle's record.
/market/stats20Get a Polymarket market's open interest and taker volume.
/market/trades20List the public trade tape of one Polymarket market, newest first.
/markets20List Polymarket markets by volume, liquidity, tag or ids, with prices and rules.
/markets/batch20–1,260Get up to 100 Polymarket markets by condition id or token id.
/movers20List the Polymarket markets whose price moved most, with short price histories.
/perps/instrument/book20Get the Polymarket perps order book for one instrument.
/perps/instrument/klines20List Polymarket perps candles for one instrument.
/perps/instrument/trades20List recent Polymarket perps trades.
/perps/instruments20List Polymarket's perpetual futures instruments with leverage limits.
/perps/leaderboard20List the Polymarket perps leaderboard by profit.
/perps/tickers20List Polymarket perps prices, open interest and funding.
/prices20–1,880Get Polymarket prices for up to 150 outcome tokens in one request.
/search20Search Polymarket events, tags and profiles by keyword.
/series20List Polymarket event series such as league seasons and recurring markets.
/series/detail20Get one Polymarket series and, on request, its recent events.
/sports20List the sports and leagues Polymarket lists markets for.
/tag20Get one Polymarket topic tag, with the tags most related to it.
/tags20List Polymarket's topic tags.
/teams20List the sports teams and fighters Polymarket has markets for.
/token/price-history20List the price history of a Polymarket outcome token.
/trades20List Polymarket trades across all markets or one wallet.
/us/event20Get one event on the Polymarket US exchange with its markets.
/us/events20List events on the separate Polymarket US exchange with their markets.
/us/market20Get one market on the Polymarket US exchange, with its order book on request.
/us/series20List series on the Polymarket US exchange.
/user20Get a Polymarket user's public profile and headline statistics by wallet or username.
/user/activity20List a Polymarket wallet's trades, splits, merges and redemptions.
/user/pnl20List a Polymarket wallet's profit and loss over time.
/user/positions20List a wallet's open, closed and redeemable Polymarket positions with profit.
/user/stats20Get a Polymarket wallet's profit and loss, volume and biggest win.
/users20Search 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 APIOfficial Polymarket API
AccessOne API keyOpen for reading; no key needed
ShapeOne envelope and cursor paging across every endpointSeveral separate APIs, each with its own shape
TradingNot offered: read-only dataOrders through a signed wallet
Cost per call20 creditsFree 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.

Use it from Claude or ChatGPT

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.