List Markets

List Markets.

GET /api/v4/prediction/markets

List Markets

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/prediction/markets

200

{
  "items": [
    {
      "best_ask": "<string>",
      "best_bid": "<string>",
      "category": "<string>",
      "closed": true,
      "condition_id": "<string>",
      "end_date": 123,
      "event_id": "<string>",
      "last_trade_price": "<string>",
      "limit_buy_min_shares": "<string>",
      "market_id": "<string>",
      "outcomes": [
        {
          "outcome": {},
          "token_id": "<string>"
        }
      ],
      "question": {},
      "slug": "<string>",
      "start_date": 123,
      "status": "<string>",
      "tags": [
        {
          "label": {},
          "slug": "<string>",
          "tag_id": "<string>"
        }
      ],
      "uma_end_date": "<string>",
      "uma_end_date_iso": "<string>",
      "uma_resolution_status": "<string>",
      "uma_resolution_statuses": "<string>",
      "volume": "<string>",
      "volume_24hr": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Returns a cursor-paginated list of markets.

Base URL: https://api.dexbuilder.com

Authentication: This is a public market-data endpoint and does not require authentication.

​

Request

curl -G "https://api.dexbuilder.com/api/v4/prediction/markets"

Use limit and cursor for pagination. Filter with event, condition, slug, tag, status, and lifecycle parameters supported by the OpenAPI definition.

The OpenAPI panel below is the source of truth for required parameters, types, enum values, and request-body fields. Timestamps are Unix timestamps unless the field description states otherwise.

​

Response

The response contains items and next_cursor. Each item includes market and condition identifiers, question, outcomes, token IDs, prices, status, resolution fields, dates, and volume.

A successful response uses HTTP 200. Invalid parameters or request bodies return HTTP 400. Private endpoints can return HTTP 401 when authentication fails, and temporary upstream failures can return HTTP 503. The error response contains a machine-readable label and message.

For order, position, claim, transfer, and account operations, treat the response as the current server result and query the resource again when the operation is asynchronous.

Query Parameters

limit · integer

cursor · string

market_id · string

event_id · string

slug · string

condition_id · string

tag_slug · string

active · boolean

closed · boolean

Response

200

application/json

Request succeeded

Paginated market list response.

items · object[]

Show child attributes

next_cursor · string | null

Cursor for the next page; null means there are no more results.