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 "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.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/biggest-wins | 20 | List the largest winning positions on Polymarket by window and category. Beta. | — |
/books | 20–1880 | Get the order books of up to 150 Polymarket outcome tokens in one request. Beta. | token_ids |
/event | 20 | Get a Polymarket event with all its markets, prices and resolution rules. Beta. | event_id_or_slug |
/event/annotations | 20 | List the dated explanations of a Polymarket event's price moves. Beta. | event_id_or_slug |
/event/comments | 20 | List the comments and replies on a Polymarket event, newest or oldest first, with no depth limit. Beta. | event_id |
/event/insights | 20 | Get the written market context shown on a Polymarket event page. Beta. | event_id_or_slug |
/events | 20 | List Polymarket events by volume, date, tag or title, with each event's markets. Beta. | — |
/leaderboard | 20 | List Polymarket's leaderboard by profit or volume, by window and category. Beta. | — |
/market | 20 | Get a Polymarket market's prices, volume, rules and resolution state. Beta. | market_id_slug_or_condition_id |
/market/holders | 20 | List the largest holders of each outcome of a Polymarket market. Beta. | condition_id |
/market/resolution | 20 | Get how a Polymarket market resolved or is resolving, with the oracle's record. Beta. | condition_id |
/market/stats | 20 | Get a Polymarket market's open interest and taker volume. Beta. | condition_id |
/market/trades | 20 | List the public trade tape of one Polymarket market, newest first. Beta. | condition_id |
/markets | 20 | List Polymarket markets by volume, liquidity, tag or ids, with prices and rules. Beta. | — |
/markets/batch | 20–1260 | Get up to 100 Polymarket markets by condition id or token id. Beta. | — |
/movers | 20 | List the Polymarket markets whose price moved most, with short price histories. Beta. | — |
/perps/instrument/book | 20 | Get the Polymarket perps order book for one instrument. Beta. | instrument_id |
/perps/instrument/klines | 20 | List Polymarket perps candles for one instrument. Beta. | instrument_id |
/perps/instrument/trades | 20 | List recent Polymarket perps trades. Beta. | instrument_id |
/perps/instruments | 20 | List Polymarket's perpetual futures instruments with leverage limits. Beta. | — |
/perps/leaderboard | 20 | List the Polymarket perps leaderboard by profit. Beta. | — |
/perps/tickers | 20 | List Polymarket perps prices, open interest and funding. Beta. | — |
/prices | 20–1880 | Get Polymarket prices for up to 150 outcome tokens in one request. Beta. | token_ids |
/search | 20 | Search Polymarket events, tags and profiles by keyword. Beta. | query |
/series | 20 | List Polymarket event series such as league seasons and recurring markets. Beta. | — |
/series/detail | 20 | Get one Polymarket series and, on request, its recent events. Beta. | id_or_slug |
/sports | 20 | List the sports and leagues Polymarket lists markets for. Beta. | — |
/tag | 20 | Get one Polymarket topic tag, with the tags most related to it. Beta. | id_or_slug |
/tags | 20 | List Polymarket's topic tags. Beta. | — |
/teams | 20 | List the sports teams and fighters Polymarket has markets for. Beta. | — |
/token/price-history | 20 | List the price history of a Polymarket outcome token. Beta. | token_id |
/trades | 20 | List Polymarket trades across all markets or one wallet. Beta. | — |
/us/event | 20 | Get one event on the Polymarket US exchange with its markets. Beta. | id_or_slug |
/us/events | 20 | List events on the separate Polymarket US exchange with their markets. Beta. | — |
/us/market | 20 | Get one market on the Polymarket US exchange, with its order book on request. Beta. | id_or_slug |
/us/series | 20 | List series on the Polymarket US exchange. Beta. | — |
/user | 20 | Get a Polymarket user's public profile and headline statistics by wallet or username. Beta. | wallet_or_username |
/user/activity | 20 | List a Polymarket wallet's trades, splits, merges and redemptions. Beta. | wallet |
/user/pnl | 20 | List a Polymarket wallet's profit and loss over time. Beta. | wallet |
/user/positions | 20 | List a wallet's open, closed and redeemable Polymarket positions with profit. Beta. | wallet |
/user/stats | 20 | Get a Polymarket wallet's profit and loss, volume and biggest win. Beta. | wallet |
/users | 20 | Search Polymarket users by name and get their wallet addresses. Beta. | query |