Docs menu

Polymarket API endpoint

Polymarket homepage feed API

Returns rows for Polymarket homepage feeds. The `feed` enum accepts `trending`, `breaking`, `new`, `politics`, `sports`, `crypto`, `esports`, `iran`, `finance`, `geopolitics`, `tech`, `culture`, `economy`, `weather`, `mentions`, and `elections`. Most feeds return events; `breaking` returns high-movement market rows and `mentions` returns open event search matches.

GETapiKey0 credits/requestPolymarketpolymarket.homepageFeedResponseDoc/polymarket/homepage/feed

Endpoint facts

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

Polymarket Scraper API Try Polymarket homepage feed API in Playground Polymarket API documentation

How this endpoint behaves

Query parameters:

feed: optional homepage feed. Allowed values: trending, breaking, new, politics, sports, crypto, esports, iran, finance, geopolitics, tech, culture, economy, weather, mentions, elections. Defaults to trending.
limit: optional maximum rows to return. Defaults to 20; maximum 100.
cursor: optional keyset cursor from a prior event feed response. Applies to feeds backed by event keyset pagination.

Notable response behavior:

Most feeds return Polymarket event rows.
breaking returns high-movement market rows and sets source_kind to markets_movers.
mentions returns open event search matches and sets source_kind to public_search.
Empty upstream feed pages are returned as upstream errors instead of successful empty parser drift.

Sampled response

Request, 14 Oct 2026: GET /polymarket/homepage/feed?feed=politics&limit=20
Items in events: 20
Fields filled in every checked item: 20
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
id	20
slug	20
title	20
description	20	median 914 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	2025-07-06 to 2026-10-12
end_date	20	2026-10-11 to 2029-01-01
updated_at	20	2026-10-13
volume	20	189,173.27 to 1,293,883,862.38, median 11,914,325.01
volume_24h	20	164,148.75 to 1,006,372.16, median 292,144.65
liquidity	20	20,195.76 to 75,945,012.77, median 748,518.84
open_interest	20	26,402.11 to 42,359,344.93, median 1,632,091.51
tags	20	median 7 entries
markets	20	median 10 entries
markets_count	20	1 to 128, median 10
featured	11	true in 11 of 11
comment_count	14	1 to 23,157, median 371

Request parameters

Parameter	Type	Required	Default	Description	Example
feed	string	No		Homepage feed Allowed values: trending, breaking, new, politics, sports, crypto, esports, iran, finance, geopolitics, tech, culture, economy, weather, mentions, elections.
limit	integer	No	20 and supports up to 100	Maximum rows, defaults to 20 and supports up to 100	20
cursor	string	No		Optional keyset cursor from a prior event feed response
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/polymarket/homepage/feed?feed=trending&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "feed": "politics",
    "source_kind": "events_keyset",
    "limit": 2,
    "has_more": true,
    "next_cursor": "eyJ2b2x1bWUyNGhyIjoiMTIzIn0=",
    "source_url": "https://gamma-api.polymarket.com/events/keyset?active=true&ascending=false&closed=false&limit=2&order=volume24hr&tag_slug=politics",
    "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.homepageFeedResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.HomepageFeedResponse	No
