> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marks.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> The Marks hedging API for payment companies and fintechs.

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:

```json theme={null}
{ "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.

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

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/guides/authentication">
    Create a key and make your first authenticated request.
  </Card>

  <Card title="Hedge Lifecycle" icon="arrows-rotate" href="/guides/lifecycle">
    How a Hedge goes from quote to open, fill, and close.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Every endpoint, with request and response schemas.
  </Card>

  <Card title="Sandbox" icon="flask" href="/guides/sandbox">
    Build and verify against test infrastructure first.
  </Card>
</CardGroup>