Skip to main content
GET
/
api
/
markets
List markets
curl --request GET \
  --url http://localhost:8000/api/markets \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "venue": "polymarket",
      "venue_market_id": "0xabc123",
      "venue_event_id": "0x5678efgh",
      "pear_event_id": "pear_9d4e5f6a",
      "title": "Fed cuts rates in March 2025?",
      "description": "Resolves Yes if the Federal Reserve announces a rate cut at the March 2025 FOMC meeting.",
      "market_slug": "fed-cuts-rates-march-2025",
      "outcomes": [
        "Yes",
        "No"
      ],
      "status": "active",
      "end_date_iso": "2025-03-19T18:00:00Z",
      "best_bid": 0.35,
      "best_ask": 0.37,
      "mid_price": 0.36,
      "spread": 0.02,
      "volume": 4521000,
      "volume_24h": 523000,
      "open_interest": 2100000,
      "liquidity": 450000,
      "icon_url": null,
      "image_url": "https://example.com/images/fed.png"
    }
  ],
  "next_cursor": "eyJ2ZW51ZV9tYXJrZXRfaWQiOiIweGFiYzEyMyJ9",
  "has_more": true,
  "total_count": 79239
}

Authorizations

​
Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer mk_live_...

Query Parameters

​
venue
enum<string>

Filter markets by trading venue.

Available options:
kalshi,
polymarket
​
status
enum<string>

Filter markets by their current status.

Available options:
active,
closed,
resolved
​
min_volume
number

Minimum total trading volume. Only return markets with volume greater than or equal to this value.

Required range: x >= 0
Example:

10000

​
min_liquidity
number

Minimum liquidity. Only return markets with liquidity greater than or equal to this value.

Required range: x >= 0
Example:

5000

​
cursor
string

Cursor for pagination. Pass the next_cursor value from a previous response to get the next page.

​
limit
integer
default:50

Maximum number of markets to return per page.

Required range: 1 <= x <= 200

Response

A paginated list of venue markets.

Paginated response containing venue markets.

​
data
object[]
​
next_cursor
string | null

Cursor to pass for the next page of results. Null if no more pages.

​
has_more
boolean

Whether there are more results available.

​
total_count
integer

Total number of results matching the query.