> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/get-started/exchanger-api/dopolnitelnye-vozmozhnosti/partner.md).

# Партнерский API

Партнерский API нужен для личного кабинета партнера, аналитики, отчетов и сверки выплат. Все endpoints работают от имени текущего клиента, которому принадлежит API-ключ.

## Что можно получить

| Данные             | Endpoint                          | Что показывать клиенту                                           |
| ------------------ | --------------------------------- | ---------------------------------------------------------------- |
| Сводка партнера    | `GET /private/partner`            | Партнерский статус, баланс, базовые показатели.                  |
| Статистика         | `GET /private/partner/statistics` | Агрегации по периоду: переходы, регистрации, обмены, начисления. |
| Рефералы           | `GET /private/partner/referrals`  | Список привлеченных клиентов.                                    |
| Партнерские обмены | `GET /private/partner/exchanges`  | Обмены, по которым начисляется партнерское вознаграждение.       |
| Выплаты            | `GET /private/partner/payouts`    | История и состояние выплат партнеру.                             |

Для партнерского кабинета обычно нужны scopes:

```
partner:read
partner:statistics:read
partner:referrals:read
partner:exchanges:read
partner:payouts:read
```

## Сводка

```bash
curl -sS https://example.com/api/v3/private/partner \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Статистика

```bash
curl -sS "https://example.com/api/v3/private/partner/statistics?period=month" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

`period` используйте для переключателей в интерфейсе: день, неделя, месяц или свой диапазон, если он поддержан установкой.

## Рефералы

```bash
curl -sS "https://example.com/api/v3/private/partner/referrals?page=1&per_page=50" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Партнерские обмены

```bash
curl -sS "https://example.com/api/v3/private/partner/exchanges?filter[created_from]=2026-06-01" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Выплаты

```bash
curl -sS "https://example.com/api/v3/private/partner/payouts?filter[status]=paid" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Рекомендации

* Показывайте суммы в той валюте, которую вернул API, не пересчитывайте их самостоятельно.
* Для длинных списков используйте `page` и `per_page`.
* Для сверки выплат сохраняйте ID payout и период отчета.
* Не смешивайте партнерские данные с обычным списком заявок: для заявок клиента используйте [Orders API](/get-started/exchanger-api/dopolnitelnye-vozmozhnosti/orders.md), для партнерских начислений используйте `GET /private/partner/exchanges`.

Точные параметры и responses: [Partner API Reference](/get-started/exchanger-api/api-reference/partner.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/get-started/exchanger-api/dopolnitelnye-vozmozhnosti/partner.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.