Search markets

curl --request GET \
  --url https://api.oddpool.com/search/markets

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.oddpool.com/search/markets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.oddpool.com/search/markets"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.oddpool.com/search/markets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

markets

Search markets

curl --request GET \
  --url https://api.oddpool.com/search/markets

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.oddpool.com/search/markets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.oddpool.com/search/markets"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.oddpool.com/search/markets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

You must pass either q or series_id (or both). Requests with neither return 400. Use q for free-text search and series_id to scope results to one series. If you don’t have a series_id yet, find one via Search series. To list every outcome under a single known event, use Event markets instead.

Parameters

string

Full-text search on question. Required when series_id is not provided.

string

Filter to one series. Examples: KXBTC15M, btc-up-or-down-15m, KXFEDDECISION. Required when q is not provided.

string

kalshi or polymarket.

string

default:"active"

active (still trading) or closed (settled with a result).

string

Exact category match.

integer

Minimum volume.

integer

Minimum liquidity.

string

ISO timestamp. Returns markets with settled_at >= settled_after. Pair with status=closed for backtest workflows.

string

ISO timestamp. Returns markets with settled_at <= settled_before.

string

ISO timestamp filter on discovered_at. For polling new listings.

string

default:"relevance"

relevance, newest, volume, or liquidity. relevance requires q; without q the default is newest.

integer

default:"20"

1-100.

integer

default:"0"

Pagination offset. The response is a bare JSON array — increment offset by limit until you receive an empty array.

Examples

Settled-window discovery for a backtest

List the closed markets that resolved in a window for a known series. The returned market_id values feed directly into the Kalshi historical endpoints.

curl -H "X-API-Key: your_api_key" \
  "https://api.oddpool.com/search/markets?series_id=KXBTC15M&status=closed&settled_after=2026-04-25T00:00:00Z&limit=100"

import requests

response = requests.get(
    "https://api.oddpool.com/search/markets",
    headers={"X-API-Key": "your_api_key"},
    params={
        "series_id": "KXBTC15M",
        "status": "closed",
        "settled_after": "2026-04-25T00:00:00Z",
        "limit": 100,
    },
)
markets = response.json()

Free-text search

Filter markets across series by keyword. Sort by volume to surface the most active.

curl -H "X-API-Key: your_api_key" \
  "https://api.oddpool.com/search/markets?q=fed+rate&exchange=kalshi&sort_by=volume"

import requests

response = requests.get(
    "https://api.oddpool.com/search/markets",
    headers={"X-API-Key": "your_api_key"},
    params={"q": "fed rate", "exchange": "kalshi", "sort_by": "volume"},
)
markets = response.json()

Response

[
  {
    "market_id": "KXBTC15M-26MAY020000-00",
    "exchange": "kalshi",
    "series_id": "KXBTC15M",
    "question": "BTC price up in next 15 mins?",
    "category": null,
    "status": "closed",
    "volume": 375089,
    "liquidity": 119393,
    "last_yes_price": "0.9990",
    "last_no_price": "0.0000",
    "event_id": "KXBTC15M-26MAY020000",
    "event_title": "BTC 15 min · $78,396.72 target",
    "slug": null,
    "discovered_at": "2026-05-01T03:50:00Z",
    "settled_at": "2026-05-02T04:00:26Z"
  }
]

Errors

Code	Reason
`400`	Neither `q` nor `series_id` provided.

Search series Search events

Getting started

WebSocket feeds

Whale tracking

Arbitrage

Search

Historical bars

Kalshi

Polymarket

Search markets

Parameters

Examples

Settled-window discovery for a backtest

Free-text search

Response

Errors

​Parameters

​Examples

​Settled-window discovery for a backtest

​Free-text search

​Response

​Errors

Parameters

Examples

Settled-window discovery for a backtest

Free-text search

Response

Errors