Docs menu

Polymarket API endpoint

Polymarket predictions API

Returns event rows for the Polymarket `/predictions` page. The `status` enum accepts `active`, `resolved`, and `all`; the `sort` enum accepts `competitive`, `volume`, `volume_24hr`, `ending_soon`, `liquidity`, `newest`, and `closed_time`; the `recurrence` enum accepts `hourly`, `daily`, `weekly`, `monthly`, and `yearly`.

GETapiKey0 credits/requestPolymarketpolymarket.predictionsResponseDoc/polymarket/predictions

Endpoint facts

Method: GET
API path: /polymarket/predictions
Auth: apiKey
Credits: 0 credits/request
Charged on: Successful 2xx responses only
Platform: Polymarket
Response schema: #/definitions/polymarket.predictionsResponseDoc

Polymarket Scraper API Try Polymarket predictions API in Playground Polymarket API documentation

How this endpoint behaves

Query parameters:

status: optional prediction status. Allowed values: active, resolved, all. Defaults to active.
sort: optional prediction sort. Allowed values: competitive, volume, volume_24hr, ending_soon, liquidity, newest, closed_time. Defaults to competitive.
tag: optional Polymarket tag slug, for example politics.
recurrence: optional recurrence filter. Allowed values: hourly, daily, weekly, monthly, yearly.
limit: optional maximum events to return. Defaults to 20; maximum 100.
cursor: optional keyset cursor from a prior predictions response.

Notable response behavior:

Mirrors the public /predictions page controls.
status=active sends closed=false; status=resolved sends closed=true; status=all omits the closed filter.
sort=competitive uses competitive ordering. Other allowed sort values are volume, volume_24hr, ending_soon, liquidity, newest, and closed_time.
Empty upstream prediction pages are returned as upstream errors instead of successful empty parser drift.

Sampled response

Request, 14 Oct 2026: GET /polymarket/predictions?limit=20&sort=competitive&status=all
Items in events: 20
Fields filled in every checked item: 17

Field	Filled in, of 20 checked	Values in the sample
id	20
slug	20
title	20	“BNB Up or Down - October 15, 1PM ET” and 19 other values
description	20	median 614 characters
url	20	polymarket.com
image_url	20	polymarket-upload.s3.us-east-2.amazonaws.com
icon_url	20	polymarket-upload.s3.us-east-2.amazonaws.com
active	20	true in 20 of 20
closed	20	true in 0 of 20
restricted	20	true in 20 of 20
start_date	20	2026-10-13
end_date	20	2026-10-14 to 2026-10-15
updated_at	20	2026-10-13
liquidity	20	88.93 to 6,701.75, median 187
tags	20	median 7 entries
markets	20	median 1 entry
markets_count	20	1

Request parameters

