Polymarket APIpolymarket.com ↗
Access Polymarket prediction market data: events, order books, price history, leaderboards, and commodity direction markets via 11 structured endpoints.
What is the Polymarket API?
This API exposes 11 endpoints covering Polymarket's prediction market data, from full-text event search via search_markets to real-time order book depth, historical price series, trader leaderboards, and specialized commodity ladder and direction markets. Each endpoint returns structured JSON with concrete fields like CLOB token IDs, bid/ask spreads, volume metrics, and resolution status — enough to build trading dashboards, probability trackers, or quantitative research pipelines without touching Polymarket directly.
curl -X GET 'https://api.parse.bot/scraper/20b82f08-34e9-4c9e-91cd-eb4ff7b7814f/search_markets?limit=5&query=bitcoin' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over prediction market events by keyword. Returns matching events with their associated markets, current prices, and status. has_more indicates additional results exist beyond the returned set.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return per type. |
| queryrequired | string | Search keyword to find prediction market events. |
{
"type": "object",
"fields": {
"query": "string — the search keyword used",
"events": "array of event objects with nested markets, prices, and status",
"has_more": "boolean — whether more results are available",
"total_results": "integer — number of events returned"
},
"sample": {
"data": {
"query": "bitcoin",
"events": [
{
"id": "555627",
"slug": "bitcoin-above-on-june-10-2026",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
"title": "Bitcoin above ___ on June 10?",
"active": true,
"closed": false,
"markets": [
{
"slug": "bitcoin-above-58k-on-june-10-2026",
"active": true,
"closed": false,
"spread": 0.002,
"best_ask": 0.98,
"best_bid": 0.978,
"outcomes": [
"Yes",
"No"
],
"question": "Will the price of Bitcoin be above $58,000 on June 10?",
"outcome_prices": [
"0.979",
"0.021"
],
"group_item_title": "58,000",
"last_trade_price": 0.979
}
],
"end_date": "2026-06-10T16:00:00Z",
"neg_risk": false,
"start_date": "2026-06-03T16:26:45.640718Z"
}
],
"has_more": true,
"total_results": 10
},
"status": "success"
}
}About the Polymarket API
Market Discovery and Event Data
search_markets accepts a query string and returns matching event objects with nested markets, current prices, and a has_more flag for pagination awareness. get_trending_markets returns events sorted by 24-hour trading volume, each carrying yes/no prices and liquidity figures. get_top_markets adds filtering by category, active, and closed status, plus offset-based pagination and configurable order and ascending sort direction. get_event_details accepts an event slug and returns the full event record: title, description, volume, liquidity, markets_count, and a markets array where each entry includes CLOB token IDs needed for order book and price history queries.
Order Books and Price Data
get_order_book accepts comma-separated CLOB token IDs and returns per-token bids, asks, tick_size, and last_trade_price. get_price_history takes a single token_id plus optional interval and fidelity (minutes between points) and returns a time series of {t, p} objects — unix timestamp and price. get_last_trade_prices returns the most recent price and side (BUY or SELL) for one or more tokens in a single call. get_event_price_history_by_date fetches the full intraday price series for every outcome token within an event on a specific calendar date (America/New_York), with optional market_filter substring matching and a max_markets cap of 20.
Leaderboard and Commodity Markets
get_leaderboard returns ranked traders with wallet_address, name, profit_loss, and volume, plus a biggest_wins array — filterable by timeframe and sort metric. Two specialized endpoints handle commodity prediction markets: get_daily_commodity_closing_ladder returns a descending ladder of strike thresholds for WTI crude, gold, silver, or natural gas on a given target_date, with each rung carrying bid, ask, midpoint, spread, and yes/no probabilities. get_daily_commodity_direction_market returns the binary Up/Down market for the same commodities, including last_trade_price, best_bid, best_ask, midpoint, spread, and an optional as_of parameter for point-in-time historical snapshots.
Status Fields and Error Handling
Endpoints that may fail to find data return explicit status strings such as no_market_for_date, unsupported_commodity, partial_ladder, and historical_snapshot_unavailable rather than silent empty arrays. The get_event_price_history_by_date response includes a failures array listing any per-token fetch errors with status_code and error details, and a truncated boolean when results exceed max_markets.
The Polymarket API is a managed, monitored endpoint for polymarket.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when polymarket.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official polymarket.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track real-time implied probabilities for political or economic events using yes/no prices from
get_trending_markets - Build an order book visualizer for any Polymarket token using bids and asks from
get_order_book - Plot intraday probability curves for election or sports markets with
get_event_price_history_by_dateat custom fidelity - Monitor commodity settlement probability ladders for WTI crude or gold using
get_daily_commodity_closing_ladder - Rank top traders by profit-loss or volume over custom timeframes with
get_leaderboardbiggest_wins data - Discover active markets in a specific category (e.g. crypto, sports) using
get_top_marketswith category and active filters - Compare directional bias in gold or natural gas markets by polling
get_daily_commodity_direction_marketacross multiple dates
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Polymarket have an official developer API?+
How do I get the token IDs needed for order book and price history queries?+
get_event_details returns a markets array where each market object includes clob_token_ids. Pass those values as the token_ids parameter to get_order_book or get_last_trade_prices, or as the single token_id parameter to get_price_history.What commodities are supported by the closing ladder and direction market endpoints?+
get_daily_commodity_closing_ladder supports WTI crude oil (aliases: WTI, crude), gold (XAUUSD), silver (XAGUSD), and natural gas (NG). get_daily_commodity_direction_market supports gold, silver, and natural gas. Neither endpoint currently covers equity indices, soft commodities, or FX pairs. You can fork this API on Parse and revise it to add those markets.Can I retrieve historical snapshots of the commodity direction market at a specific point in time?+
get_daily_commodity_direction_market accepts an as_of ISO 8601 timestamp parameter and returns the last available probability at or before that time. However, per-token history is not aggregated for get_daily_commodity_closing_ladder — passing as_of there returns a historical_snapshot_unavailable status. You can fork this API on Parse and revise it to aggregate per-rung history if needed.Does the leaderboard include individual trade history or position details for a wallet address?+
get_leaderboard returns aggregate profit_loss and volume per trader, plus a biggest_wins array with event-level win data. Individual trade history, open positions, or per-market breakdowns for a specific wallet are not currently exposed. You can fork this API on Parse and revise it to add a wallet-level endpoint pulling that data.