Markets

Explore markets

Browse whale-active titled markets with category, platform, status, and keyword filters. Explore is Polymarket-only: the platform parameter is accepted for backward-compatibility but every request returns Polymarket markets. Paginates visible discovery entries rather than raw market rows, returns live category/platform facets alongside grouped event clusters or standalone markets, and includes total on the first page only. Each grouped event contains at most 12 markets, retaining the selected representative within that cap. Categories come straight from provider metadata (Polymarket Gamma) and facets are flat value/label/count rows.

get/api/v1/markets/explore

Query parameters

categorystring

Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. Facet values are returned as the canonical bucket.

status'active' | 'closed' | 'all'

Filter by market status.

platform'polymarket'

Filter by source platform. Explore is Polymarket-only; polymarket is the only supported value and the parameter is accepted for backward-compatibility but does not change the result set.

Sort order for the discovery feed.

cursorstring

Opaque pagination cursor from the previous response.

limitinteger

Page size.

qstring

Keyword search against market titles. At most 64 characters before whitespace trimming.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Grouped market discovery results

object'list' required

has_moreboolean required

next_cursorstring

totalinteger

Total matching visible entries after grouping. Present on the first page and omitted on cursor pages.

computed_atstring date-time

When this response body was computed. Present whenever the body came from, or was just written to, the 60s explore cache. Pair it with fresh_for_seconds to derive how much longer the body may be reused: fresh_for_seconds - age(computed_at). Excluded from the ETag validator, so a body recomputed with identical data keeps its validator.

fresh_for_secondsinteger

How long the body computed at computed_at is good for, in seconds. Deliberately not pre-subtracted: a cached body cannot carry a number that changes while it sits in the cache. Excluded from the ETag validator.

Changes

Changed in 21 of the 89 revisions of this API.11252297

Sep 23, 20267e57bd9dc8b54See the full diff
- ○
  response property data/items/oneOf[ExploreGroup]/markets/items/score_components/smart_money_signal deprecated
  response-property-deprecated
- ○
  response property data/items/oneOf[ExploreStandalone]/market/score_components/smart_money_signal deprecated
  response-property-deprecated
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
Sep 23, 2026ece7a25b7a4488See the full diff
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 23, 20268462acf80f8c811See the full diff
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 22, 202619386d595e0587See the full diff
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property ///////// became required for the status
  response-property-became-required
- ○
  the response property ///////// became required for the status
  response-property-became-required
- ○
  the response property ///////// became required for the status
  response-property-became-required
- ○
  the response property ///////// became required for the status
  response-property-became-required
- ○
  the response property ///////// became required for the status
  response-property-became-required
- ○
  the response property ///////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property //////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
Sep 22, 20261c5e270b412481See the full diff
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new optional header request parameter X-Query-Validation
  new-optional-request-parameter
Sep 22, 20269958c95371de16See the full diff
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 20264bade829e22816See the full diff
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 20267b5489c2cd3e491See the full diff
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
Sep 21, 20264b70e1891f6114See the full diff
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
Sep 17, 202605ff312f4bbc7See the full diff
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added

Full history (21 revisions)