Trading App

An orderbook for spot and futures stablecoin FX.

Enables spot trading and physically delivered FX futures on USDC/cNGN. Integrated with off/on ramping via Busha and Coinbase APIs for instant USD/USDC and NGN/cNGN conversions.

Runtime config

The app discovers the live spot and deliverable futures markets from markets-service and renders both through the same orderbook UI.

Set:

• MARKETS_SERVICE_URL

Local development:

MARKETS_SERVICE_URL=http://127.0.0.1:8080

Production must override that local default. For the current Railway backend deployment:

MARKETS_SERVICE_URL=https://markets-service-production.up.railway.app

Do not deploy the frontend with MARKETS_SERVICE_URL=http://127.0.0.1:8080. In production, MARKETS_SERVICE_URL must point at the live markets-service deployment.

For the current Base staging deployment, markets-service should expose:

• asset_address=<WRAPPED_CNGN>
• sub_id=0
• contract_type=spot
• settlement_type=spot
• asset_address=0xCE2846771074E20fEc739CF97a60E6075D1E464b
• sub_id=1777507200
• contract_type=deliverable_fx_future
• settlement_type=physical_delivery

For Base Sepolia frontend execution, the matching stack env should point to deployed contracts:

• NEXT_PUBLIC_MATCHING_ADDRESS=0x1599636347FD5bA1fBE21D58AfE0b8B9cbe283FF
• NEXT_PUBLIC_TRADE_MODULE_ADDRESS=0x0AAE65AaA66Fe7f54486cDbD007956d3De611990
• NEXT_PUBLIC_USDCCNGN_MANAGER_ADDRESS=0x1917960763BF3a0DfA10a05f0a112E828C1A934f
• NEXT_PUBLIC_USDC_DELIVERABLE_BASE_ASSET_ADDRESS=0x8b3C43D2b2555ca3fc4Fa1BC34544133B8576110

If markets-service serves stale APR market metadata, override it in the frontend:

• NEXT_PUBLIC_USDCCNGN_APR_FUTURE_ASSET_ADDRESS=0xCE2846771074E20fEc739CF97a60E6075D1E464b
• NEXT_PUBLIC_USDCCNGN_APR_FUTURE_SUB_ID=1777507200

If the frontend is deployed on Railway, encode MARKETS_SERVICE_URL in that deploy environment and treat it as required production configuration rather than tribal knowledge.

Spot Order Contract

For spot USDC/cNGN, the trader-facing API contract is intentionally different from the raw engine order.

• UI price: cNGN per USDC
• UI size: USDC notional
• UI BUY: acquire USDC
• UI SELL: dispose of USDC

The engine still trades WRAPPED_CNGN against internal USDC cash, so the app must translate:

engine_price = 1 / ui_price
engine_amount = ui_size * ui_price
UI BUY  -> engine SELL
UI SELL -> engine BUY

Fill deltas should reconcile as:

UI BUY  -> dUSDC = +ui_size, d cNGN = -(ui_size * ui_price)
UI SELL -> dUSDC = -ui_size, d cNGN = +(ui_size * ui_price)