Skip to main content
GET
List enabled markets

Response

200 - application/json

Enabled market metadata

market
string

The market identifier: - for a future, for example cNGN-30NOV26. Always the canonical identifier.

Example:

"cNGN-30NOV26"

contract_type
string
settlement_type
string
base_asset_symbol
string

The asset priced: cNGN on cNGN-30NOV26, EURC on EURC-30NOV26.

Example:

"cNGN"

quote_asset_symbol
string

The asset prices are quoted in: USDC.

Example:

"USDC"

expiry_timestamp
integer

Unix seconds at which the series expires. It is also the sub_id.

display_name
string

Human-readable pair name. It equals the market identifier. Use market as the identifier; this is for display.

Example:

"cNGN-30NOV26"

display_label
string

Unit of every price on the market.

Example:

"USDC per cNGN"

tick_size
string

Smallest price increment. Order prices are normalized against it.

min_size
string

Smallest tradable size. Order amounts are normalized against it, and an amount below it normalizes to zero and is rejected.

Example:

"1"

contract_multiplier
string

The base per contract: 1000000 on cNGN-30NOV26.

Example:

"1000000"

settlement_note
string
asset_address
string
sub_id
string
pricing_model
enum<string>

How the instrument's price relates to its underlying. All current markets are linear.

Available options:
linear,
variance,
volatility
price_semantics
enum<string>

Interpretation of the raw price fields. Mirrors pricing_model.

Available options:
linear,
variance,
volatility
display_price_kind
enum<string>

How a client should render the price. All current markets are direct.

Available options:
direct,
vol_percent
display_semantics
enum<string>

Interpretation of the displayed price. Mirrors display_price_kind.

Available options:
direct,
vol_percent
last_trade_timestamp
integer

Unix seconds of the most recent fill.

ui_price_unit
string

Unit of a price. The same as engine_price_unit.

Example:

"USDC per cNGN"

ui_size_unit
string

Unit of a size: 1,000 cNGN of notional on cNGN-30NOV26. One unit is 0.001 contract.

Example:

"1,000 cNGN of notional (1,000,000 cNGN a contract)"

ui_side_meaning
string

What each side does in the base. A BUY (long) gains when the base strengthens against USD, a SELL (short) when it weakens.

Example:

"BUY (long) gains when cNGN strengthens against USD (more USDC per cNGN); SELL (short) gains when it weakens."

engine_price_unit
string

Unit of the raw price and limit_price fields.

Example:

"USDC per cNGN"

engine_amount_unit
string

Unit of the raw desired_amount, filled_amount and size fields.

Example:

"1,000 cNGN of notional"

engine_side_policy
string

How a displayed side maps to the engine side. Always same_as_ui.

Example:

"same_as_ui"

ui_price_to_engine
string

Price conversion formula. The identity.

Example:

"engine_price = ui_price"

ui_size_to_engine
string

Size conversion formula. The identity; the signed amount is ui_size x amount_scale.

Example:

"engine_amount = ui_size (signed as ui_size x 1000000000000000: ui_size / 1000 contracts)"

trade_module_address
string

The TradeModule an order for this market must name in action_json.module. Every future shares it.

quote_asset_address
string

The USDC CashAsset: what fees, margin and variation margin on a future are paid in.

margin_manager_address
string

The MarginEngine: the manager a trading account for this market must be under. Every future shares it.

amount_scale
string

What one unit of size is signed as in action_json.data: 1e15 on a future (0.001 contract, which is 1,000 cNGN on cNGN-30NOV26).

Example:

"1000000000000000"

fill_band_enforced
boolean

Futures only, always true: the venue admits an order and fills it only inside the fill band, as the chain does.

fill_band_low
string

Futures only: the lowest price, in USDC per unit of the base, the chain accepts a fill at now. Omitted while the band cannot be read.

Example:

"0.000630765282229334"

fill_band_high
string

Futures only: the highest price, in USDC per unit of the base, the chain accepts a fill at now. Omitted while the band cannot be read.

Example:

"0.00074599555457997"

future
object

The series' live state read from chain.