Skip to main content
Numo’s futures are dated and cash settled in USDC. Every price is USDC per unit of the base, about 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 a FutureAsset 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.
One unit of desired_amount is always 0.001 contract, whatever the contract size. On cNGN-30NOV26, desired_amount 116 is 0.116 contract, or 116,000 cNGN. ui_size_unit on GET /markets states the unit, and amount_scale and contract_multiplier give the same answer.

Discover the market

A future’s entry carries the 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.
Futures take raw engine values only. 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:
Sign the same order into action_json.data, with two different scales:
  • limitPrice is the price × 1e18: 720000000000000.
  • desiredAmount is the size × amount_scale (1e15): 1000000000000000000, one contract.
  • worstFee caps 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.module is the market’s trade_module_address.
Set 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 within band_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.
Liquidations and the close-out at expiry move positions at the mark and are not bounded.

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 /fills reports the mark as mark_price and the VM as vm_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-30NOV26 and 2% on EURC-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_usdc on GET /positions reports it, positive when owed to you. It counts toward margin at par.

Settlement

Trading stops at last_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 SubAccounts 0x7019244E25FA416e6Ca2ed2F3cA25277aef72843, where future is the market’s asset_address and subId its sub_id. The result is signed contracts at 18 decimals; positive is a long.
  • Pending variation margin: FutureAsset.getPendingVM(subaccountId, subId) on the market’s asset_address, in USDC at 18 decimals.
  • Margin: MarginEngine.getMargin(subaccountId, true) for the initial-margin surplus, or false for maintenance, in USD at 18 decimals, on margin_manager_address.
Your fills, with their 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: