List Markets - DexBuilder Docs

GET

api

event_contracts

markets

List Markets

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

{
  "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>"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

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/event_contracts/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

Request succeeded

Response object.

items

object[]

Show child attributes

next_cursor

string | null

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

List Markets

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

{
  "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>"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

​Request

​Response

Query Parameters

Response

Request

Response