Документация

Полное руководство по системе FB hedgeEx — автоматическое хеджирование для OTC-обменников

1. Что такое FB hedgeEx

FB hedgeEx — B2B SaaS-платформа для OTC-обменников (USDT ↔ RUB), которая автоматически хеджирует валютный риск через биржу ABCEX.

Проблема

OTC-обменник покупает/продаёт USDT клиентам по курсу, но пока сделка обрабатывается, курс может измениться — это валютный риск. При больших объёмах потери от проскальзывания могут превысить заработок на наценке.

Решение

FB hedgeEx мгновенно зеркалит каждую сделку обменника на бирже ABCEX, закрывая дельту. Обменник зарабатывает только на спреде (наценке), а валютный риск передаётся бирже.

Бизнес-модель

Участник	Доход
Обменник	Наценка клиенту 0.3–0.7%
FB hedgeEx	Комиссия 0.06% от объёма
ABCEX	Taker fee 0.09%

2. Инверсивный хедж

Ключевой принцип

Сделка на ABCEX ВСЕГДА противоположна сделке обменника с клиентом.
Цель хеджа — закрыть позицию, а не открыть новую.

Таблица инверсии

Событие на кассе	USDT обменника	Хедж на ABCEX	Почему
BUY клиент даёт RUB, получает USDT	USDT ↓ (отдали)	ASK (SELL)	Отдали USDT → продаём на бирже
SELL клиент даёт USDT, получает RUB	USDT ↑ (получили)	BID (BUY)	Получили USDT → покупаем на бирже за рубли

Пример сделки BUY

Клиент: "Хочу купить USDT за 100 000₽"

1. Обменник → берёт best_ask с ABCEX = 79.09₽/USDT
2. Считает наценку: 79.09 × 1.005 = 79.49₽ (клиентский курс)
3. Клиент получает: 100 000 / 79.49 = 1258.09 USDT
4. ХЕДЖ: SELL 1258.09 USDT на ABCEX по 79.09₽
5. Прибыль: (79.49 - 79.09) × 1258 = +503.20₽ ≈ +6.29 USDT

Режимы хеджирования

Режим	BUY хеджируется?	SELL хеджируется?	Применение
`auto`	✅	✅	По умолчанию — хеджируем всё
`short`	✅	❌	Ожидаем падение USDT
`long`	❌	✅	Ожидаем рост USDT
`off`	❌	❌	Хеджирование отключено

3. Исполнение сделок

3.1 Из терминала (Web UI)

Оператор открывает Терминал в панели управления
Вводит сумму в рублях (напр. 100 000)
Система показывает котировку (курс, USDT, наценку)
Нажимает BUY или SELL
Система определяет сторону хеджа (инверсия) и отправляет market order на ABCEX
Сделка записывается и появляется в истории

3.2 Из Telegram-бота

Бот рассчитывает котировку по стакану ABCEX, кассир подтверждает инлайн-кнопкой, и сделка исполняется автоматически.

Команда	Описание
`/start`	Приветствие + инструкция
`/rate`	Текущий курс ABCEX (bid/ask/mid/spread)
`/buy <RUB>`	Рассчитать покупку USDT за указанную сумму RUB
`/sell <USDT>`	Рассчитать продажу указанного количества USDT
`/deal`	Записать сделку вручную
`/stats`	Статистика за сегодня

3.3 По REST API

Для внешних систем (CRM, боты, ERP) доступен API с авторизацией по API-ключу. Подробнее — в разделе 5.

4. Подключение

📩 Подключитесь к FB hedgeEx

Для подключения к системе напишите нам в Telegram. Мы создадим ваш аккаунт, выдадим учётные данные и поможем с первыми сделками.

@fbroker в Telegram

После подключения вам будут доступны:

Терминал

Торговый интерфейс для работы с клиентами

Отчёты

Аналитика сделок, P&L, сетлмент хеджей

Аккаунт

Профиль, API-ключи, расчёты комиссий

API

REST API для интеграции с вашими системами

5. API для интеграций

Авторизация

Все запросы к API требуют заголовок X-API-Key: <ваш_ключ>
API-ключ можно скопировать на странице Аккаунт

Основные эндпоинты

# Котировка перед сделкой
POST /api/v1/quote
{
  "side": "BUY",
  "amount": 100000,
  "markup_pct": 0.5
}

