Інтеграція CCXT для мульти-біржового мобільного додатку

CCXT (CryptoCurrency Exchange Trading Library) — спроба абстрагуватися від десятків несумісних біржових API за єдиним інтерфейсом. На вебі та в Node.js це працює добре. На мобілі — історія складніша. За 5 років розробки крипто-трейдингових додатків ми стикалися з десятком проєктів, де CCXT або полегшував, або ускладнював життя, залежно від архітектурних рішень. Наприклад, один клієнт хотів агрегатор портфеля на 5 біржах. Пряма інтеграція CCXT у React Native зайняла 8 тижнів, а переробка на бекенд-проксі скоротила термін до 4 тижнів і вирішила проблеми з фоновими сокетами.

Чому CCXT на мобілі — це не просто npm install?

CCXT Pro (версія з WebSocket) важить у скомпільованому вигляді кілька мегабайт і тягне залежності, які в React Native потребують поліфілів: crypto, stream, buffer. Для React Native потрібен react-native-crypto, readable-stream, налаштування metro.config.js з аліасами — і це ще до першого рядка бізнес-логіки.

На Flutter CCXT недоступний напряму — тільки через Dart FFI або вбудований JavaScript runtime (JSCore на iOS, V8 через flutter_js). Практика показує: простіше написати тонкий адаптер-проксі на бекенді (Node.js + CCXT) і спілкуватися з мобілем через REST/WebSocket, ніж тягнути CCXT у Dart-оточення.

Для нативних iOS/Android CCXT не існує — там потрібні нативні біржові SDK або власні REST-клієнти. Ми реалізували понад 10 таких інтеграцій для клієнтів з вимогами cold storage та self-custody, де сервер-посередник неприпустимий.

Як CCXT вирішує проблему уніфікації на рівні коду?

CCXT дає єдиний інтерфейс для базових операцій:

const exchange = new ccxt.binance({ apiKey, secret });
const ticker = await exchange.fetchTicker('BTC/USDT');
const balance = await exchange.fetchBalance();
const order = await exchange.createOrder('BTC/USDT', 'limit', 'buy', 0.001, 45000);

Той самий код працює для ccxt.bybit, ccxt.okx, ccxt.kraken. Для агрегаторів портфеля, які показують баланси на кількох біржах — це реальна економія часу (до 80% коду).

Проблема починається там, де біржі розходяться в деталях. fetchOHLCV на Binance повертає 1000 свічок, на KuCoin — 1500, на деяких біржах — 100. createOrder приймає різні набори параметрів для стоп-лосів і тейк-профітів — CCXT намагається нормалізувати це через params, але біржі додають нові типи ордерів швидше, ніж бібліотека встигає.

CCXT Pro та WebSocket на мобілі: блокуюча проблема