data.cursor	string	No		Cursor that was used to fetch this page.
data.events	array	No		Event rows in the feed, 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.feed	string	No	politics	Homepage feed that was requested, for example `politics`.
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 rows are available after this page.
data.limit	integer	No	20	Maximum number of rows requested.
data.markets	array	No		Market rows in the feed, one item per market. Returned by the `breaking` feed.
data.markets[].active	boolean	No		`true` when the market is active.
data.markets[].best_ask	number	No		Lowest ask price currently offered on the market.
data.markets[].best_bid	number	No		Highest bid price currently offered on the market.
data.markets[].closed	boolean	No		`true` when the market is closed.
data.markets[].condition_id	string	No	0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327	Condition id that identifies the market on Polymarket.
data.markets[].end_date	string	No		Date and time the market is scheduled to end (ISO 8601).
data.markets[].id	string	No	558934	Polymarket market id.
data.markets[].last_trade_price	number	No		Price of the most recent trade on the market.
data.markets[].liquidity	number	No		Liquidity Polymarket reports for the market.
data.markets[].outcomes	array	No		Outcomes of the market with their current prices, one item per outcome.
data.markets[].outcomes[].best_ask	number	No	0.162	Lowest ask price currently offered for the outcome.
data.markets[].outcomes[].best_bid	number	No	0.161	Highest bid price currently offered for the outcome.
data.markets[].outcomes[].last_trade_price	number	No	0.162	Price of the most recent trade on the outcome.
data.markets[].outcomes[].liquidity	number	No	1093391.84	Liquidity Polymarket reports for the outcome.
data.markets[].outcomes[].market_id	string	No	558934	Polymarket id of the market the outcome belongs to.
data.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.markets[].outcomes[].outcome	string	No	Yes	Name of the outcome, for example `Yes`.
data.markets[].outcomes[].price	number	No	0.1615	Current price of the outcome.
data.markets[].outcomes[].question	string	No	Will Spain win the 2026 FIFA World Cup?	Question of the market the outcome belongs to.
data.markets[].outcomes[].volume	number	No	30983849.24	Trading volume Polymarket reports for the outcome.
data.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.markets[].slug	string	No	will-spain-win-the-2026-fifa-world-cup-963	URL slug of the market.
data.markets[].token_ids	array	No		Token ids of the market outcomes, in the same order as `outcomes`.
data.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.markets[].volume	number	No		Total trading volume of the market.
data.markets[].volume_24h	number	No		Trading volume of the market over the last 24 hours.
data.next_cursor	string	No		Cursor to pass to fetch the next page.
data.source_kind	string	No	events_keyset	Kind of rows the feed returns: `events_keyset`, `markets_movers` or `public_search`.
data.source_url	string	No	https://gamma-api.polymarket.com/events/keyset?limit=20&tag_slug=politics	URL the data was read from.
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/homepage/feed?feed=trending&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

Polymarket homepage feed API

How this endpoint behaves

Query parameters:

feed: optional homepage feed. Allowed values: trending, breaking, new, politics, sports, crypto, esports, iran, finance, geopolitics, tech, culture, economy, weather, mentions, elections. Defaults to trending.

limit: optional maximum rows to return. Defaults to 20; maximum 100.

cursor: optional keyset cursor from a prior event feed response. Applies to feeds backed by event keyset pagination.

Notable response behavior:

Most feeds return Polymarket event rows.

breaking returns high-movement market rows and sets source_kind to markets_movers.

mentions returns open event search matches and sets source_kind to public_search.

Empty upstream feed pages are returned as upstream errors instead of successful empty parser drift.

Sampled response

Request, 14 Oct 2026

GET /polymarket/homepage/feed?feed=politics&limit=20

Items in events

Fields filled in every checked item

Fields empty in some or all items

Field	Filled in, of 20 checked	Values in the sample
id	20
slug	20
title	20
description	20	median 914 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	2025-07-06 to 2026-10-12
end_date	20	2026-10-11 to 2029-01-01
updated_at	20	2026-10-13
volume	20	189,173.27 to 1,293,883,862.38, median 11,914,325.01
volume_24h	20	164,148.75 to 1,006,372.16, median 292,144.65
liquidity	20	20,195.76 to 75,945,012.77, median 748,518.84
open_interest	20	26,402.11 to 42,359,344.93, median 1,632,091.51
tags	20	median 7 entries
markets	20	median 10 entries
markets_count	20	1 to 128, median 10
featured	11	true in 11 of 11
comment_count	14	1 to 23,157, median 371

Request parameters

Parameter	Type	Required	Default	Description	Example
feed	string	No		Homepage feed Allowed values: trending, breaking, new, politics, sports, crypto, esports, iran, finance, geopolitics, tech, culture, economy, weather, mentions, elections.
limit	integer	No	20 and supports up to 100	Maximum rows, defaults to 20 and supports up to 100	20
cursor	string	No		Optional keyset cursor from a prior event feed response
x-api-key (header)	string	Yes		API key required

