Skip to main content
The Marks Partner API lets payment companies and fintechs open and manage FX 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 in USDC.

​
Base URL

All endpoints are served over HTTPS and share this base.

​
Authentication

Every request authenticates with your API key as a Bearer token. The key prefix selects the environment - mk_live_ for production, mk_test_ for sandbox. See Authentication for details.

​
Response envelope

Every endpoint returns 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. See API Conventions for the full code list.

​
Idempotency

Opening, adding, reducing, and closing accept an Idempotency-Key header so retries are safe. See API Conventions.