Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.numofx.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Welcome

Numo’s orderbook stack is split across a public orderbook service and a separate match executor. Use this reference for:
  • discovering enabled futures markets
  • reading the current book and recent trades
  • submitting signed orders to the matcher
  • understanding the executor payload that clears matched orders onchain

OpenAPI specification

View the openapi.json file used to build the API reference.

​
Services covered here

  • markets-service
  • execution-service
The contracts and risk engine behind those services live in:
  • execution-contracts
  • risk-core

​
Orderbook flow

1

Discover the market

Read GET /v1/markets to find the canonical market symbol, asset_address, sub_id, and settlement metadata for instruments like USDCcNGN-APR30-2026.
2

Read the book

Poll GET /v1/book and GET /v1/trades from markets-service.
3

Submit signed orders

Post signed order payloads to POST /v1/orders.
4

Execute matched trades

Let the matcher send crossed-order payloads to POST /execute on execution-service.