Barfinex
Все биржи
OKX

OKX

БетаКрипто — крупные биржи
connectorType: "okx"

OKX — зарегистрированная на Сейшелах биржа, основанная в 2017 году и стабильно входящая в тройку мировых лидеров по объёму деривативов. Предлагает спотовую, маржинальную, бессрочную и квартальную фьючерсную торговлю, а также опционы по сотням пар — с особенно высокой ликвидностью в опционах на BTC и ETH. Barfinex подключает OKX в статусе BETA через OKX V5 REST и WebSocket API с поддержкой стриминга рыночных данных, управления аккаунтом и исполнения ордеров. OKX требует passphrase помимо стандартной пары ключей, что обеспечивает дополнительный уровень защиты API.

Архитектура подключения

OKX
WebSocket / REST
Connector
libs/exchange-okx
Provider
:8081/api
Detector
Advisor
Studio

Коннектор получает данные от биржи и передаёт их в Provider (порт 8081). Оттуда — в Детектор, Советник и Studio.

Технологии

Транспорт
WebSocketREST
Аутентификация
API Key + Secret + Passphrase
Формат данных
JSON
Особенности
Rate LimiterPassphrase Required

Для кого

  • OKX — оптимальный коннектор для опционных и многоногих деривативных стратегий: его ордербук опционов входит в число самых глубоких в индустрии.
  • Подходит профессиональным трейдерам, реализующим арбитраж поверхности волатильности, календарные спреды или гамма-скальпинг.
  • Биржа также конкурентна по USDT-перпетуалам на широкой вселенной альткоинов.
  • Пользователи Barfinex, которым нужны данные опционов для сигналов подразумеваемой волатильности или дельта-хеджирования, должны в первую очередь использовать OKX.

Подключение через код

1Переменные окружения (.env)

OKX_API_KEY=your_key_here
OKX_API_SECRET=your_secret_here
OKX_API_PASSPHRASE=your_passphrase_here

2Конфигурация коннектора

// config/config.provider.json
{
  "provider": {
    "connectors": [
      {
        "connectorType": "okx",
        "enabled": true,
        "key": "${OKX_API_KEY}",
        "secret": "${OKX_API_SECRET}",
        "passphrase": "${OKX_API_PASSPHRASE}",
        "markets": [
          { "marketType": "spot", "symbols": [{ "name": "BTCUSDT" }] }
        ],
        "subscriptions": [
          { "type": "PROVIDER_MARKETDATA_CANDLE", "symbols": ["BTCUSDT"], "intervals": ["min1", "h1"], "active": true },
          { "type": "PROVIDER_MARKETDATA_TRADE", "symbols": ["BTCUSDT"], "active": true },
          { "type": "PROVIDER_MARKETDATA_ORDERBOOK", "symbols": ["BTCUSDT"], "active": true }
        ]
      }
    ]
  }
}

3Проверка и запрос данных

# Проверка подключения
curl -H "Authorization: Bearer $PROVIDER_API_TOKEN" \
  https://localhost:8081/api/exchanges/runtime-proof

# Свечи (последние 7 дней)
curl -H "Authorization: Bearer $PROVIDER_API_TOKEN" \
  "https://localhost:8081/api/candles/okx/spot/BTCUSDT/h1?days=7"

Доступные данные через API

/api/candles/okx/...
/api/trades/okx/...
/api/orderbook/okx/...
/api/account/okx/...
/api/symbols/okx/...
/api/assets/okx/...

Подключение через Studio — в разработке, появится в следующем релизе.

Важно

Необходимые права: Read + Trade.
OKX требует три учётных данных: API Key, Secret Key и Passphrase, задаваемую при создании ключа — все три обязательны в конфиге Barfinex.
Лимит запросов: до 500 в минуту (зависит от эндпоинта).
OKX обязательно требует IP-вайтлист при создании ключа — IP коннектора должен быть добавлен, иначе ключ будет отклонён.
Демо-торговля (sandbox) использует отдельный набор учётных данных с другими URL-адресами.
Рынки
СпотФьючерсы
Основан2017
Штаб-квартираSeychelles
Сайтwww.okx.com

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

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