{ "code": 200, "msg": "OK", "data": { "feed": "politics", "source_kind": "events_keyset", "limit": 2, "has_more": true, "next_cursor": "eyJ2b2x1bWUyNGhyIjoiMTIzIn0=", "source_url": "https://gamma-api.polymarket.com/events/keyset?active=true&ascending=false&closed=false&limit=2&order=volume24hr&tag_slug=politics", "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 } ] } }

Field

Type

Required

Enum

Bounds

Example

Description

code

integer

200

data

polymarket.HomepageFeedResponse

data.cursor

string

Cursor that was used to fetch this page.

data.events

array

Event rows in the feed, one item per event.

data.events[].active

boolean

`true` when the event is active.

data.events[].closed

boolean

`true` when the event is closed.

data.events[].comment_count

integer

Number of comments on the event.

data.events[].description

string

Event description as shown on Polymarket.

data.events[].end_date

string

Date and time the event is scheduled to end (ISO 8601).

data.events[].featured

boolean

`true` when Polymarket features the event.

data.events[].icon_url

string

URL of the event's icon image.

data.events[].id

string

545095

Polymarket event id.

data.events[].image_url

string

URL of the event's main image.

data.events[].liquidity

number

Liquidity Polymarket reports for the event.

data.events[].markets

array

Markets inside the event, one item per market.

data.events[].markets[].active

boolean

`true` when the market is active.

data.events[].markets[].best_ask

number

Lowest ask price currently offered on the market.

data.events[].markets[].best_bid

number

Highest bid price currently offered on the market.

data.events[].markets[].closed

boolean

`true` when the market is closed.

data.events[].markets[].condition_id

string

0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327

Condition id that identifies the market on Polymarket.

data.events[].markets[].end_date

string

Date and time the market is scheduled to end (ISO 8601).

data.events[].markets[].id

string

558934

Polymarket market id.

data.events[].markets[].last_trade_price

number

Price of the most recent trade on the market.

data.events[].markets[].liquidity

number

Liquidity Polymarket reports for the market.

data.events[].markets[].outcomes

array

Outcomes of the market with their current prices, one item per outcome.

data.events[].markets[].outcomes[].best_ask

number

0.162

Lowest ask price currently offered for the outcome.

data.events[].markets[].outcomes[].best_bid

number

0.161

Highest bid price currently offered for the outcome.

data.events[].markets[].outcomes[].last_trade_price

number

0.162

Price of the most recent trade on the outcome.

data.events[].markets[].outcomes[].liquidity

number

1093391.84

Liquidity Polymarket reports for the outcome.

data.events[].markets[].outcomes[].market_id

string

558934

Polymarket id of the market the outcome belongs to.

data.events[].markets[].outcomes[].market_slug

string

will-spain-win-the-2026-fifa-world-cup-963

URL slug of the market the outcome belongs to.

data.events[].markets[].outcomes[].outcome

string

Yes

Name of the outcome, for example `Yes`.

data.events[].markets[].outcomes[].price

number

0.1615

Current price of the outcome.

data.events[].markets[].outcomes[].question

string

Will Spain win the 2026 FIFA World Cup?

Question of the market the outcome belongs to.

data.events[].markets[].outcomes[].volume

number

30983849.24

Trading volume Polymarket reports for the outcome.

data.events[].markets[].question

string

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

will-spain-win-the-2026-fifa-world-cup-963

URL slug of the market.

data.events[].markets[].token_ids

array

Token ids of the market outcomes, in the same order as `outcomes`.

data.events[].markets[].url

string

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

Total trading volume of the market.

data.events[].markets[].volume_24h

number

Trading volume of the market over the last 24 hours.

data.events[].markets_count

integer

Number of markets inside the event.

data.events[].open_interest

number

Open interest Polymarket reports for the event.

data.events[].restricted

boolean

`true` when Polymarket marks the event as restricted.

data.events[].slug

string

bitcoin-above-on-june-7-2026

URL slug of the event.

data.events[].start_date

string

Date and time the event starts (ISO 8601).

data.events[].tags

array

Tags attached to the event, one item per tag.

data.events[].tags[].id

string

Polymarket tag id.

data.events[].tags[].label

string

Crypto

Display name of the tag, for example `Crypto`.

data.events[].tags[].slug

string

crypto

URL slug of the tag, for example `crypto`.

data.events[].title

string

Bitcoin above ___ on June 7?

Event title as shown on Polymarket.

data.events[].updated_at

string

Time Polymarket last updated the event (ISO 8601).

data.events[].url

string

https://polymarket.com/event/bitcoin-above-on-june-7-2026

Link to the event on polymarket.com.

data.events[].volume

number

Total trading volume of the event.

data.events[].volume_24h

number

Trading volume of the event over the last 24 hours.

data.feed

string

politics

Homepage feed that was requested, for example `politics`.

data.fetched_at

string

2026-06-07T11:00:00Z

Time the data was fetched, in UTC (RFC 3339).

data.has_more

boolean

`true` when more rows are available after this page.

data.limit

integer

Maximum number of rows requested.

data.markets

array

Market rows in the feed, one item per market. Returned by the `breaking` feed.

data.markets[].active

boolean

`true` when the market is active.

data.markets[].best_ask

number

Lowest ask price currently offered on the market.

data.markets[].best_bid

number

Highest bid price currently offered on the market.

data.markets[].closed

boolean

`true` when the market is closed.

data.markets[].condition_id

string

0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327

Condition id that identifies the market on Polymarket.

data.markets[].end_date

string

Date and time the market is scheduled to end (ISO 8601).

data.markets[].id

string

558934

Polymarket market id.

data.markets[].last_trade_price

number

Price of the most recent trade on the market.

data.markets[].liquidity

number

Liquidity Polymarket reports for the market.

data.markets[].outcomes

array

Outcomes of the market with their current prices, one item per outcome.

data.markets[].outcomes[].best_ask

number

0.162

Lowest ask price currently offered for the outcome.

data.markets[].outcomes[].best_bid

number

0.161

Highest bid price currently offered for the outcome.

data.markets[].outcomes[].last_trade_price

number

0.162

Price of the most recent trade on the outcome.

data.markets[].outcomes[].liquidity

number

1093391.84

Liquidity Polymarket reports for the outcome.

data.markets[].outcomes[].market_id

string

558934

Polymarket id of the market the outcome belongs to.

data.markets[].outcomes[].market_slug

string

will-spain-win-the-2026-fifa-world-cup-963

URL slug of the market the outcome belongs to.

data.markets[].outcomes[].outcome

string

Yes

Name of the outcome, for example `Yes`.

data.markets[].outcomes[].price

number

0.1615

Current price of the outcome.

data.markets[].outcomes[].question

string

Will Spain win the 2026 FIFA World Cup?

Question of the market the outcome belongs to.

data.markets[].outcomes[].volume

number

30983849.24

Trading volume Polymarket reports for the outcome.

data.markets[].question

string

Will Spain win the 2026 FIFA World Cup?

Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.

data.markets[].slug

string

will-spain-win-the-2026-fifa-world-cup-963

URL slug of the market.

data.markets[].token_ids

array

Token ids of the market outcomes, in the same order as `outcomes`.

data.markets[].url

string

https://polymarket.com/event/world-cup-winner/will-spain-win-the-2026-fifa-world-cup-963

Link to the market on polymarket.com.

data.markets[].volume

number

Total trading volume of the market.

data.markets[].volume_24h

number

Trading volume of the market over the last 24 hours.

data.next_cursor

string

Cursor to pass to fetch the next page.

data.source_kind

string

events_keyset

Kind of rows the feed returns: `events_keyset`, `markets_movers` or `public_search`.

data.source_url

string

https://gamma-api.polymarket.com/events/keyset?limit=20&tag_slug=politics

URL the data was read from.

msg

string

Status

Description

Schema

400

Bad Request

#/definitions/app.Response

429

Too Many Requests

#/definitions/app.Response

503

Service Unavailable

#/definitions/app.Response

Polymarket homepage feed API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Polymarket homepage feed API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related