GET

Get Market

Retrieve details for a specific prediction market, including its question, status, category, close date, and labels.

Endpoint

GET /api/v1/market?marketId={uuid}

Query Parameters

Parameter	Type	Required	Description
marketId	UUID	Yes	The ID of the market to retrieve

Response

Returns the market object on success (status 201).

{
  "id": "clxyz...",
  "question": "Will the Leafs win the Stanley Cup?",
  "description": "Resolves YES if...",
  "category": "SPORTS",
  "status": "OPEN",
  "closesAt": "2026-06-15T00:00:00.000Z",
  "resolved": false,
  "labelA": "Yes",
  "labelB": "No",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-03-17T00:00:00.000Z"
}

Example

import requests

API_KEY = "your_api_key"
BASE_URL = "https://www.vancouverpx.ca/api/v1"

def get_market(market_id: str) -> dict:
    response = requests.get(
        f"{BASE_URL}/market",
        params={"marketId": market_id},
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    response.raise_for_status()
    return response.json()

market = get_market("your-market-uuid")
print(market["question"], market["status"])