curl -sS \
-H "Authorization: Bearer $OXINSIDER_API_KEY" \
'https://api.0xinsider.com/api/v1/markets/explore'import requests
url = "https://api.0xinsider.com/api/v1/markets/explore"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.0xinsider.com/api/v1/markets/explore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.0xinsider.com/api/v1/markets/explore",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.0xinsider.com/api/v1/markets/explore"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.0xinsider.com/api/v1/markets/explore")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.0xinsider.com/api/v1/markets/explore")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"data": [
{
"type": "group",
"event_slug": "nfl-nyg-la-2026-09-22",
"parent_title": "Giants vs. Rams",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"platform": "polymarket",
"category": "NFL",
"markets": [
{
"id": "mkt_0xabc1230000000000000000000000000000000abc613f54180a6d82f81c586f87",
"condition_id": "0xabc1230000000000000000000000000000000abc613f54180a6d82f81c586f87",
"title": "Giants vs. Rams",
"slug": "nfl-nyg-la-2026-09-22",
"url_slug": "nfl-nyg-la-2026-09-22",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"category": "NFL",
"platform": "polymarket",
"status": "active",
"volume": 7381997.07,
"liquidity": 828265.76,
"whale_trade_count": 18,
"large_trade_count": 18,
"whale_distinct_wallets": 12,
"large_trade_distinct_wallets": 12,
"whale_total_usd": 623663.53,
"large_trade_total_usd": 623663.53,
"whale_last_trade_at": "2026-09-22T02:05:52Z",
"large_trade_last_at": "2026-09-22T02:05:52Z",
"end_date": "2026-09-22T00:15:00Z",
"created_at": "2026-08-11T12:00:11.489584Z",
"outcome_yes": "Giants",
"outcome_no": "Rams",
"token_id_yes": "4661468695364133352504208359262294490681982643646457249320367691664724099857",
"token_id_no": "43677542496120548237382622015301078356830156697348317225498679221043021866409",
"event_slug": "nfl-nyg-la-2026-09-22",
"smart_score": -0.9999414953194173,
"smart_count": 14,
"smart_label": "Rams",
"outcome_yes_label": "Giants",
"outcome_no_label": "Rams",
"outcome_yes_provider_id": null,
"outcome_no_provider_id": null,
"open_interest": 4827946.902008,
"oi_change_pct": 818.6106074586263,
"price_points": [
[
1789963213,
0.265
],
[
1789966815,
0.265
],
[
1789970413,
0.265
]
],
"no_price_points": [
[
1789963211,
0.735
],
[
1789966814,
0.735
],
[
1789970412,
0.735
]
],
"last_price": 0.0005,
"no_last_price": 0.9995,
"change_pct_24h": -99.81132075471699,
"no_change_pct_24h": 35.98639455782314,
"discover_score": 757.91,
"score_components": {
"volume_signal": 284.66,
"whale_signal": 344.24,
"large_trade_signal": 344.24,
"liquidity_signal": 109.01,
"recency_signal": 20,
"sharp_money_signal": 0,
"smart_money_signal": 0,
"price_move_signal": 99.81,
"missing_price_penalty": 0
},
"freshness": {
"enrichment_status": "available",
"price_status": "available"
}
},
{
"id": "mkt_0xdef4560000000000000000000000000000000def5d625ced3aab59ab944b0149",
"condition_id": "0xdef4560000000000000000000000000000000def5d625ced3aab59ab944b0149",
"title": "Spread: Rams (-6.5)",
"slug": "nfl-nyg-la-2026-09-22-spread-home-6pt5",
"url_slug": "nfl-nyg-la-2026-09-22-spread-home-6pt5",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"category": "NFL",
"platform": "polymarket",
"status": "active",
"volume": 1771718.51,
"liquidity": 248860.04,
"whale_trade_count": 1,
"large_trade_count": 1,
"whale_distinct_wallets": 1,
"large_trade_distinct_wallets": 1,
"whale_total_usd": 31200,
"large_trade_total_usd": 31200,
"whale_last_trade_at": "2026-09-21T18:28:47Z",
"large_trade_last_at": "2026-09-21T18:28:47Z",
"end_date": "2026-09-22T00:15:00Z",
"created_at": null,
"outcome_yes": "Rams",
"outcome_no": "Giants",
"token_id_yes": "70559970467755656860388256309445764511942874931136416008858426344324056285882",
"token_id_no": "101693339364586689364540822236169180116014062262373180943098113798769516613300",
"event_slug": "nfl-nyg-la-2026-09-22",
"smart_score": null,
"smart_count": null,
"smart_label": null,
"outcome_yes_label": "Rams",
"outcome_no_label": "Giants",
"outcome_yes_provider_id": null,
"outcome_no_provider_id": null,
"open_interest": null,
"oi_change_pct": null,
"price_points": [
[
1789963212,
0.525
],
[
1789966814,
0.525
],
[
1789970412,
0.525
]
],
"no_price_points": [
[
1789963212,
0.475
],
[
1789966814,
0.475
],
[
1789970412,
0.475
]
],
"last_price": 0.9995,
"no_last_price": 0.0005,
"change_pct_24h": 90.38095238095238,
"no_change_pct_24h": -99.89473684210526,
"discover_score": 628.72,
"score_components": {
"volume_signal": 258.97,
"whale_signal": 250.35,
"large_trade_signal": 250.35,
"liquidity_signal": 99.39,
"recency_signal": 20,
"sharp_money_signal": null,
"smart_money_signal": null,
"price_move_signal": 90.38,
"missing_price_penalty": 0
},
"freshness": {
"enrichment_status": "unavailable",
"price_status": "available"
}
}
],
"rep_volume": 7381997.07,
"rep_whales": 12,
"rep_large_trades": 12
},
{
"type": "standalone",
"market": {
"id": "mkt_0xdef4560000000000000000000000000000000def4c2638b15eda50ca1b7ce303",
"condition_id": "0xdef4560000000000000000000000000000000def4c2638b15eda50ca1b7ce303",
"title": "Dallas Wings vs. Phoenix Mercury",
"slug": "wnba-dal-phx-2026-09-21",
"url_slug": "wnba-dal-phx-2026-09-21",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wnba-logo-PAR4befDAubM.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wnba-logo-PAR4befDAubM.png",
"category": "WNBA",
"platform": "polymarket",
"status": "active",
"volume": 214180.96,
"liquidity": 180183.25,
"whale_trade_count": 1,
"large_trade_count": 1,
"whale_distinct_wallets": 1,
"large_trade_distinct_wallets": 1,
"whale_total_usd": 16292.73,
"large_trade_total_usd": 16292.73,
"whale_last_trade_at": "2026-09-22T02:04:20Z",
"large_trade_last_at": "2026-09-22T02:04:20Z",
"end_date": "2026-09-22T02:00:00Z",
"created_at": "2026-09-08T05:48:06.531425Z",
"outcome_yes": "Dallas Wings",
"outcome_no": "Phoenix Mercury",
"token_id_yes": "26603239767113701790776634803790654539492519362779665632490658212718064984767",
"token_id_no": "63625967510349184920927952425890439521145813842589613381435268277105144709593",
"event_slug": "wnba-dal-phx-2026-09-21",
"smart_score": null,
"smart_count": null,
"smart_label": null,
"outcome_yes_label": "Dallas Wings",
"outcome_no_label": "Phoenix Mercury",
"outcome_yes_provider_id": null,
"outcome_no_provider_id": null,
"open_interest": null,
"oi_change_pct": null,
"price_points": [
[
1789963210,
0.695
],
[
1789966812,
0.695
],
[
1789970410,
0.685
]
],
"no_price_points": [
[
1789963211,
0.305
],
[
1789966813,
0.305
],
[
1789970411,
0.315
]
],
"last_price": 0.755,
"no_last_price": 0.245,
"change_pct_24h": 8.633093525179865,
"no_change_pct_24h": -19.672131147540984,
"discover_score": 572.52,
"score_components": {
"volume_signal": 220.94,
"whale_signal": 234.76,
"large_trade_signal": 234.76,
"liquidity_signal": 96.81,
"recency_signal": 20,
"sharp_money_signal": null,
"smart_money_signal": null,
"price_move_signal": 8.63,
"missing_price_penalty": 0
},
"freshness": {
"enrichment_status": "unavailable",
"price_status": "available"
}
}
}
],
"has_more": true,
"next_cursor": "ZXhfMjAyNi0wOS0yMlQwMjowNDoyMCswMDowMHwweDMyZWMxMGM0NjAyZjc1M2M1NmQwMGJiZjkyZjRkYzIxMmE1YmUwYTM0YzI2MzhiMTVlZGE1MGNhMWI3Y2UzMDM",
"total": 371,
"facets": {
"categories": [
{
"value": "Soccer",
"label": "Soccer",
"count": 89
},
{
"value": "Tennis",
"label": "Tennis",
"count": 74
},
{
"value": "Baseball",
"label": "Baseball",
"count": 73
}
],
"platforms": [
{
"value": "polymarket",
"label": "Polymarket",
"count": 371
}
]
},
"meta": {
"request_id": "req_example",
"cached": false,
"cost": 1
},
"computed_at": "2026-09-22T03:08:59.496925Z",
"fresh_for_seconds": 60
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}Explore markets
Browse Polymarket markets by category, status, or sort order.
curl -sS \
-H "Authorization: Bearer $OXINSIDER_API_KEY" \
'https://api.0xinsider.com/api/v1/markets/explore'import requests
url = "https://api.0xinsider.com/api/v1/markets/explore"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.0xinsider.com/api/v1/markets/explore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.0xinsider.com/api/v1/markets/explore",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.0xinsider.com/api/v1/markets/explore"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.0xinsider.com/api/v1/markets/explore")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.0xinsider.com/api/v1/markets/explore")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"data": [
{
"type": "group",
"event_slug": "nfl-nyg-la-2026-09-22",
"parent_title": "Giants vs. Rams",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"platform": "polymarket",
"category": "NFL",
"markets": [
{
"id": "mkt_0xabc1230000000000000000000000000000000abc613f54180a6d82f81c586f87",
"condition_id": "0xabc1230000000000000000000000000000000abc613f54180a6d82f81c586f87",
"title": "Giants vs. Rams",
"slug": "nfl-nyg-la-2026-09-22",
"url_slug": "nfl-nyg-la-2026-09-22",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"category": "NFL",
"platform": "polymarket",
"status": "active",
"volume": 7381997.07,
"liquidity": 828265.76,
"whale_trade_count": 18,
"large_trade_count": 18,
"whale_distinct_wallets": 12,
"large_trade_distinct_wallets": 12,
"whale_total_usd": 623663.53,
"large_trade_total_usd": 623663.53,
"whale_last_trade_at": "2026-09-22T02:05:52Z",
"large_trade_last_at": "2026-09-22T02:05:52Z",
"end_date": "2026-09-22T00:15:00Z",
"created_at": "2026-08-11T12:00:11.489584Z",
"outcome_yes": "Giants",
"outcome_no": "Rams",
"token_id_yes": "4661468695364133352504208359262294490681982643646457249320367691664724099857",
"token_id_no": "43677542496120548237382622015301078356830156697348317225498679221043021866409",
"event_slug": "nfl-nyg-la-2026-09-22",
"smart_score": -0.9999414953194173,
"smart_count": 14,
"smart_label": "Rams",
"outcome_yes_label": "Giants",
"outcome_no_label": "Rams",
"outcome_yes_provider_id": null,
"outcome_no_provider_id": null,
"open_interest": 4827946.902008,
"oi_change_pct": 818.6106074586263,
"price_points": [
[
1789963213,
0.265
],
[
1789966815,
0.265
],
[
1789970413,
0.265
]
],
"no_price_points": [
[
1789963211,
0.735
],
[
1789966814,
0.735
],
[
1789970412,
0.735
]
],
"last_price": 0.0005,
"no_last_price": 0.9995,
"change_pct_24h": -99.81132075471699,
"no_change_pct_24h": 35.98639455782314,
"discover_score": 757.91,
"score_components": {
"volume_signal": 284.66,
"whale_signal": 344.24,
"large_trade_signal": 344.24,
"liquidity_signal": 109.01,
"recency_signal": 20,
"sharp_money_signal": 0,
"smart_money_signal": 0,
"price_move_signal": 99.81,
"missing_price_penalty": 0
},
"freshness": {
"enrichment_status": "available",
"price_status": "available"
}
},
{
"id": "mkt_0xdef4560000000000000000000000000000000def5d625ced3aab59ab944b0149",
"condition_id": "0xdef4560000000000000000000000000000000def5d625ced3aab59ab944b0149",
"title": "Spread: Rams (-6.5)",
"slug": "nfl-nyg-la-2026-09-22-spread-home-6pt5",
"url_slug": "nfl-nyg-la-2026-09-22-spread-home-6pt5",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nfl.png",
"category": "NFL",
"platform": "polymarket",
"status": "active",
"volume": 1771718.51,
"liquidity": 248860.04,
"whale_trade_count": 1,
"large_trade_count": 1,
"whale_distinct_wallets": 1,
"large_trade_distinct_wallets": 1,
"whale_total_usd": 31200,
"large_trade_total_usd": 31200,
"whale_last_trade_at": "2026-09-21T18:28:47Z",
"large_trade_last_at": "2026-09-21T18:28:47Z",
"end_date": "2026-09-22T00:15:00Z",
"created_at": null,
"outcome_yes": "Rams",
"outcome_no": "Giants",
"token_id_yes": "70559970467755656860388256309445764511942874931136416008858426344324056285882",
"token_id_no": "101693339364586689364540822236169180116014062262373180943098113798769516613300",
"event_slug": "nfl-nyg-la-2026-09-22",
"smart_score": null,
"smart_count": null,
"smart_label": null,
"outcome_yes_label": "Rams",
"outcome_no_label": "Giants",
"outcome_yes_provider_id": null,
"outcome_no_provider_id": null,
"open_interest": null,
"oi_change_pct": null,
"price_points": [
[
1789963212,
0.525
],
[
1789966814,
0.525
],
[
1789970412,
0.525
]
],
"no_price_points": [
[
1789963212,
0.475
],
[
1789966814,
0.475
],
[
1789970412,
0.475
]
],
"last_price": 0.9995,
"no_last_price": 0.0005,
"change_pct_24h": 90.38095238095238,
"no_change_pct_24h": -99.89473684210526,
"discover_score": 628.72,
"score_components": {
"volume_signal": 258.97,
"whale_signal": 250.35,
"large_trade_signal": 250.35,
"liquidity_signal": 99.39,
"recency_signal": 20,
"sharp_money_signal": null,
"smart_money_signal": null,
"price_move_signal": 90.38,
"missing_price_penalty": 0
},
"freshness": {
"enrichment_status": "unavailable",
"price_status": "available"
}
}
],
"rep_volume": 7381997.07,
"rep_whales": 12,
"rep_large_trades": 12
},
{
"type": "standalone",
"market": {
"id": "mkt_0xdef4560000000000000000000000000000000def4c2638b15eda50ca1b7ce303",
"condition_id": "0xdef4560000000000000000000000000000000def4c2638b15eda50ca1b7ce303",
"title": "Dallas Wings vs. Phoenix Mercury",
"slug": "wnba-dal-phx-2026-09-21",
"url_slug": "wnba-dal-phx-2026-09-21",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wnba-logo-PAR4befDAubM.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wnba-logo-PAR4befDAubM.png",
"category": "WNBA",
"platform": "polymarket",
"status": "active",
"volume": 214180.96,
"liquidity": 180183.25,
"whale_trade_count": 1,
"large_trade_count": 1,
"whale_distinct_wallets": 1,
"large_trade_distinct_wallets": 1,
"whale_total_usd": 16292.73,
"large_trade_total_usd": 16292.73,
"whale_last_trade_at": "2026-09-22T02:04:20Z",
"large_trade_last_at": "2026-09-22T02:04:20Z",
"end_date": "2026-09-22T02:00:00Z",
"created_at": "2026-09-08T05:48:06.531425Z",
"outcome_yes": "Dallas Wings",
"outcome_no": "Phoenix Mercury",
"token_id_yes": "26603239767113701790776634803790654539492519362779665632490658212718064984767",
"token_id_no": "63625967510349184920927952425890439521145813842589613381435268277105144709593",
"event_slug": "wnba-dal-phx-2026-09-21",
"smart_score": null,
"smart_count": null,
"smart_label": null,
"outcome_yes_label": "Dallas Wings",
"outcome_no_label": "Phoenix Mercury",
"outcome_yes_provider_id": null,
"outcome_no_provider_id": null,
"open_interest": null,
"oi_change_pct": null,
"price_points": [
[
1789963210,
0.695
],
[
1789966812,
0.695
],
[
1789970410,
0.685
]
],
"no_price_points": [
[
1789963211,
0.305
],
[
1789966813,
0.305
],
[
1789970411,
0.315
]
],
"last_price": 0.755,
"no_last_price": 0.245,
"change_pct_24h": 8.633093525179865,
"no_change_pct_24h": -19.672131147540984,
"discover_score": 572.52,
"score_components": {
"volume_signal": 220.94,
"whale_signal": 234.76,
"large_trade_signal": 234.76,
"liquidity_signal": 96.81,
"recency_signal": 20,
"sharp_money_signal": null,
"smart_money_signal": null,
"price_move_signal": 8.63,
"missing_price_penalty": 0
},
"freshness": {
"enrichment_status": "unavailable",
"price_status": "available"
}
}
}
],
"has_more": true,
"next_cursor": "ZXhfMjAyNi0wOS0yMlQwMjowNDoyMCswMDowMHwweDMyZWMxMGM0NjAyZjc1M2M1NmQwMGJiZjkyZjRkYzIxMmE1YmUwYTM0YzI2MzhiMTVlZGE1MGNhMWI3Y2UzMDM",
"total": 371,
"facets": {
"categories": [
{
"value": "Soccer",
"label": "Soccer",
"count": 89
},
{
"value": "Tennis",
"label": "Tennis",
"count": 74
},
{
"value": "Baseball",
"label": "Baseball",
"count": 73
}
],
"platforms": [
{
"value": "polymarket",
"label": "Polymarket",
"count": 371
}
]
},
"meta": {
"request_id": "req_example",
"cached": false,
"cost": 1
},
"computed_at": "2026-09-22T03:08:59.496925Z",
"fresh_for_seconds": 60
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}Parameters
| Parameter | Description |
|---|---|
sort | The order of the list: trending (the default), hot, expiring, large_trades, volume, or newest. large_trades ranks markets by large-trade activity; whales is its deprecated spelling and returns the same order. |
category | Keeps only markets in this category, ignoring case. A bucket name such as Basketball matches every Polymarket category that folds into it, including NBA, WNBA, and NCAAB. A raw Polymarket value such as NBA resolves to its bucket. |
status | active, closed, or all. A market is closed once Polymarket has closed trading or it has resolved, and active otherwise. The default is all. |
q | A keyword to match against market titles, at most 64 characters before whitespace is trimmed. |
platform | Accepts polymarket and changes nothing. Polymarket is the only provider. |
limit | How many entries to return, from 1 to 48. The default is 24, and a value outside the range is clamped rather than refused. |
cursor | The next_cursor value from the previous response. Each page holds discovery entries, not raw market rows. |
Key response fields
| Field | Meaning |
|---|---|
type | group or standalone. A group entry carries event_slug, parent_title, and up to 12 markets in markets. A standalone entry carries one market. |
market.url_slug | The slug of the market’s page on 0xinsider. market.slug is Polymarket’s own slug. |
market.status | active or closed. A market is closed once Polymarket has closed trading or it has resolved, and active otherwise. Search markets and Get market live snapshot label a market by the same rule. |
market.freshness.price_status | available or unavailable. Read it before you render last_price. enrichment_status says the same thing about the whale fields. |
market.token_id_yes, market.token_id_no | Polymarket’s ids for the two outcome tokens, as decimal strings. Either is null when the market has no stored token id. |
facets.categories[] | One value, label, and count row per category present in the current result. The values are the same bucket names the category parameter takes, straight from Polymarket’s own category data. |
total | How many entries match the filters. It is on the first page only, and cursor pages leave it out. |
computed_at, fresh_for_seconds | When the server computed this body, and how many seconds it stays good for (60). Subtract the age of computed_at from fresh_for_seconds to get the time left. |
Example
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
"https://api.0xinsider.com/api/v1/markets/explore?category=Basketball&status=active&sort=large_trades&limit=24"
What it does not return
- A market with no whale activity, or a market with an empty title. Both are omitted of the list.
- More than 12 markets for one event. The market 0xinsider picked to represent the event is always one of them.
- A page of more than 48 entries. That is the ceiling on
limit. - A
400for acursorit cannot read. Explore drops an unreadable cursor and serves the first page instead, so follownext_cursorrather than assuming every request moved you forward. - A second provider. Every row is a Polymarket market, whatever
platformsays.
Caching
Save the response’sETag and send it in If-None-Match on your next request. If the list has not changed, the server returns 304 Not Modified with no body. computed_at and fresh_for_seconds are omitted of the ETag, so a body recomputed with the same data keeps the same ETag.Authorizations
Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).
Headers
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.
strict Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.
Query Parameters
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.
Filter by market status. A market is closed once Polymarket has closed trading or it has resolved, and active otherwise; all returns both.
active, closed, all 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.
polymarket Sort order for the discovery feed. large_trades ranks by large-trade activity; whales is its deprecated spelling and selects the same order.
trending, hot, expiring, large_trades, whales, volume, newest Opaque pagination cursor from the previous response.
Page size. Out-of-range values are clamped to 1..48.
1 <= x <= 48Keyword search against market titles. At most 64 characters before whitespace trimming.
64Response
Grouped market discovery results
"list"- Option 1
- Option 2
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Total matching visible entries after grouping. Present on the first page and omitted on cursor pages.
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.
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.
Was this page helpful?