Skip to main content
GET
/
v1
/
api
/
markets
List markets
curl --request GET \
  --url https://api.dotprediction.io/v1/api/markets \
  --header 'X-API-Key: <api-key>'
{
  "pagination": {
    "total": 123,
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>"
  },
  "markets": [
    {
      "id": "<string>",
      "platform": "<string>",
      "platform_id": "<string>",
      "title": "<string>",
      "status": "<string>",
      "market_type": "<string>",
      "outcomes": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "current_prices": {},
      "last_synced_at": "<string>",
      "event_id": "<string>",
      "event_name": "<string>",
      "series_id": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "category": "<string>",
      "subcategory": "<string>",
      "tags": [
        "<string>"
      ],
      "volume_24h": 123,
      "volume_7d": 123,
      "volume_total": 123,
      "liquidity": 123,
      "liquidity_score": 123,
      "open_interest": 123,
      "unique_traders": 123,
      "source_url": "<string>",
      "image_url": "<string>",
      "created_at": "<string>",
      "trading_start_at": "<string>",
      "trading_end_at": "<string>",
      "resolution_date": "<string>",
      "resolved_at": "<string>",
      "resolution_criteria": "<string>",
      "resolution_source": "<string>",
      "price_24h_changes": {},
      "price_7d_changes": {},
      "metadata": {}
    }
  ],
  "meta": {
    "platforms_queried": [
      "<string>"
    ],
    "request_time": 123,
    "cache_hit": true,
    "data_freshness": "<string>"
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Generate one via the dashboard or the /v1/api/auth/api-keys endpoint.

Query Parameters

​
provider
enum<string>
required

The prediction market platform to query.

Available options:
kalshi,
polymarket,
limitless
​
limit
string

Maximum number of markets to return.

​
cursor
string

Pagination cursor from a previous response's next_cursor field.

​
status
string

Filter markets by status (e.g., open, closed, settled).

​
query
string

Full-text search query to filter markets by title or description.

​
include_raw
enum<string>

Include the raw provider response in the output. Set to true to enable.

Available options:
true,
false

Response

A paginated list of markets.

​
pagination
object
​
markets
object[]
​
meta
object