Stream Market Lifecycle Events

Change-only notifications when markets are published, change trading status, or leave the catalog.

SEND/ws

Authorization

UDX-Access-KeyAPI key · headerrequired

Opaque API key ID.

UDX-Access-TimestampAPI key · headerrequired

Unix time in milliseconds, within 30 seconds of server time.

UDX-Access-SignatureAPI key · headerrequired

Standard-base64 RSA-PSS/SHA-256 signature with a 32-byte salt. Sign timestamp + "GET" + "/ws"; the upgrade request has no body hash and no idempotency key.

Messages

market_createdA newly published market is available in the catalog.

typestringrequired

Identifies a newly published market.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

market_openedTrading became available, including a reopening.

typestringrequired

Identifies a market that opened for trading.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

market_pausedTrading was temporarily interrupted.

typestringrequired

Identifies a market whose trading paused.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

market_closedAn active trading interval ended; the market may reopen.

typestringrequired

Identifies a market whose trading interval ended.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

market_expiredTrading is terminal; the market remains in the catalog.

typestringrequired

Identifies a market whose trading expired.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

market_deletedThe market left the catalog.

typestringrequired

Identifies a market removed from the catalog.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

market_metadata_updatedThe market changed without a trading transition.

typestringrequired

Identifies a market whose public fields changed.

sidSubscriptionIdrequired

Exchange-assigned subscription ID whose lifetime is this WebSocket connection.

min 1 · max 9007199254740991

seqSequenceNumberrequired

Gap-detection sequence local to one subscription. It starts at 1 and increments once per frame on that subscription.

min 1 · max 9007199254740991

msgMarketLifecyclePayloadrequired

The complete market representation, matching REST. For market_deleted this is the last representation before removal.

Show properties

marketMarketrequired

A tradable binary market.

Show properties

legsMarketLeg[]

Present only for multi-leg markets; absent for single-leg markets. Each leg selects a component market outcome.

min items 2

Show properties

Array of MarketLeg

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

outcomestringrequired

The outcome of this component market selected by the multi-leg market.

Allowed:yesno

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128

descriptionstring

Human-readable description of what the market resolves on.

max length 2048

statusMarketStatusrequired

Market trading status.

Allowed:unopenedopenpausedclosedexpired

tick_sizestring

Minimum price increment, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

minimum_pricestring

Minimum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

maximum_pricestring

Maximum allowed order price, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

expires_atstring<date-time>

The configured expiration instant.

max length 40

external_idsMarketExternalIds

Identifiers this market carries in third-party data providers' systems.

Show properties

optic_oddsMarketExternalIdsOpticOdds

Identifiers in OpticOdds.

Show properties

fixture_idstring

The OpticOdds fixture this market is priced from.

min length 1 · max length 128

market_idstring

The OpticOdds market this market is a selection of.

min length 1 · max length 128

team_idstring

The OpticOdds team this market is about, when the market is about a team.

min length 1 · max length 128

player_idstring

The OpticOdds player this market is about, when the market is about a player.

min length 1 · max length 128

series_tickerstring

The series the market is listed under.

max length 128

event_tickerstring

Groups markets on the same game or contest within a series.

max length 128

titlestring

Short display name for the market.

max length 512

rulesstring

The rules that decide how the market resolves.

max length 65536

strikeMarketStrike

The threshold the market's outcome is compared with.

Show properties

typeMarketStrikeType

How the outcome is compared with the strike value.

Allowed:greatergreater_or_equallessless_or_equalequal

valuestringrequired

The strike itself, such as a line or a team name.

max length 255

unitMarketStrikeUnit

How to read the strike value.

Allowed:decimalintegerpointsstringboolunknown

opens_atstring<date-time>

The configured instant the market opens for trading.

max length 40

notional_valuestring

What one YES contract pays if the market resolves YES, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$

contract_terms_urlstring<uri>

Link to the contract terms the market is listed under.

max length 2048