# Открыть позицию (автоматический хедж)
POST /api/v1/positions
{
  "side": "BUY",
  "usdt_amount": 1258.09,
  "margin_rub": 100000,
  "client_ref": "order-12345"
}

# Список позиций
GET /api/v1/positions?status=open

# Закрыть позицию
POST /api/v1/positions/{id}/close
{ "close_price": 79.50 }

Метод	Путь	Описание
POST	`/api/v1/positions`	Открыть позицию
GET	`/api/v1/positions`	Список позиций
GET	`/api/v1/positions/{id}`	Детали позиции
POST	`/api/v1/positions/{id}/close`	Закрыть позицию
POST	`/api/v1/positions/{id}/partial-close`	Частичное закрытие
POST	`/api/v1/positions/{id}/margin`	Добавить маржу
GET	`/api/v1/account/summary`	Сводка по аккаунту
POST	`/api/v1/quote`	Котировка
GET	`/api/v1/margin-status`	Статус маржи
POST	`/api/v1/webhooks`	Регистрация webhook

Лимиты

Параметр	Значение
Минимальный ордер	20 USDT
Максимальная позиция	50 000 USDT
Максимальный дневной объём	500 000 USDT

6. Безопасность и инфраструктура

HTTPS & SSL

Защищённое соединение

Весь трафик зашифрован через TLS (HTTPS) с SSL-сертификатом Let's Encrypt. HTTP-запросы автоматически перенаправляются на HTTPS.

HSTS — Strict-Transport-Security, браузер запоминает HTTPS
Security Headers — X-Frame-Options, X-Content-Type-Options, X-XSS-Protection
Auto-renew — Автоматическое обновление сертификата через certbot

Аутентификация (Dual Auth)

Система поддерживает два способа авторизации на всех защищённых эндпоинтах:

Способ	Когда используется	Детали
JWT Cookie	Admin-панель, терминал	HttpOnly + SameSite=Strict, 24ч expiry, bcrypt hash
API Key	Внешние системы обменников	Заголовок `X-Api-Key`, 48+ символов

Multi-Tenant изоляция

Каждый обменник имеет уникальный exchanger_id
Все запросы к данным фильтруются по exchanger_id — кросс-тенантный доступ невозможен
Каждый обменник хранит свои ABCEX API credentials
Rate limiting: 60 req/min per-tenant (sliding window)
Все API-запросы логируются с IP, методом, статусом и exchanger_id

Опционально: HMAC подписи

Для дополнительной защиты можно включить HMAC-подписи запросов с защитой от replay-атак (±30 секунд). Обратитесь к администратору для получения HMAC secret.

7. FAQ

Торговля

Почему хедж-ордер противоположен сделке обменника?

Цель хеджа — нейтрализовать валютную позицию. Если обменник купил USDT у клиента (BUY), его USDT позиция выросла. Чтобы убрать риск, нужно продать (SELL/ASK) на бирже.

Что произойдёт, если ABCEX недоступен?

Сделка будет записана, но хедж НЕ будет исполнен. Обменник останется с незахеджированной позицией до восстановления связи.

Можно ли торговать без хеджирования?

Да. Установите режим off в настройках хеджирования.

Что такое надбавка (markup)?

Наценка обменника на биржевой курс. Пример: ask = 79.09₽, наценка 0.5% → клиентский курс = 79.49₽. Разница — прибыль.

Финансы

Как считается комиссия FB hedgeEx?

Объём USDT × 0.06%. При объёме 10 000 USDT → комиссия = 6 USDT. Отображается на странице Аккаунт → "Расчёты".

Что такое овердрафт?

Кредитная линия ABCEX. Бесплатный период — 36 часов, после этого 0.1% в день.

Зачем нужен "Сетлмент хеджей"?

Отделяет чистую прибыль от расходов: Маржа − ABCEX fee (0.09%) − FB fee (0.06%) = Чистый P&L.

Подключение

Как подключиться к системе?

Напишите нам в Telegram: @fbroker. Мы создадим ваш аккаунт и выдадим все необходимые данные.

Какой часовой пояс используется?

MSK (UTC+3). Все данные в интерфейсе в московском времени.

Какой минимальный объём сделки?

20 USDT (лимит биржи).

Остались вопросы?

Мы всегда на связи и готовы помочь с настройкой и интеграцией.

Написать в @fbroker