Barfinex
РуководствоBarfinex Team

Создайте свой коннектор к бирже для Barfinex

Подключите любую биржу, брокера или источник данных к вашей торговой системе. Один npm-пакет — и ваши данные работают везде: стратегии, AI-советник, риск-движок и дашборд.

#connectors#exchanges#plugins#npm#developer#integration

Ваша биржа. Ваши данные. Ваши стратегии.

У каждого трейдера есть любимая биржа. Может, с лучшими комиссиями, глубокой ликвидностью или локальный брокер, которого требует ваш фонд. Проблема? Большинство торговых платформ поддерживают лишь горстку бирж, а добавление новой означает ожидание месяцами — или полную смену платформы.

С Barfinex вы можете создать свой коннектор за один день.


Что такое коннектор?

Коннектор — это мост между Barfinex и внешней биржей, брокером или источником данных. Он переводит проприетарный API биржи в стандартный формат, который понимает вся система Barfinex.

После подключения ваша биржа работает со всем из коробки:

  • Рыночные данные в реальном времени поступают в Detector-стратегии — сделки, стакан, свечи
  • AI Advisor получает доступ к ценам и состоянию аккаунта для принятия LLM-решений
  • Inspector мониторит позиции и применяет риск-гейты перед исполнением ордеров
  • Studio дашборд показывает вашу биржу наряду со всеми остальными — тот же UI, тот же опыт
  • MCP-инструменты позволяют AI-ассистентам запрашивать данные вашей биржи на естественном языке

Никакой специальной настройки для каждого сервиса. Подключите один раз — используйте везде.


Как это работает

Barfinex использует плагинную архитектуру. Каждая биржа — это отдельный npm-пакет, реализующий шесть стандартных интерфейсов:

ЧтоЗачем
Client ServiceУправляет жизненным циклом соединения — аутентификация, проверка готовности
WebSocket ManagerСтриминг сделок, стакана, свечей, обновлений аккаунта
Account APIЧтение балансов, позиций, информации об аккаунте
Market APIСписок инструментов, получение цен
Order APIОткрытие, закрытие и отслеживание ордеров
Data AdaptersПеревод сырых сообщений биржи в нормализованный формат Barfinex

Сервис Provider загружает ваш пакет динамически во время выполнения. Без изменений в основном коде. Без перекомпиляции. Просто npm install и активируйте.


Что вам понадобится

  • Node.js 18+ и TypeScript
  • API-документация биржи — REST-эндпоинты и WebSocket-потоки
  • API-ключи — для тестирования интеграции
  • ~1 день для коннектора только данных (сделки + стакан)
  • ~2-3 дня для полной интеграции с исполнением ордеров

Краткая версия

# 1. Создайте пакет
mkdir exchange-myexchange && cd exchange-myexchange
npm init -y
npm install @barfinex/types @nestjs/common

# 2. Реализуйте интерфейсы (см. полное руководство)
# - Client Service: жизненный цикл соединения
# - WS Manager: подписка на сделки, стакан, свечи
# - Adapters: трансформация сырых данных в нормализованный формат

# 3. Экспортируйте всё из index.ts

# 4. Опубликуйте в npm
npm publish

# 5. Установите в ваш экземпляр Barfinex
npm install @your-org/exchange-myexchange

# 6. Зарегистрируйте загрузчик в фабрике
# 7. Активируйте через Studio или API

Всё. Ваша биржа появляется в каталоге, передаёт данные во все сервисы и отображается в дашборде Studio.


Для кого это?

Управляющие фондами и проп-трейдеры

Вы используете конкретного прайм-брокера или OTC-деск. Без коннектора Barfinex не видит ваши позиции. С ним — ваш риск-движок покрывает всё.

Региональные брокеры и биржи

Вашего брокера нет в списке поддерживаемых бирж? Создайте коннектор, и ваша команда получит полный доступ к платформе — стратегии, AI, риск-менеджмент, дашборды.

Поставщики данных

У вас есть премиум-фид — альтернативные данные, ончейн-метрики, сентимент-скоры. Упакуйте как коннектор, и он потечёт в Detector-стратегии и контекст Advisor.

Контрибьюторы открытого кода

Видите популярную биржу, которой не хватает? Создайте коннектор, опубликуйте, и сообщество выиграет.


Что уже поддерживается

Barfinex поставляется с 58 коннекторами к биржам в 13 категориях:

  • Крипто — Binance, Kraken, Coinbase, Bybit, OKX и другие
  • Американские брокеры — Alpaca, Interactive Brokers, Robinhood
  • Европейские брокеры — eToro, DEGIRO, Saxo Bank
  • Форекс — OANDA, Pepperstone, IG Markets
  • Фьючерсы — CME Group, Tradovate, NinjaTrader
  • DEX — Uniswap/SushiSwap агрегатор
  • Рыночные данные — Polygon.io, Tiingo, Glassnode

Полный каталог доступен в Studio > Данные > Биржи и брокеры.


Начните создавать

Полное пошаговое руководство охватывает:

  1. Создание проекта и структура каталогов
  2. Реализация всех шести интерфейсов с примерами кода
  3. Написание адаптеров данных для сделок, стакана и свечей
  4. Создание NestJS-модуля и публичных экспортов
  5. Регистрация в фабрике и каталоге бирж
  6. Тестирование через Provider API
  7. Публикация в npm

Читать полную документацию


Один коннектор — безграничные возможности

Когда вы добавляете коннектор, вы не просто добавляете один источник данных. Вы разблокируете:

  • Любая Detector-стратегия может использовать данные вашей биржи
  • Advisor LLM может рассуждать о ценах и позициях вашей биржи
  • Риск-губернатор Inspector может применять лимиты ко всем подключённым биржам
  • Studio показывает единое представление всех ваших аккаунтов
  • Рыночные данные сохраняются в QuestDB для исторического анализа
  • MCP-инструменты позволяют AI-ассистентам взаимодействовать с вашей биржей на естественном языке

Платформа создана для расширения. Ваш коннектор — полноправный участник.

Создайте один раз. Используйте везде.

Похожие статьи

Давайте свяжемся

Есть вопросы или хотите узнать больше о Barfinex? Напишите нам.