Разработка торгового бота с REST API управления
Мы при разработке торговых ботов для DeFi сталкиваемся с критической проблемой — дублирование ордеров из-за сетевых таймаутов. Без идемпотентности один и тот же сигнал может привести к двойному исполнению и убыткам. Например, при резком движении цены сигнал на продажу может не дойти до биржи, и бот повторно отправит его — без идемпотентности это приведёт к открытию избыточной позиции. REST API с Idempotency-Key — стандартное решение, используемое всеми крупными биржами. Наша команда имеет 10+ лет опыта в разработке торговых систем, более 50 реализованных проектов. Ошибка повторной отправки возникает в 2–5% случаев при высокой волатильности, идимпотентность полностью её устраняет.
"Идемпотентность — свойство операции, позволяющее выполнять её многократно без изменения результата." — Wikipedia
Как REST API решает проблему дублирования ордеров?
Каждый торговый запрос содержит заголовок Idempotency-Key — уникальный UUID. Клиент генерирует ключ для каждой новой команды, сервер хранит результат 24 часа. Если за это время приходит повторный запрос с тем же ключом, возвращается закешированный ответ — сделка не дублируется. Это особенно важно при работе с высокой волатильностью и частыми перебоями RPC. Мы также реализуем механизм повторной отправки с exponential backoff для гарантии доставки.
Почему асинхронная модель лучше для торговли?
Синхронное исполнение заблокирует клиент до получения ответа биржи (100-500 мс). Асинхронный подход: API возвращает 202 Accepted с job ID, результат запрашивается отдельно через GET /jobs/{id}. Такой подход позволяет обрабатывать до 10 000 запросов в минуту на один экземпляр бота. Подпись HMAC-SHA256 занимает менее 1 мс, а общая задержка (latency) не превышает 10 мс. Это снижает комиссионные издержки на 15–20% за счёт более точного исполнения ордеров.
| Характеристика | Синхронная | Асинхронная |
|---|---|---|
| Время ответа | до 500 мс | 5-10 мс (ACK) |
| Масштабирование | блокирует потоки | событийная модель |
| Подходит для | стратегий с низкой частотой | HFT и high-frequency |
Как мы строим отказоустойчивую систему?
Мы внедряем circuit breaker для защиты от перегрузок. Если уровень ошибок превышает порог, API временно отклоняет запросы, позволяя бэкенду восстановиться. Мониторинг через Prometheus и алерты по 429, latency и drop rate. Историю ответов с idempotency key храним в Redis с TTL 24 часа.
Эндпоинты управления
Основные команды для контроля бота
-
GET /api/v1/bot/status— статус, uptime, режим -
POST /api/v1/bot/start— запуск -
POST /api/v1/bot/stop— остановка с сохранением позиций -
POST /api/v1/bot/pause— приостановка новых сделок -
POST /api/v1/bot/resume— возобновление
Управление портфелем
-
GET /api/v1/portfolio— баланс, P&L, метрики -
GET /api/v1/positions— открытые позиции -
POST /api/v1/positions/{id}/close— закрыть позицию -
POST /api/v1/positions/close-all?confirm=true— экстренное закрытие
Полный список эндпоинтов — в документации OpenAPI 3.0.
Rate Limiting и обработка таймаутов
Rate limiting защищает от случайных всплесков и abuse. Пример заголовков ответа:
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 87 X-RateLimit-Reset: 1704067260 Лимиты дифференцированы: чтение статуса — 300 req/min, торговые операции — 30 req/min. При превышении — 429 Too Many Requests с заголовком Retry-After. Мы настраиваем эти лимиты под вашу стратегию и объёмы. Экономия за счёт снижения простоев достигает 99.9%.
Аутентификация: API Keys + HMAC
Стандарт для торговых API — подпись запроса HMAC-SHA256. Ключ никогда не передаётся в запросе, только подпись. IP-вайтлистинг и scoped-ключи:
| Scope | Разрешённые операции |
|---|---|
| read | GET endpoints |
| trading | read + управление позициями |
| admin | trading + конфигурация, старт/стоп |
Webhooks для событий
Для уведомлений о событиях используем push-модель. Регистрируете endpoint с URL и типом событий (trade.opened, position.closed, bot.error). При наступлении события бот делает POST с payload.
Надёжная доставка: exponential backoff, верификация подписи, лог всех попыток. Интеграция с внешними системами или оркестрация нескольких ботов — стандартный сценарий. Получите консультацию по настройке webhook-интеграции.
Процесс работы
- Аналитика — изучение стратегий, объёмов, инфраструктуры.
- Проектирование — согласование схемы эндпоинтов и модели безопасности.
- Реализация — написание кода на TypeScript/Go с viem и ethers.js.
- Тестирование — unit-тесты и интеграционные тесты с биржевым симулятором, нагрузочное тестирование до 10 000 req/min.
- Деплой — CI/CD, мониторинг (алерты по 429, latency).
Сроки: от 2 до 4 недель в зависимости от сложности. Оценим проект после брифа — свяжитесь с нами для консультации.
Что входит в работу
- REST API с документацией OpenAPI 3.0
- Исходный код в приватном репозитории
- Интеграция с биржами по вашему списку
- Webhook-эндпоинт для событий
- Нагрузочное тестирование (до N запросов/мин)
- Инструкция по развёртыванию
- Поддержка 1 месяц после релиза
Закажите разработку индивидуального API — обсудим задачу.