Regarding the future of VPX — Read our announcement →
vancouverpx
← Back to Markets

API Documentation

One API for markets, your account and trading, for scripts, AI agents and VPX Bots

GET

Get a market group

/api/v1/groups/{groupId} · public, no key needed

One group, with every market in it.

Parameters

NameInTypeDescription
groupId *pathstringThe group's id, or its slug

Request

curl "https://www.vancouverpx.ca/api/v1/groups/7a0d4c3b-2e1f-4a9b-8c6d-5e4f3a2b1c0d"

Response

200 with this object:

FieldTypeDescription
idstring
slugstring | null
linkstring
questionstring
descriptionstring | null
categoryCategory
statusMarketStatus
closesAtstring (date-time)When trading stops
resolvesAtstring (date-time) | null
listedbooleanOn the website's lists
negRiskbooleanEvery market in the group is neg-risk: exactly one of them resolves YES
marketsMarket[]
Example
{
  "id": "7a0d4c3b-2e1f-4a9b-8c6d-5e4f3a2b1c0d",
  "slug": "bc-election-2026-most-seats",
  "link": "https://www.vancouverpx.ca/market-group/bc-election-2026-most-seats",
  "question": "Which party will win the most seats in the 2026 BC election?",
  "description": null,
  "category": "POLITICS",
  "status": "OPEN",
  "closesAt": "2026-11-21T03:00:00.000Z",
  "resolvesAt": null,
  "listed": true,
  "negRisk": true,
  "markets": [
    {
      "id": "3f1c0f2e-6a55-4a8e-9b53-2a1f0c9d7e11",
      "slug": "bc-ndp-most-seats-2026",
      "link": "https://www.vancouverpx.ca/market/bc-ndp-most-seats-2026",
      "question": "Will the BC NDP win the most seats in the 2026 BC election?",
      "description": "Resolves YES if the BC NDP wins more seats than any other party, as reported by Elections BC.",
      "category": "POLITICS",
      "status": "OPEN",
      "closesAt": "2026-11-21T03:00:00.000Z",
      "resolvesAt": "2026-11-22T08:00:00.000Z",
      "resolution": null,
      "yesLabel": "Yes",
      "noLabel": "No",
      "imageUrl": null,
      "listed": true,
      "private": false,
      "negRisk": true,
      "group": {
        "id": "7a0d4c3b-2e1f-4a9b-8c6d-5e4f3a2b1c0d",
        "question": "Which party will win the most seats in the 2026 BC election?",
        "itemTitle": "BC NDP",
        "size": 3
      },
      "venues": {
        "polymarketSlug": "bc-election-most-seats-ndp",
        "kalshiTicker": null
      },
      "bestBid": 52,
      "bestAsk": 55,
      "lastPrice": 54,
      "volume": 152340,
      "createdAt": "2026-09-28T18:00:00.000Z",
      "updatedAt": "2026-10-26T21:14:09.000Z"
    }
  ]
}

Errors

GROUP_NOT_FOUND, and the errors every endpoint can answer.

Get a market group | VPX API Docs