List events (linked-market groups).

Each event is the master row of a linked-market group. ?withLegs=true expands the full leg array on every event in the response (one extra DB query — keep it off when rendering an index page).

GET /v1/events

Error

A valid request URL is required to generate request examples

200

{
  "events": [
    {
      "id": 0,
      "masterAddress": "<string>",
      "question": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "imageUrl": "<string>",
      "createdAt": "<string>",
      "legCount": 4503599627370495,
      "totalVolume": "<string>",
      "legs": [
        {
          "id": 0,
          "marketAddress": "<string>",
          "question": "<string>",
          "category": "<string>",
          "tags": [
            "<string>"
          ],
          "creator": "<string>",
          "resolved": true,
          "finalOutcome": 0,
          "volume": "<string>",
          "bestBidYes": 500,
          "bestAskYes": 500,
          "bestBidNo": 500,
          "bestAskNo": 500,
          "createdAt": "<string>",
          "metadata": {},
          "imageUrl": "<string>",
          "rules": "<string>",
          "resolutionSources": "<string>",
          "master": true,
          "masterQuestion": "<string>",
          "masterImage": "<string>",
          "linked": true,
          "proposalId": 0
        }
      ]
    }
  ],
  "pagination": {
    "limit": 100,
    "nextCursor": "<string>",
    "page": 4503599627370495,
    "total": 4503599627370495
  }
}

Authorizations

Authorization · string · header · required

API key obtained from POST /v1/auth/keys.

Query Parameters

category · string

Required string length: 1 - 80

q · string

Required string length: 1 - 200

sort · enum<string> · default: created-at

Available options: created-at, volume, leg-count

order · enum<string> · default: desc

Available options: asc, desc

limit · integer · default: 50

Required range: 1 <= x <= 200

cursor · string

page · integer

Required range: 0 <= x <= 9007199254740991

withLegs · boolean · default: false

Response

200

application/json

Default Response

events · object[] · required

Show child attributes

pagination · object · required

Pagination envelope returned alongside every list endpoint.

Show child attributes