Channel Bindings

ws

methodGET

headers

UDX-Access-Keystringrequired

Opaque API key ID.

min length 1 · max length 255

UDX-Access-Timestampstringrequired

Unix time in milliseconds, within 30 seconds of server time.

max length 13 · matches ^[0-9]{13}$

UDX-Access-Signaturestringrequired

Standard-base64 RSA-PSS/SHA-256 signature with a 32-byte salt. Sign timestamp + "GET" + "/ws"; the upgrade request has no body hash and no idempotency key.

min length 1 · max length 1024

Sec-WebSocket-Protocolstringrequired

Negotiated dated WebSocket API version.

Examples

market_created

{
  "type": "market_created",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "unopened",
      "description": "Will the example resolve YES?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "external_ids": {
        "optic_odds": {
          "fixture_id": "20260927A1B2C3",
          "market_id": "player_points",
          "player_id": "7G8H9I0J1K2L"
        }
      }
    }
  }
}

{
  "type": "market_created",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "unopened",
      "description": "A two-leg example market.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes",
          "external_ids": {
            "optic_odds": {
              "fixture_id": "20260927A1B2C3"
            }
          }
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no",
          "external_ids": {
            "optic_odds": {
              "fixture_id": "20260927D4E5F6"
            }
          }
        }
      ]
    }
  }
}

market_opened

{
  "type": "market_opened",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "open",
      "description": "Will the example resolve YES?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z"
    }
  }
}

{
  "type": "market_opened",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "open",
      "description": "A two-leg example market.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes"
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no"
        }
      ]
    }
  }
}

market_paused

{
  "type": "market_paused",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "paused",
      "description": "Will the example resolve YES?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z"
    }
  }
}

{
  "type": "market_paused",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "paused",
      "description": "A two-leg example market.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes"
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no"
        }
      ]
    }
  }
}

market_closed

{
  "type": "market_closed",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "closed",
      "description": "Will the example resolve YES?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z"
    }
  }
}

{
  "type": "market_closed",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "closed",
      "description": "A two-leg example market.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes"
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no"
        }
      ]
    }
  }
}

market_expired

{
  "type": "market_expired",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "expired",
      "description": "Will the example resolve YES?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z"
    }
  }
}

{
  "type": "market_expired",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "expired",
      "description": "A two-leg example market.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes"
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no"
        }
      ]
    }
  }
}

market_deleted

{
  "type": "market_deleted",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "expired",
      "description": "Will the example resolve YES?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z"
    }
  }
}

{
  "type": "market_deleted",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "expired",
      "description": "A two-leg example market.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes"
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no"
        }
      ]
    }
  }
}

market_metadata_updated

{
  "type": "market_metadata_updated",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MARKET-C",
      "status": "open",
      "description": "Will the example resolve YES before the deadline?",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "external_ids": {
        "optic_odds": {
          "fixture_id": "20260927A1B2C3",
          "market_id": "player_points",
          "player_id": "7G8H9I0J1K2L"
        }
      }
    }
  }
}

{
  "type": "market_metadata_updated",
  "sid": 12,
  "seq": 3,
  "msg": {
    "market": {
      "ticker": "UDX-EXAMPLE-MULTI",
      "status": "open",
      "description": "A two-leg example market, priced from the YES side.",
      "tick_size": "0.001",
      "minimum_price": "0.001",
      "maximum_price": "0.990",
      "expires_at": "2026-10-01T00:00:00.000000Z",
      "legs": [
        {
          "ticker": "UDX-EXAMPLE-MARKET-A",
          "outcome": "yes",
          "external_ids": {
            "optic_odds": {
              "fixture_id": "20260927A1B2C3"
            }
          }
        },
        {
          "ticker": "UDX-EXAMPLE-MARKET-B",
          "outcome": "no",
          "external_ids": {
            "optic_odds": {
              "fixture_id": "20260927D4E5F6"
            }
          }
        }
      ]
    }
  }
}