InsightSocial API

Polymarket

Polymarket API reference: 42 endpoints for markets, prices, trades, holders and wallets. Per-endpoint credit prices and cURL examples.

Polymarket events, markets, prices, order books, price history, trades, holders, wallets, comments and leaderboards. Read-only.

Base path: /v1/polymarket/...

Quickstart

cURL
curl "https://api.insightsocial.app/v1/polymarket/tag?id_or_slug=politics" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Endpoints

3 of these are metered: the price depends on how much the call reads. See Credits.

Every endpoint here is beta: it returns the platform's own structure under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp), not a schema-2 entity, and its fields may change. See Beta endpoints.

EndpointCreditsWhat it returnsKey parameters
/biggest-wins20List the largest winning positions on Polymarket by window and category. Beta.—
/books20–1880Get the order books of up to 150 Polymarket outcome tokens in one request. Beta.token_ids
/event20Get a Polymarket event with all its markets, prices and resolution rules. Beta.event_id_or_slug
/event/annotations20List the dated explanations of a Polymarket event's price moves. Beta.event_id_or_slug
/event/comments20List the comments and replies on a Polymarket event, newest or oldest first, with no depth limit. Beta.event_id
/event/insights20Get the written market context shown on a Polymarket event page. Beta.event_id_or_slug
/events20List Polymarket events by volume, date, tag or title, with each event's markets. Beta.—
/leaderboard20List Polymarket's leaderboard by profit or volume, by window and category. Beta.—
/market20Get a Polymarket market's prices, volume, rules and resolution state. Beta.market_id_slug_or_condition_id
/market/holders20List the largest holders of each outcome of a Polymarket market. Beta.condition_id
/market/resolution20Get how a Polymarket market resolved or is resolving, with the oracle's record. Beta.condition_id
/market/stats20Get a Polymarket market's open interest and taker volume. Beta.condition_id
/market/trades20List the public trade tape of one Polymarket market, newest first. Beta.condition_id
/markets20List Polymarket markets by volume, liquidity, tag or ids, with prices and rules. Beta.—
/markets/batch20–1260Get up to 100 Polymarket markets by condition id or token id. Beta.—
/movers20List the Polymarket markets whose price moved most, with short price histories. Beta.—
/perps/instrument/book20Get the Polymarket perps order book for one instrument. Beta.instrument_id
/perps/instrument/klines20List Polymarket perps candles for one instrument. Beta.instrument_id
/perps/instrument/trades20List recent Polymarket perps trades. Beta.instrument_id
/perps/instruments20List Polymarket's perpetual futures instruments with leverage limits. Beta.—
/perps/leaderboard20List the Polymarket perps leaderboard by profit. Beta.—
/perps/tickers20List Polymarket perps prices, open interest and funding. Beta.—
/prices20–1880Get Polymarket prices for up to 150 outcome tokens in one request. Beta.token_ids
/search20Search Polymarket events, tags and profiles by keyword. Beta.query
/series20List Polymarket event series such as league seasons and recurring markets. Beta.—
/series/detail20Get one Polymarket series and, on request, its recent events. Beta.id_or_slug
/sports20List the sports and leagues Polymarket lists markets for. Beta.—
/tag20Get one Polymarket topic tag, with the tags most related to it. Beta.id_or_slug
/tags20List Polymarket's topic tags. Beta.—
/teams20List the sports teams and fighters Polymarket has markets for. Beta.—
/token/price-history20List the price history of a Polymarket outcome token. Beta.token_id
/trades20List Polymarket trades across all markets or one wallet. Beta.—
/us/event20Get one event on the Polymarket US exchange with its markets. Beta.id_or_slug
/us/events20List events on the separate Polymarket US exchange with their markets. Beta.—
/us/market20Get one market on the Polymarket US exchange, with its order book on request. Beta.id_or_slug
/us/series20List series on the Polymarket US exchange. Beta.—
/user20Get a Polymarket user's public profile and headline statistics by wallet or username. Beta.wallet_or_username
/user/activity20List a Polymarket wallet's trades, splits, merges and redemptions. Beta.wallet
/user/pnl20List a Polymarket wallet's profit and loss over time. Beta.wallet
/user/positions20List a wallet's open, closed and redeemable Polymarket positions with profit. Beta.wallet
/user/stats20Get a Polymarket wallet's profit and loss, volume and biggest win. Beta.wallet
/users20Search Polymarket users by name and get their wallet addresses. Beta.query

On this page