Quickstart

Use this sequence to integrate against Numo’s orderbook for stablecoins pegged to fiat currencies.

Base URL

markets-service is served from https://api.numofx.com. The examples below use $MARKETS_SERVICE_URL, so export it once:

export MARKETS_SERVICE_URL="https://api.numofx.com"

Read endpoints are public and require no API key or no allowlisting for server-side clients.

1. Discover supported markets

Query markets-service first so you know which instruments are enabled in the matcher.

curl "$MARKETS_SERVICE_URL/v1/markets"

For the USDC/cNGN market, look for:

market = "USDCcNGN-SPOT"
contract_type = "spot"
settlement_type = "spot"
asset_address and sub_id

2. Read the book and recent trades

Once you have the market symbol or the (asset_address, sub_id) pair, fetch the current orderbook and recent prints.

curl "$MARKETS_SERVICE_URL/v1/book?symbol=USDCcNGN-SPOT"
curl "$MARKETS_SERVICE_URL/v1/trades?symbol=USDCcNGN-SPOT&limit=50"

markets-service is the public read surface for:

market metadata
top-of-book bids and asks
recent trades and 24h stats
order submission and cancellation

3. Submit a signed order

Orders are posted to markets-service, but the request must already contain a signed action payload that matches the contracts. See Authentication and signing for how to build action_json.data and produce the signature.

curl -X POST "$MARKETS_SERVICE_URL/v1/orders" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "future-order-1",
    "owner_address": "0xOWNER",
    "signer_address": "0xSIGNER",
    "subaccount_id": "10",
    "recipient_id": "10",
    "nonce": "1",
    "side": "buy",
    "asset_address": "0xDd9c2Ddf97a2Dc9B9d348DcD0ef776aF5291A1F9",
    "sub_id": "1789567201",
    "desired_amount": "0.1",
    "limit_price": "1605",
    "worst_fee": "0",
    "expiry": 1893456000,
    "action_json": {
      "subaccount_id": "10",
      "nonce": "1",
      "module": "0xTRADE_MODULE",
      "data": "0x...",
      "expiry": "1893456000",
      "owner": "0xOWNER",
      "signer": "0xSIGNER"
    },
    "signature": "0x..."
  }'

markets-service rejects the order unless:

the instrument is enabled
action_json.subaccount_id matches subaccount_id
action_json.nonce matches nonce
action_json.owner matches owner_address
action_json.signer matches signer_address

desired_amount and limit_price in the body are human decimals — markets-service normalizes them against the instrument’s minimum size and tick size. The wei values go in the signed action_json.data. See Authentication and signing.

4. Let the executor clear crossed orders

The matching loop in markets-service identifies crossed orders and emits a payload to execution-service. execution-service then:

validates the match payload shape
ABI-encodes TradeModule.OrderData
simulates Matching.verifyAndMatch(...)
submits the transaction to the onchain matching contracts

Order lifecycle

Follow the full path across markets-service, execution-service, execution-contracts, and risk-core.

Markets service

Review the public orderbook, trades, and order-entry surface.

Getting started

Core services

Base URL

1. Discover supported markets

2. Read the book and recent trades

3. Submit a signed order

4. Let the executor clear crossed orders

Order lifecycle

Markets service

​Base URL

​1. Discover supported markets

​2. Read the book and recent trades

​3. Submit a signed order

​4. Let the executor clear crossed orders

Order lifecycle

Markets service

Base URL

1. Discover supported markets

2. Read the book and recent trades

3. Submit a signed order

4. Let the executor clear crossed orders