0.00072 for cNGN. A long (buy) gains when the base
strengthens against the dollar. A short (sell) gains when it weakens. Read this before
integrating against a future.
What the market is
Each series is aFutureAsset series on Base under the MarginEngine, the risk manager that
holds margin, settles variation margin and liquidates. A wallet uses one trading account under the
MarginEngine for every series, and the collateral it holds, USDC and cNGN, backs all of
them. Your first deposit opens the account.
A series is listed as <BASE>-<DDMONYY>, named for its expiry date:
Discover series from
GET /markets rather than hard-coding one. A new series gets a new
identifier, a new sub_id and its own expiry.
Discover the market
ui_* and engine_* contract fields, with
engine_side_policy = "same_as_ui", plus these:
The
future object is the series as the chain has it. Prices are USDC per unit of the base, up to 18
decimals. An absent optional field could not be read, so treat it as unknown, not as zero.
Place an order
Market makers quote the futures on the onchain book. Take from there to trade now.
This section describes signed orders for the venue’s off-chain matcher, where no market maker quotes:
an order posted there rests until someone else crosses it.
order_entry_spec and ui_intent are refused on a future.
In the body, limit_price is in USDC per unit of the base and desired_amount is in units of 0.001
contract, both human decimals. A long of one contract (1,000,000 cNGN) at 0.00072 USDC per cNGN:
action_json.data, with two different scales:
limitPriceis the price × 1e18:720000000000000.desiredAmountis the size ×amount_scale(1e15):1000000000000000000, one contract.worstFeecaps the fee per contract filled, in USDC × 1e18. A contract’s notional moves with the price, so the bound does too:price × contract size × feeRate × 1e18. At 0.00072 a contract is worth 720 USDC, so the 15 bps fee is 1.08 USDC. The example signs 20 bps (1440000000000000000) to leave headroom.action_json.moduleis the market’strade_module_address.
post_only: true on a quote to make sure it is never the taker. See Fees.
A fill carries its price to the chain and moves no quote leg. The account receives the position,
and variation margin settles the gap between the fill price and the mark at once. See
Variation margin.
reduce_only: true lets an order only shrink the account’s position in the series. It is refused
when the account has no position, or when the order is on the same side as the position. The
matcher clamps each fill so it never crosses through zero.
See Authentication and signing for building the signed payload, and
Create order for the full request body.
Orders the venue refuses
The venue refuses a futures order the chain could not settle, rather than resting it as depth no fill can take:The fill band
The chain refuses a fill priced too far from the index. A fill must sit withinband_width of
index_price, so between fill_band_low and fill_band_high. On cNGN-30NOV26 the band is 10%
either side of the index. On EURC-30NOV26 it is 3%. Each narrows linearly over the last 14 days
before expiry, to 1% and 0.5%.
The venue applies the same test with the chain’s own arithmetic:
- On submission, an order whose signed limit is outside the band now is refused.
- Before each fill, the matcher re-checks the fill price against a band read at most two seconds earlier. A resting order the index has moved away from is held back, not cancelled. It fills again once the index comes back within reach.
- While the index is stale (
band_status = "index_stale"), the chain refuses every fill. The venue refuses new orders until the index updates.
Margin
Margin is held under the MarginEngine in USDC cash and cNGN. USDC counts at par. cNGN counts at its base margin factor (0.5), valued at the index. Futures margin is charged on the position’s notional
at the mark, |contracts| × contract size × mark, so it moves with the price. It is gross, with no
offset between series or against other positions:
While cNGN trades below its depeg threshold, the MarginEngine adds a penalty to initial margin.
A trade that only reduces a futures position is held to maintenance margin, not initial, so you can
always deleverage. Open interest in each series is capped on chain.
Before submitting a fill, the matcher estimates each account’s initial-margin surplus after it.
If an account comes up short, its order is held back for 30 seconds. After three refusals, at least a
minute apart from the first, the order is cancelled with
cancel_reason: "insufficient_margin". The
estimate is deliberately generous, so the MarginEngine on chain remains the authority.
Variation margin
Variation margin (VM) settles in USDC cash, and nothing is converted. A move of the mark byΔmark is Δmark × contract size USDC per contract. A long receives it when the mark rises, and a
short pays it.
- At the fill. A fill is marked to the mark at once. A buy above the mark, or a sell below it,
pays the gap.
GET /fillsreports the mark asmark_priceand the VM asvm_usdc. - At each mark. The mark is pulled from a signed forward feed at most once an hour. Each update
may move at most 5% on
cNGN-30NOV26and 2% onEURC-30NOV26, and must sit inside the band around the index. The MarginEngine settles VM before every risk check, and anyone can trigger it for an account. - At each settlement. VM accrues at each mark and is realised into cash at each settlement.
Between a mark and the next settlement, the accrued amount is pending.
pending_vm_usdconGET /positionsreports it, positive when owed to you. It counts toward margin at par.
Settlement
Trading stops atlast_trade_time: one hour before expiry on cNGN-30NOV26, 30 minutes on
EURC-30NOV26. From then on only the MarginEngine moves
positions, through liquidations and the close-out.
The settlement price is the time-weighted average of the index over the fixing window, the last
hour before expiry. Each open position is closed out at it, and the final variation margin is paid
in USDC. If the fixing is incomplete, a fallback price may be set after 24 hours, within 2% of the
samples’ average.
Read a position
GET /positions?subaccount_id=N returns the account’s
position in every listed series, read from chain. It needs no signature, because positions are
public on chain. Each entry under futures gives the series’ market, sub_id and status
(trading, closing once past last_trade_time, or settled), your signed contracts, the
side, notional_usdc, the mark_price and when it was set, and pending_vm_usdc. A series you are
flat in is not listed.
The account’s margin is reported once, under futures_account, because it covers every series and
your cNGN, not one position. A field the venue could not read is left out: treat an absent field as
unknown, not as zero.
The same values are on chain if you would rather read them there:
- Position:
SubAccounts.getBalance(subaccountId, future, subId)on SubAccounts0x7019244E25FA416e6Ca2ed2F3cA25277aef72843, wherefutureis the market’sasset_addressandsubIditssub_id. The result is signed contracts at 18 decimals; positive is a long. - Pending variation margin:
FutureAsset.getPendingVM(subaccountId, subId)on the market’sasset_address, in USDC at 18 decimals. - Margin:
MarginEngine.getMargin(subaccountId, true)for the initial-margin surplus, orfalsefor maintenance, in USD at 18 decimals, onmargin_manager_address.
mark_price and vm_usdc, are on
GET /fills.
Market data
For the book, trades and candles, pass the series’market as symbol on REST endpoints, or as
market on the websocket stream. Prices are USDC per unit of the base.
The retired series
USDC-cNGN-30NOV26 was the previous contract, under the first MarginEngine
(0xA19E296021c9DF25b90D96C2A0793CC3D0800758). It was delisted on 19 November 2026, with no open
positions: GET /markets no longer lists it, and its symbol returns unknown_market.
For reference, it differed from the series above in every unit:

