Introduction

Base URL, authentication, and response conventions for the Marks Partner API.

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

https://api.marks.finance/api/v2/partners

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.

Authorization: Bearer mk_live_xxxxxxxx

Response envelope

Every endpoint returns the same envelope:

{ "data": ..., "error": null, "meta": {} }

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.