Get Market by Slug - DexBuilder Docs

GET

api

prediction

markets

slug

{slug}

Get Market by Slug

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

{
  "accepting_orders": true,
  "best_ask": "<string>",
  "best_bid": "<string>",
  "category": "<string>",
  "closed": true,
  "condition_id": "<string>",
  "description": {},
  "enable_order_book": true,
  "end_date": 123,
  "event_id": "<string>",
  "icon": "<string>",
  "image": "<string>",
  "last_trade_price": "<string>",
  "limit_buy_min_shares": "<string>",
  "market_id": "<string>",
  "min_order_size": "<string>",
  "neg_risk": true,
  "outcomes": [
    {
      "outcome": {},
      "token_id": "<string>"
    }
  ],
  "question": {},
  "resolution_source": "<string>",
  "resolved_at": 123,
  "slug": "<string>",
  "start_date": 123,
  "status": "<string>",
  "tags": [
    {
      "label": {},
      "slug": "<string>",
      "tag_id": "<string>"
    }
  ],
  "tick_size": "<string>",
  "uma_end_date": "<string>",
  "uma_end_date_iso": "<string>",
  "uma_resolution_status": "<string>",
  "uma_resolution_statuses": "<string>",
  "volume": "<string>",
  "volume_24hr": "<string>",
  "winning_outcome": "<string>",
  "winning_token_id": "<string>"
}

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

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

Returns one market selected by its slug. 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/slug/{slug}"

slug is the URL-safe market identifier. 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

Returns the market definition, including condition ID, event ID, outcomes, token IDs, prices, status, resolution data, and trading constraints. 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.

Path Parameters

slug

string

required

Response

Request succeeded

Response object.

accepting_orders

boolean | null

best_ask

string

best_bid

string

tags

object[]

Show child attributes

tick_size

string | null

uma_end_date

string | null

uma_end_date_iso

string | null

uma_resolution_status

string | null

uma_resolution_statuses

string | null

volume

string | null

volume_24hr

string

winning_outcome

string | null

winning_token_id

string | null

Get Market by Slug

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

{
  "accepting_orders": true,
  "best_ask": "<string>",
  "best_bid": "<string>",
  "category": "<string>",
  "closed": true,
  "condition_id": "<string>",
  "description": {},
  "enable_order_book": true,
  "end_date": 123,
  "event_id": "<string>",
  "icon": "<string>",
  "image": "<string>",
  "last_trade_price": "<string>",
  "limit_buy_min_shares": "<string>",
  "market_id": "<string>",
  "min_order_size": "<string>",
  "neg_risk": true,
  "outcomes": [
    {
      "outcome": {},
      "token_id": "<string>"
    }
  ],
  "question": {},
  "resolution_source": "<string>",
  "resolved_at": 123,
  "slug": "<string>",
  "start_date": 123,
  "status": "<string>",
  "tags": [
    {
      "label": {},
      "slug": "<string>",
      "tag_id": "<string>"
    }
  ],
  "tick_size": "<string>",
  "uma_end_date": "<string>",
  "uma_end_date_iso": "<string>",
  "uma_resolution_status": "<string>",
  "uma_resolution_statuses": "<string>",
  "volume": "<string>",
  "volume_24hr": "<string>",
  "winning_outcome": "<string>",
  "winning_token_id": "<string>"
}

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

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

​Request

​Response

Path Parameters

Response

Request

Response