CCXT Pro реалізує WebSocket через свій Exchange.watchTrades(), watchOrderBook(), watchBalance(). Під капотом — обгортка над нативним WebSocket з reconnect-логікою. У React Native це працює через поліфіл WebSocket (глобальний об'єкт), який React Native надає з коробки.

Ключовий нюанс: CCXT Pro використовує await з while(true) для споживання стрімів:

while (true) {
  const trades = await exchange.watchTrades('BTC/USDT');
  // оновлюємо UI
}

Це блокуюча конструкція. У React Native потрібно запускати в окремому контексті (через setInterval + Promise або Worker — у RN немає справжніх Workers, потрібен react-native-multithreading або серверний проксі). Ми гарантуємо стабільне з'єднання, використовуючи другий варіант з BaaS-проксі.

Архітектура мульти-біржового додатку

Рекомендована схема для мобіля:

Mobile App
    ↕ WebSocket / REST
Backend Proxy (Node.js + CCXT)
    ↕ біржові API
Binance / Bybit / OKX / ...

Проксі нормалізує дані, керує ротацією ключів, кешує маркет-дані та агрегує події з кількох бірж в єдиний WebSocket-потік для мобіля. Мобільний додаток працює з одним з'єднанням замість N паралельних WebSocket-сесій — це критично для iOS, де фонові сокети вбиваються агресивно.

Якщо проксі неприйнятний з архітектурних причин (self-custody, no server policy) — реалізуємо нативні клієнти для кожної біржі із загальним протоколом через TypeScript-інтерфейс. Більше коду, більше тестів, але немає сервера-посередника.

Як ми інтегруємо CCXT: покроковий план

1. Аудит вимог: аналіз кількості бірж, типів операцій (торгівля/перегляд), платформ.
2. Вибір архітектури: пряма інтеграція vs проксі vs нативні клієнти. У 90% випадків рекомендуємо проксі.
3. Проектування проксі: налаштування ротації ключів, кешування, rate-limiting, безпека.
4. Мобільний модуль: UI для портфеля, ордерів, історії. Підключення до WebSocket-потоку.
5. Інтеграція бірж: налаштування CCXT для кожної біржі, тестування на демо-рахунку.
6. Навантажувальне тестування: симуляція 100+ одночасних підключень.
7. Деплой та документація: розгортання проксі, README, навчання команди.

Що входить у роботу «під ключ»

• Аудит архітектури: аналіз поточних вимог, вибір стеку (React Native / Flutter / Native).
• Проектування проксі (якщо потрібен): налаштування ротації ключів, кешування, rate-limiting.
• Інтеграція бірж: налаштування CCXT для конкретних біржових API, тестування на демо-рахунку.
• Мобільний модуль: реалізація UI для перегляду портфеля, ордерів, історії.
• WebSocket-потік: підключення до агрегованого каналу, обробка реконнекта.
• Документація: опис API проксі, інструкція з розгортання, README.
• Навчання команди: воркшоп з підтримки CCXT та доробок.

Порівняння покриття API бірж

Оцінка та контакти

Мульти-біржовий додаток — нетривіальне завдання. Ми маємо сертифікований досвід у крипто-трейдингу та гарантуємо робоче рішення. Для точної оцінки зв'яжіться з нами — обговоримо деталі: кількість бірж, чи потрібна торгівля або тільки перегляд, чи є готовий бекенд. Термін MVP з 3-4 біржами та базовою торгівлею — від 8 до 16 тижнів залежно від платформи та архітектури. Отримайте консультацію — і ми запропонуємо оптимальний варіант.

CCXT library documentation: github.com/ccxt/ccxt

Криптовалютна біржа — огляд на Wikipedia.

Інтеграція API в мобільний додаток: з чого почати

Запит йде, відповідь не приходить, timeout — 30 секунд. Користувач дивиться на спінер. Мережі немає — мобільна карта в метро. Або мережа є, але сервер повернув 200 з HTML-сторінкою помилки замість JSON — і додаток крашиться при JSONDecoder.decode(). Ми бачимо такі кейси на кожному другому проєкті. Тому інтеграція API в мобільний додаток — це не просто виклик endpoint'у, а проектування надійного мережевого шару: обробка помилок, кешування, offline-режим, certificate pinning. Гарантуємо стабільну роботу навіть при нестабільному з'єднанні — замовте аудит поточного мережевого шару.

Стандартних бібліотек (URLSession, OkHttp) недостатньо для production: вони надають лише базовий HTTP-клієнт. Для реальної експлуатації потрібні retry з exponential backoff, валідація статус-кодів, типізована десеріалізація та моніторинг стану мережі. Без цього додаток втрачає дані та користувачів. Ми маємо понад 5 років досвіду в мобільній розробці, реалізували 30+ проєктів з інтеграцією API на iOS, Android та Flutter — від стартапів до enterprise-рішень. Сертифіковані iOS/Android розробники гарантують якість коду.

Як вибрати протокол для інтеграції API?

REST залишається стандартом для більшості проєктів. Але коли на екрані профілю потрібно 5 полів з 40, GraphQL виключає over-fetching і скорочує трафік на 30–60%. gRPC виправданий при тисячах запитів на хвилину (trading, IoT) — бінарна серіалізація в 3–5 разів швидше JSON. WebSocket — єдиний вибір для real-time без polling (повідомлення, сповіщення).

Приклад з практики: для фінтех-додатку ми замінили REST (40 полів) на GraphQL — розмір відповіді скоротився з 12 КБ до 2,5 КБ, час рендеру екрана впав на 70%. Економія трафіку була значною при 100 000 активних користувачів.

Як забезпечити надійність з'єднання та offline-first?

Користувачі втрачають мережу в метро, ліфті, тунелі. Мобільний додаток зобов'язаний працювати без інтернету — хоча б у read-only режимі. Ми впроваджуємо патерн offline-first:

1. При відкритті екрану спочатку показуємо дані з локального кешу (Core Data / Room).
2. Паралельно виконуємо мережевий запит, оновлюємо UI після відповіді.
3. Якщо мережа недоступна — показуємо кешовані дані та позначку «немає з'єднання».
4. При відновленні мережі автоматично синхронізуємо зміни.

Для кешування HTTP-відповідей використовуємо URLCache (iOS) та OkHttp Cache (Android) з підтримкою Cache-Control. Для структурованих даних — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback відстежують стан мережі та тригерять оновлення. Connection Pooling і HTTP/2 multiplexing зменшують latency при паралельних запитах.

REST та вибір клієнтської бібліотеки

Alamofire (iOS) — де-факто стандарт для Swift-проєктів. Поверх URLSession додає request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() з .validate() повертає помилку для будь-якого статус-коду поза 200–299. Без .validate() Alamofire вважає 404 та 500 успішними відповідями. З Swift Concurrency — async-версія через serializingDecodable.

Retrofit (Android) — анотаційний HTTP-клієнт поверх OkHttp. Інтерфейс з анотаціями компілюється в реалізацію. @GET, @POST, @Path, @Query, @Body — декларативний опис API. OkHttp під капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логування в debug-збірці. Authenticator — автоматичний refresh токена при 401. Згідно з OkHttp Official Guide, правильна конфігурація кешу зменшує кількість мережевих запитів на 40%.

Ktor (KMM/Flutter) — мультиплатформний HTTP-клієнт. На iOS працює через Darwin engine (URLSession), на Android — через OkHttp. Єдиний код для обох платформ при KMM-архітектурі.

GraphQL: коли REST не справляється

REST повертає фіксовану структуру. Екран профілю вимагає name, avatar, email — сервер віддає 40 полів. Over-fetching. GraphQL вирішує це: клієнт запитує рівно потрібні поля. Це критично для мобайлу, де трафік і час парсингу — реальні обмеження. Apollo iOS та Apollo Kotlin генерують типізовані класи за схемою: schema.graphql + query-файли → строгі типи на етапі компіляції. Subscriptions через WebSocket — real-time без polling. Обмеження: GraphQL складніше кешувати на рівні HTTP. Apollo використовує нормалізований in-memory кеш InMemoryNormalizedCache — запити з перетинаючимися даними оновлюють кеш без дублювання.

WebSocket: real-time без зайвого трафіку

Polling (setInterval кожні 5 секунд) — витрата батареї та трафіку. WebSocket — постійне двоспрямоване з'єднання. iOS: URLSessionWebSocketTask (нативний, iOS 13+). Android: OkHttp WebSocket. Обов'язкова обробка reconnect: при onFailure — експоненційний backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надбудова з автоматичним reconnect, але для нових проєктів краще нативний WebSocket (менше залежностей). TLS 1.3 забезпечує безпеку з'єднання.

Чому важливий certificate pinning?

Корпоративний проксі може перехопити HTTPS через підміну сертифіката. Certificate pinning запобігає цьому: додаток приймає тільки конкретний сертифікат або публічний ключ. Alamofire: ServerTrustManager з PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner з SHA-256 хешем. Операційна складність: при ротації сертифіката старі версії додатку перестають працювати. Рішення — pinning на публічний ключ CA або підтримка кількох пінів з grace period. Правильне впровадження pinning гарантує захист від MITM-атак.

Що входить у роботу

Ми передаємо: вихідний код мережевого шару, документацію по використовуваних бібліотеках, інструкцію з ротації сертифікатів, підтримку протягом 2 тижнів після здачі.

Терміни та вартість

Реалізація мережевого шару з REST, retry, кешуванням та offline-режимом — 1–2 тижні. Додавання GraphQL або WebSocket — ще 1–2 тижні. gRPC — 2–3 тижні, включаючи кодогенерацію. Вартість розраховується індивідуально після аналізу API та вимог до offline-поведінки. Оцінимо проєкт за 1 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.