Skip to main content
markets-service is the public-facing REST surface for Numo’s orderbook.

Public endpoints

The service exposes these core routes:
  • GET /healthz
  • GET /markets
  • GET /book
  • GET /trades
  • POST /orders
  • POST /orders/cancel

Market discovery

Use GET /markets before you submit anything. The response contains the canonical metadata you need for order entry:
  • market
  • asset_address
  • sub_id
  • contract_type
  • settlement_type
  • base_asset_symbol and quote_asset_symbol — cNGN and USDC on cNGN-30NOV26
  • display_name — <BASE>-<DDMONYY>, such as cNGN-30NOV26
  • tick_size

Reading the book

GET /book accepts either:
  • symbol=cNGN-30NOV26, or
  • asset_address=0x...&sub_id=1796047200
The response returns:
  • market_presentation
  • bids
  • asks
The matcher currently returns the top 25 levels on each side.

Reading trade history

GET /trades supports:
  • symbol
  • asset_address
  • sub_id
  • limit
  • before_trade_id
The response includes:
  • market_presentation
  • stats_24h
  • trades
  • next_before_trade_id
stats_24h covers the trailing 24 hours, recomputed from the market’s fills on each request. Its prices are in USDC per cNGN, like every other price; volume is in cNGN and quote_volume in USDC. Every field is omitted when nothing traded in the window. For the fills on your own orders, with the fee paid and the settling transaction, use the signed List fills endpoint.

Submitting an order

POST /orders persists a signed order after validating the embedded action payload. Required fields include:
  • order_id
  • owner_address
  • signer_address
  • subaccount_id
  • recipient_id
  • nonce
  • side
  • asset_address
  • sub_id
  • desired_amount
  • limit_price
  • worst_fee
  • expiry
  • action_json
  • signature
The service rejects the order if the order metadata and action_json disagree on owner, signer, subaccount, or nonce.

Cancelling an order

Use POST /orders/cancel with:
  • owner_address
  • nonce
  • signer_address
  • expiry
  • signature
Cancellation is owner-and-nonce based, not order-id based, and the owner must sign it. See Cancel an order.