> ## 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.

# 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

```text theme={null}
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](/guides/authentication) for details.

```text theme={null}
Authorization: Bearer mk_live_xxxxxxxx
```

## Response envelope

Every endpoint returns 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. See [API Conventions](/guides/api-conventions#errors) for the full code list.

## Idempotency

Opening, adding, reducing, and closing accept an `Idempotency-Key` header so retries are safe. See [API Conventions](/guides/api-conventions#idempotency).