Skip to content
UDX
Esc
↑↓navigate↵open⌘Jpreview

Get a Market

Returns one market and its current status by ticker.

GET/markets/{ticker}
Authorization

None. This operation accepts unauthenticated requests.

Path parameters
tickerTickerrequired
The market's ticker.
min length 1 · max length 128
Header parameters
UDX-Versionstring
Dated API version (YYYY-MM-DD). Omit to use the oldest supported version. An unknown version returns `400`.
max length 10
Responses
200The requested market.
marketMarketrequired
A tradable binary market, priced from the YES side.
Show properties
tickerTickerrequired
A market identifier (ticker) — a human-meaningful natural-key symbol, not a UUID. Unique per market.
min length 1 · max length 128
event_tickerstring
Identifier of the event this market belongs to.
max length 128
descriptionstring
Human-readable description of what the market resolves on.
max length 2048
statusMarketStatusrequired
Market trading status. `open` accepts orders; `closed` and `paused` do not; `expired` is past its expiry; `settled` has resolved to an outcome.
Allowed:openclosedpausedexpiredsettled
event_datestring
Approximate date of the real-world event, as YYYY-MM-DD.
max length 10
tick_sizeobject
Minimum price increment, in dollars.
Show properties
object
minimum_priceobject
Minimum allowed order price, in dollars.
Show properties
object
maximum_priceobject
Maximum allowed order price, in dollars.
Show properties
object
expires_atstring<date-time>
When the market expires. UDX timestamps use RFC 3339; requests require an explicit UTC offset and zero to six fractional digits; responses use UTC with exactly six fractional digits.
max length 40
volumeobject
Total contracts traded on the market.
Show properties
object
open_interestobject
Open interest, in contracts.
Show properties
object
404The requested resource doesn't exist or isn't visible to the caller.
typestring<uri-reference>
A stable URI identifying the error's general category. Usually absent (equivalent to "about:blank" per the RFC); documented rate controls use closed URN values so callers can distinguish same-status retry causes without parsing localized prose.
max length 2048
titlestringrequired
A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.
max length 40
statusintegerrequired
The HTTP status code, repeated from the response itself.
detailstring
A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.
max length 500
instancestring<uri-reference>
An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.
max length 100
429The public request rate was exceeded. Wait for `Retry-After`.
typestring<uri-reference>
A stable URI identifying the error's general category. Usually absent (equivalent to "about:blank" per the RFC); documented rate controls use closed URN values so callers can distinguish same-status retry causes without parsing localized prose.
max length 2048
titlestringrequired
A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.
max length 40
statusintegerrequired
The HTTP status code, repeated from the response itself.
detailstring
A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.
max length 500
instancestring<uri-reference>
An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.
max length 100
500Something went wrong on UDX's side.
typestring<uri-reference>
A stable URI identifying the error's general category. Usually absent (equivalent to "about:blank" per the RFC); documented rate controls use closed URN values so callers can distinguish same-status retry causes without parsing localized prose.
max length 2048
titlestringrequired
A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.
max length 40
statusintegerrequired
The HTTP status code, repeated from the response itself.
detailstring
A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.
max length 500
instancestring<uri-reference>
An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.
max length 100
503Request admission is unavailable. Retry later.
typestring<uri-reference>
A stable URI identifying the error's general category. Usually absent (equivalent to "about:blank" per the RFC); documented rate controls use closed URN values so callers can distinguish same-status retry causes without parsing localized prose.
max length 2048
titlestringrequired
A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.
max length 40
statusintegerrequired
The HTTP status code, repeated from the response itself.
detailstring
A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.
max length 500
instancestring<uri-reference>
An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.
max length 100
Request
curl -X GET "https://{hostname}/markets/UDX-EXAMPLE-MARKET"
Response
{
  "market": {
    "ticker": "UDX-EXAMPLE-MARKET",
    "event_ticker": "UDX-EXAMPLE-EVENT",
    "description": "Will the example resolve YES?",
    "status": "open",
    "event_date": "2026-06-21",
    "tick_size": "0.01",
    "minimum_price": "0.01",
    "maximum_price": "0.99",
    "expires_at": "2026-06-21T00:00:00.000000Z",
    "volume": "12500",
    "open_interest": "3400"
  }
}