Skip to main content
GET
/
v1
/
api
/
markets
/
id
/
{id}
Get market by ID
curl --request GET \
  --url https://api.dotprediction.io/v1/api/markets/id/{id} \
  --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.

Path Parameters

id
string
required

The market ID (platform-specific identifier).

Query Parameters

provider
enum<string>
required

The prediction market platform to query.

Available options:
kalshi,
polymarket,
limitless
include_raw
enum<string>

Include the raw provider response.

Available options:
true,
false

Response

Market details.

pagination
object
markets
object[]
meta
object