Parameter	Type	Required	Default	Description	Example
status	string	No		Prediction status Allowed values: active, resolved, all.
sort	string	No		Prediction sort Allowed values: competitive, volume, volume_24hr, ending_soon, liquidity, newest, closed_time.
tag	string	No		Optional tag slug	politics
recurrence	string	No		Optional recurrence filter Allowed values: hourly, daily, weekly, monthly, yearly.
limit	integer	No	20 and supports up to 100	Maximum events, defaults to 20 and supports up to 100	20
cursor	string	No		Optional keyset cursor from a prior predictions response
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/polymarket/predictions?status=active&sort=competitive&recurrence=hourly&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "status": "all",
    "sort": "competitive",
    "limit": 2,
    "has_more": true,
    "next_cursor": "eyJjb21wZXRpdGl2ZSI6IjAuODgifQ==",
    "source_url": "https://gamma-api.polymarket.com/events/keyset?ascending=false&limit=2&order=competitive",
    "fetched_at": "2026-06-07T11:00:00Z",
    "events": [
      {
        "id": "545095",
        "slug": "bitcoin-above-on-june-7-2026",
        "title": "Bitcoin above ___ on June 7?",
        "url": "https://polymarket.com/event/bitcoin-above-on-june-7-2026",
        "active": true,
        "closed": false,
        "markets_count": 1
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/polymarket.predictionsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.PredictionsResponse	No
data.cursor	string	No		Cursor that was used to fetch this page.
data.events	array	No		Events on this page, one item per event.
data.events[].active	boolean	No		`true` when the event is active.
data.events[].closed	boolean	No		`true` when the event is closed.
data.events[].comment_count	integer	No		Number of comments on the event.
data.events[].description	string	No		Event description as shown on Polymarket.
data.events[].end_date	string	No		Date and time the event is scheduled to end (ISO 8601).
data.events[].featured	boolean	No		`true` when Polymarket features the event.
data.events[].icon_url	string	No		URL of the event's icon image.
data.events[].id	string	No	545095	Polymarket event id.
data.events[].image_url	string	No		URL of the event's main image.
data.events[].liquidity	number	No		Liquidity Polymarket reports for the event.
data.events[].markets	array	No		Markets inside the event, one item per market.
data.events[].markets[].active	boolean	No		`true` when the market is active.
data.events[].markets[].best_ask	number	No		Lowest ask price currently offered on the market.
data.events[].markets[].best_bid	number	No		Highest bid price currently offered on the market.
data.events[].markets[].closed	boolean	No		`true` when the market is closed.
data.events[].markets[].condition_id	string	No	0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327	Condition id that identifies the market on Polymarket.
data.events[].markets[].end_date	string	No		Date and time the market is scheduled to end (ISO 8601).
data.events[].markets[].id	string	No	558934	Polymarket market id.
data.events[].markets[].last_trade_price	number	No		Price of the most recent trade on the market.
data.events[].markets[].liquidity	number	No		Liquidity Polymarket reports for the market.
data.events[].markets[].outcomes	array	No		Outcomes of the market with their current prices, one item per outcome.
data.events[].markets[].outcomes[].best_ask	number	No	0.162	Lowest ask price currently offered for the outcome.
data.events[].markets[].outcomes[].best_bid	number	No	0.161	Highest bid price currently offered for the outcome.
data.events[].markets[].outcomes[].last_trade_price	number	No	0.162	Price of the most recent trade on the outcome.
data.events[].markets[].outcomes[].liquidity	number	No	1093391.84	Liquidity Polymarket reports for the outcome.
data.events[].markets[].outcomes[].market_id	string	No	558934	Polymarket id of the market the outcome belongs to.
data.events[].markets[].outcomes[].market_slug	string	No	will-spain-win-the-2026-fifa-world-cup-963	URL slug of the market the outcome belongs to.
data.events[].markets[].outcomes[].outcome	string	No	Yes	Name of the outcome, for example `Yes`.
data.events[].markets[].outcomes[].price	number	No	0.1615	Current price of the outcome.
data.events[].markets[].outcomes[].question	string	No	Will Spain win the 2026 FIFA World Cup?	Question of the market the outcome belongs to.
data.events[].markets[].outcomes[].volume	number	No	30983849.24	Trading volume Polymarket reports for the outcome.
data.events[].markets[].question	string	No	Will Spain win the 2026 FIFA World Cup?	Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.
data.events[].markets[].slug	string	No	will-spain-win-the-2026-fifa-world-cup-963	URL slug of the market.
data.events[].markets[].token_ids	array	No		Token ids of the market outcomes, in the same order as `outcomes`.
data.events[].markets[].url	string	No	https://polymarket.com/event/world-cup-winner/will-spain-win-the-2026-fifa-world-cup-963	Link to the market on polymarket.com.
data.events[].markets[].volume	number	No		Total trading volume of the market.
data.events[].markets[].volume_24h	number	No		Trading volume of the market over the last 24 hours.
data.events[].markets_count	integer	No	15	Number of markets inside the event.
data.events[].open_interest	number	No		Open interest Polymarket reports for the event.
data.events[].restricted	boolean	No		`true` when Polymarket marks the event as restricted.
data.events[].slug	string	No	bitcoin-above-on-june-7-2026	URL slug of the event.
data.events[].start_date	string	No		Date and time the event starts (ISO 8601).
data.events[].tags	array	No		Tags attached to the event, one item per tag.
data.events[].tags[].id	string	No	21	Polymarket tag id.
data.events[].tags[].label	string	No	Crypto	Display name of the tag, for example `Crypto`.
data.events[].tags[].slug	string	No	crypto	URL slug of the tag, for example `crypto`.
data.events[].title	string	No	Bitcoin above ___ on June 7?	Event title as shown on Polymarket.
data.events[].updated_at	string	No		Time Polymarket last updated the event (ISO 8601).
data.events[].url	string	No	https://polymarket.com/event/bitcoin-above-on-june-7-2026	Link to the event on polymarket.com.
data.events[].volume	number	No		Total trading volume of the event.
data.events[].volume_24h	number	No		Trading volume of the event over the last 24 hours.
data.fetched_at	string	No	2026-06-07T11:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.has_more	boolean	No		`true` when more events are available after this page.
data.limit	integer	No	20	Maximum number of events requested.
data.next_cursor	string	No		Cursor to pass to fetch the next page.
data.recurrence	string	No	daily	Recurrence filter applied: `hourly`, `daily`, `weekly`, `monthly` or `yearly`.
data.sort	string	No	competitive	Sort order applied, for example `competitive`.
data.source_url	string	No	https://gamma-api.polymarket.com/events/keyset?limit=20&order=competitive	URL the data was read from.
data.status	string	No	all	Prediction status filter applied: `active`, `resolved` or `all`.
data.tag	string	No	politics	Polymarket tag slug the events were filtered by.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/polymarket/predictions?status=active&sort=competitive&recurrence=hourly&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Polymarket endpoint docs Polymarket Scraper API Polymarket activity trades API documentation Polymarket CLOB market API documentation Polymarket macro dashboard API documentation Polymarket data followers API documentation Polymarket data following API documentation Polymarket data follow counts API documentation

Open in Playground Back to group

Docs menu

Polymarket API endpoint

Polymarket predictions API

GETapiKey0 credits/requestPolymarketpolymarket.predictionsResponseDoc/polymarket/predictions

Endpoint facts

Method: GET
API path: /polymarket/predictions
Auth: apiKey
Credits: 0 credits/request
Charged on: Successful 2xx responses only
Platform: Polymarket
Response schema: #/definitions/polymarket.predictionsResponseDoc

Polymarket Scraper API Try Polymarket predictions API in Playground Polymarket API documentation

How this endpoint behaves

Query parameters:

status: optional prediction status. Allowed values: active, resolved, all. Defaults to active.
sort: optional prediction sort. Allowed values: competitive, volume, volume_24hr, ending_soon, liquidity, newest, closed_time. Defaults to competitive.
tag: optional Polymarket tag slug, for example politics.
recurrence: optional recurrence filter. Allowed values: hourly, daily, weekly, monthly, yearly.
limit: optional maximum events to return. Defaults to 20; maximum 100.
cursor: optional keyset cursor from a prior predictions response.

Notable response behavior:

Mirrors the public /predictions page controls.
status=active sends closed=false; status=resolved sends closed=true; status=all omits the closed filter.
sort=competitive uses competitive ordering. Other allowed sort values are volume, volume_24hr, ending_soon, liquidity, newest, and closed_time.
Empty upstream prediction pages are returned as upstream errors instead of successful empty parser drift.

Sampled response

Request, 14 Oct 2026: GET /polymarket/predictions?limit=20&sort=competitive&status=all
Items in events: 20
Fields filled in every checked item: 17

Field	Filled in, of 20 checked	Values in the sample
id	20
slug	20
title	20	“BNB Up or Down - October 15, 1PM ET” and 19 other values
description	20	median 614 characters
url	20	polymarket.com
image_url	20	polymarket-upload.s3.us-east-2.amazonaws.com
icon_url	20	polymarket-upload.s3.us-east-2.amazonaws.com
active	20	true in 20 of 20
closed	20	true in 0 of 20
restricted	20	true in 20 of 20
start_date	20	2026-10-13
end_date	20	2026-10-14 to 2026-10-15
updated_at	20	2026-10-13
liquidity	20	88.93 to 6,701.75, median 187
tags	20	median 7 entries
markets	20	median 1 entry
markets_count	20	1

Request parameters

Parameter	Type	Required	Default	Description	Example
status	string	No		Prediction status Allowed values: active, resolved, all.
sort	string	No		Prediction sort Allowed values: competitive, volume, volume_24hr, ending_soon, liquidity, newest, closed_time.
tag	string	No		Optional tag slug	politics
recurrence	string	No		Optional recurrence filter Allowed values: hourly, daily, weekly, monthly, yearly.
limit	integer	No	20 and supports up to 100	Maximum events, defaults to 20 and supports up to 100	20
cursor	string	No		Optional keyset cursor from a prior predictions response
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/polymarket/predictions?status=active&sort=competitive&recurrence=hourly&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "status": "all",
    "sort": "competitive",
    "limit": 2,
    "has_more": true,
    "next_cursor": "eyJjb21wZXRpdGl2ZSI6IjAuODgifQ==",
    "source_url": "https://gamma-api.polymarket.com/events/keyset?ascending=false&limit=2&order=competitive",
    "fetched_at": "2026-06-07T11:00:00Z",
    "events": [
      {
        "id": "545095",
        "slug": "bitcoin-above-on-june-7-2026",
        "title": "Bitcoin above ___ on June 7?",
        "url": "https://polymarket.com/event/bitcoin-above-on-june-7-2026",
        "active": true,
        "closed": false,
        "markets_count": 1
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/polymarket.predictionsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.PredictionsResponse	No
data.cursor	string	No		Cursor that was used to fetch this page.
data.events	array	No		Events on this page, one item per event.
data.events[].active	boolean	No		`true` when the event is active.
data.events[].closed	boolean	No		`true` when the event is closed.
data.events[].comment_count	integer	No		Number of comments on the event.
data.events[].description	string	No		Event description as shown on Polymarket.
data.events[].end_date	string	No		Date and time the event is scheduled to end (ISO 8601).
data.events[].featured	boolean	No		`true` when Polymarket features the event.
data.events[].icon_url	string	No		URL of the event's icon image.
data.events[].id	string	No	545095	Polymarket event id.
data.events[].image_url	string	No		URL of the event's main image.
data.events[].liquidity	number	No		Liquidity Polymarket reports for the event.
data.events[].markets	array	No		Markets inside the event, one item per market.
data.events[].markets[].active	boolean	No		`true` when the market is active.
data.events[].markets[].best_ask	number	No		Lowest ask price currently offered on the market.
data.events[].markets[].best_bid	number	No		Highest bid price currently offered on the market.
data.events[].markets[].closed	boolean	No		`true` when the market is closed.
data.events[].markets[].condition_id	string	No	0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327	Condition id that identifies the market on Polymarket.
data.events[].markets[].end_date	string	No		Date and time the market is scheduled to end (ISO 8601).
data.events[].markets[].id	string	No	558934	Polymarket market id.
data.events[].markets[].last_trade_price	number	No		Price of the most recent trade on the market.
data.events[].markets[].liquidity	number	No		Liquidity Polymarket reports for the market.
data.events[].markets[].outcomes	array	No		Outcomes of the market with their current prices, one item per outcome.
data.events[].markets[].outcomes[].best_ask	number	No	0.162	Lowest ask price currently offered for the outcome.
data.events[].markets[].outcomes[].best_bid	number	No	0.161	Highest bid price currently offered for the outcome.
data.events[].markets[].outcomes[].last_trade_price	number	No	0.162	Price of the most recent trade on the outcome.
data.events[].markets[].outcomes[].liquidity	number	No	1093391.84	Liquidity Polymarket reports for the outcome.
data.events[].markets[].outcomes[].market_id	string	No	558934	Polymarket id of the market the outcome belongs to.
data.events[].markets[].outcomes[].market_slug	string	No	will-spain-win-the-2026-fifa-world-cup-963	URL slug of the market the outcome belongs to.
data.events[].markets[].outcomes[].outcome	string	No	Yes	Name of the outcome, for example `Yes`.
data.events[].markets[].outcomes[].price	number	No	0.1615	Current price of the outcome.
data.events[].markets[].outcomes[].question	string	No	Will Spain win the 2026 FIFA World Cup?	Question of the market the outcome belongs to.
data.events[].markets[].outcomes[].volume	number	No	30983849.24	Trading volume Polymarket reports for the outcome.
data.events[].markets[].question	string	No	Will Spain win the 2026 FIFA World Cup?	Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.
data.events[].markets[].slug	string	No	will-spain-win-the-2026-fifa-world-cup-963	URL slug of the market.
data.events[].markets[].token_ids	array	No		Token ids of the market outcomes, in the same order as `outcomes`.
data.events[].markets[].url	string	No	https://polymarket.com/event/world-cup-winner/will-spain-win-the-2026-fifa-world-cup-963	Link to the market on polymarket.com.
data.events[].markets[].volume	number	No		Total trading volume of the market.
data.events[].markets[].volume_24h	number	No		Trading volume of the market over the last 24 hours.
data.events[].markets_count	integer	No	15	Number of markets inside the event.
data.events[].open_interest	number	No		Open interest Polymarket reports for the event.
data.events[].restricted	boolean	No		`true` when Polymarket marks the event as restricted.
data.events[].slug	string	No	bitcoin-above-on-june-7-2026	URL slug of the event.
data.events[].start_date	string	No		Date and time the event starts (ISO 8601).
data.events[].tags	array	No		Tags attached to the event, one item per tag.
data.events[].tags[].id	string	No	21	Polymarket tag id.
data.events[].tags[].label	string	No	Crypto	Display name of the tag, for example `Crypto`.
data.events[].tags[].slug	string	No	crypto	URL slug of the tag, for example `crypto`.
data.events[].title	string	No	Bitcoin above ___ on June 7?	Event title as shown on Polymarket.
data.events[].updated_at	string	No		Time Polymarket last updated the event (ISO 8601).
data.events[].url	string	No	https://polymarket.com/event/bitcoin-above-on-june-7-2026	Link to the event on polymarket.com.
data.events[].volume	number	No		Total trading volume of the event.
data.events[].volume_24h	number	No		Trading volume of the event over the last 24 hours.
data.fetched_at	string	No	2026-06-07T11:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.has_more	boolean	No		`true` when more events are available after this page.
data.limit	integer	No	20	Maximum number of events requested.
data.next_cursor	string	No		Cursor to pass to fetch the next page.
data.recurrence	string	No	daily	Recurrence filter applied: `hourly`, `daily`, `weekly`, `monthly` or `yearly`.
data.sort	string	No	competitive	Sort order applied, for example `competitive`.
data.source_url	string	No	https://gamma-api.polymarket.com/events/keyset?limit=20&order=competitive	URL the data was read from.
data.status	string	No	all	Prediction status filter applied: `active`, `resolved` or `all`.
data.tag	string	No	politics	Polymarket tag slug the events were filtered by.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/polymarket/predictions?status=active&sort=competitive&recurrence=hourly&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Polymarket predictions API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Polymarket predictions API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related