GET
/
api
/
markets
/
{market_id}
curl --request GET \
  --url https://api.data.adj.news/api/markets/{market_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "market_id": "<string>",
    "platform_id": "<string>",
    "ticker": "<string>",
    "adj_ticker": "<string>",
    "market_slug": "<string>",
    "platform": "<string>",
    "market_type": "<string>",
    "question": "<string>",
    "description": "<string>",
    "rules": "<string>",
    "result": "<string>",
    "link": "<string>",
    "status": "<string>",
    "reported_date": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "end_date": "<string>",
    "resolution_date": "<string>",
    "probability": 123,
    "volume": 123,
    "open_interest": 123,
    "liquidity": 123,
    "category": "<string>",
    "tags": [
      "<string>"
    ],
    "platform_ids": {},
    "status_details": {},
    "settlement_sources": [
      "<string>"
    ],
    "comments_count": 123,
    "has_comments": 123,
    "trades_count": 123,
    "event": "<string>"
  }
}

​
Get Detailed Market Information

This endpoint retrieves comprehensive information about a specific market by its unique identifier. It provides all available details, including probability, volume, rules, and metadata.

​
Market ID Format

The market_id parameter is typically in the format of platform_market-specific-identifier. For example:

  • kalshi_KXSECPRESSMENTION-25JUN30-HOAX
  • polymarket_will-donald-trump-win-the-2024-us-presidential-election

​
Response Format

The response includes all available fields for the requested market:

{
  "data": {
    "market_id": "kalshi_KXSECPRESSMENTION-25JUN30-HOAX",
    "platform_id": "kalshi_KXSECPRESSMENTION-25JUN30-HOAX",
    "ticker": "KXSECPRESSMENTION-25JUN30-HOAX",
    "adj_ticker": "adj_kalshi_kxsecpressmention_25jun30_hoax",
    "market_slug": "KXSECPRESSMENTION-25JUN30-HOAX",
    "platform": "kalshi",
    "market_type": "binary",
    "question": "Will the White House Press Secretary say Hoax at her next press briefing?",
    "description": "Will the White House Press Secretary say Hoax at her next press briefing?",
    "rules": "If the White House Press Secretary says Hoax at next, then the market resolves to Yes...",
    "result": null,
    "link": "https://kalshi.com/markets/KXSECPRESSMENTION",
    "status": "active",
    "reported_date": "2025-03-28T09:00:38.280Z",
    "created_at": "2025-03-27T22:00:00Z",
    "updated_at": "2025-03-28T10:55:38.493Z",
    "end_date": "2025-06-30T14:00:00Z",
    "resolution_date": "2025-06-30T14:00:00Z",
    "probability": 0,
    "volume": 0,
    "open_interest": 0,
    "liquidity": 0.2571428571428571,
    "category": null,
    "tags": [],
    "platform_ids": {"event_ticker":"KXSECPRESSMENTION-25JUN30"},
    "status_details": {"is_active":true,"is_resolved":false,"accepting_orders":true,"tradeable":true},
    "settlement_sources": [],
    "comments_count": 0,
    "has_comments": 0,
    "trades_count": 0,
    "event": "KXSECPRESSMENTION-25JUN30"
  }
}

​
JSON Fields Parsing

Note that some fields are returned as parsed JSON objects:

  • tags: Array of tags associated with the market
  • platform_ids: Platform-specific identifiers
  • status_details: Detailed status information
  • settlement_sources: Sources used for market settlement

​
Error Responses

  • 404 Not Found: Returned when the specified market_id doesn’t exist
  • 500 Internal Server Error: Returned when there’s a server-side issue

​
Common Use Cases

  1. Market Detail Pages: Display comprehensive information about a specific market
  2. Market Tracking: Monitor changes to specific markets over time
  3. Trading Interfaces: Build custom trading interfaces with market details
  4. Data Analysis: Analyze specific markets in detail

Authorizations

​
Authorization
string
header
required

Enter your API key as the bearer token

Path Parameters

​
market_id
string
required

Unique identifier for the market

Response

200
application/json
Market details
​
data
object