Skip to Content
LandedFXDocs

Lock a rate for later

POST
/api/v1/forwards

Prices a rate lock by walking the cNGN futures book at your size, and returns the locked rate, its premium over the index, the margin needed, and an unsigned Numo order to sign.

Authorization

apiKey
headerx-api-key<token>

Request Body

application/json
  1. body
currency*"NGN"

Currency to lock against the dollar. Naira today, via Numo cNGN futures.

Value in"NGN"
side*string

buy_usd: you will need dollars later (an importer, a payroll). sell_usd: you will receive dollars later, or want naira carry.

Value in"buy_usd""sell_usd"
amountUsd*number

Dollar amount to lock

market?string

A specific futures series, e.g. cNGN-30NOV26. Defaults to the nearest.

Response Body

No liquidity on that side right now

application/json
  1. response
code*number

HTTP status code

message*string

Human-readable message

data?

Response payload

metadata?
errors?array<string>

Validation errors, when the request was rejected

Example Request
curl -X POST 'https://api.landedfx.com/api/v1/forwards' \  -H 'Content-Type: application/json' \  -d '{  "currency": "NGN",  "side": "buy_usd",  "amountUsd": 1000}'
Example Response422
{  "data": {},  "metadata": {    "page": 1,    "limit": 20,    "totalDocs": 42,    "prevPage": null,    "nextPage": 2,    "totalPages": 3  },  "errors": [    "string"  ],  "code": 422,  "message": "No liquidity on that side right now"}