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

List market groups

/api/v1/groups · public, no key needed

Questions with several answers, newest first.

A group is a question with several answers (a riding's candidates, a central bank's options), one yes/no market per answer. When the answers are exhaustive and exclusive (negRisk), exactly one resolves YES, so their YES prices add up to about 100.

Parameters

NameInTypeDescription
statusqueryMarketStatus
limitqueryintegerHow many to return (1–200, default 100) Default 100.
cursorquerystringFrom a previous page's nextCursor

Request

curl "https://www.vancouverpx.ca/api/v1/groups?status=OPEN"

Response

200 with this object:

FieldTypeDescription
groupsGroup[]
nextCursorstring | nullPass as cursor to get the next page; null on the last page
Example
{
  "groups": [
    {
      "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",
          "itemTitle": "BC NDP",
          "question": "Will the BC NDP win the most seats in the 2026 BC election?",
          "status": "OPEN",
          "bestBid": 52,
          "bestAsk": 55,
          "lastPrice": 54
        }
      ]
    }
  ],
  "nextCursor": null
}

Errors

The errors every endpoint can answer.

List market groups | VPX API Docs