Skip to Content
LandedFXDocs

Rate locks

Lock today's naira rate for a payment you'll make or receive later.

An importer who pays a supplier in 30 days, or a payroll that converts monthly, can lock the rate now. LandedFX prices the lock by walking Numo's cNGN futures book at your size.

curl -X POST https://api.landedfx.com/api/v1/forwards \
  -H "x-api-key: $LANDEDFX_KEY" -H "content-type: application/json" \
  -d '{ "currency": "NGN", "side": "buy_usd", "amountUsd": 1000 }'
FieldMeaning
rateNaira per dollar you lock until expiry
premiumVsIndexPct, premiumAnnPctHow far the locked rate is from today's index, over the period and per year
filledUsd, completeHow much the book can absorb at this price
initialMarginUsdUSDC collateral Numo requires (25% of notional)
orderIntentAn unsigned Numo order: sign it (EIP-712) and post it to Numo

A live example: locking $1,000 of dollars for 23 days came to ₦1,390.70/$, 1.09% over the ₦1,375.66 index, walking 7 levels of the book.

side: "buy_usd" is for whoever needs dollars later. side: "sell_usd" is for whoever receives dollars later, or wants naira carry: each is the other's natural counterparty.

GET /derivatives/ngn returns the whole curve: Numo's index, every futures series with its basis and depth, and the options chain.

Locks settle on Numo, a cash-settled futures venue on Base. You need a Numo margin account; LandedFX never holds the position or the collateral.