Skip to main content
Marks is an FX hedging platform for frontier-market currencies. This API lets payment companies and fintechs open and manage Hedges programmatically - currently on USDT/NGN, with more pairs to follow. Each Hedge is a non-deliverable forward (NDF): a contract that fixes an exchange rate for a chosen tenor and cash-settles the difference at maturity, with no physical delivery of currency. A Hedge opens at the prevailing spot rate, accrues carry over its tenor, and settles in USDC.

​
The API at a glance

The API is organized around four areas:
  • Market data - available markets, prices, capacity, and the current carry rate.
  • Account - your balance, margin, exposure, and unrealized P&L.
  • Quotes - an indicative price and cost breakdown for a Hedge before you open it.
  • Hedges - open, monitor, close, and review Hedges.

​
The response envelope

Every response uses the same envelope:
On success data is populated and error is null. On failure data is null and error carries a machine-readable code, a message, and optional details. Amounts are in USDC unless noted. All endpoints live under https://api.marks.finance/api/v2/partners. Your API key prefix selects the environment - mk_live_ for production, mk_test_ for sandbox.

​
Where to start

Authentication

Create a key and make your first authenticated request.

Hedge Lifecycle

How a Hedge goes from quote to open, fill, and close.

API Reference

Every endpoint, with request and response schemas.

Sandbox

Build and verify against test infrastructure first.