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

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

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

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

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

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

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

Пример сделки 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

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

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

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

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

3.2 Из Telegram-бота

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

3.3 По REST API

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

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

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

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

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

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

# Открыть позицию — вариант 1: по USDT
POST /api/v1/positions
{
  "side": "BUY",
  "usdt_amount": 1258.09,
  "margin_rub": 100000,
  "client_ref": "order-12345"
}

# Открыть позицию — вариант 2: по RUB (система конвертирует в USDT по рынку)
POST /api/v1/positions
{
  "side": "BUY",
  "rub_amount": 1000000,
  "client_ref": "order-456"
}

# Ответ — включает курс отправки, исполнения и проскальзывание
{
  "ok": true,
  "position": { "id": "a1b2c3d4-...", ... },
  "hedge_order_id": "abcex-id-...",
  "order_price": 85.60,    // курс при отправке
  "fill_price": 85.62,     // фактический курс исполнения
  "slippage": 0.02,        // проскальзывание
  "usdt_amount": 1168.22,
  "rub_amount": 1000000
}

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

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

Лимиты и валидация

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

HTTPS & SSL

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

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

Multi-Tenant изоляция

• Каждый обменник имеет уникальный exchanger_id
• Все запросы к данным фильтруются по exchanger_id — кросс-тенантный доступ невозможен
• ABCEX credentials зашифрованы Fernet AES-128 в PostgreSQL
• Rate limiting: 3 уровня (60/min per-key + 30/s nginx + 5/min login)
• API-ключи маскируются в логах (hv_a1b2c3***)
• Все API-запросы логируются: IP, метод, путь, статус, latency, exchanger
• ABCEX соединение: retry 3× с exponential backoff (0.5/1/2s)
• Бекапы PostgreSQL каждые 6ч, 14 дней retention

Мониторинг и алерты

7. FAQ

Торговля

Финансы

Подключение