Ми розробляємо мобільні біржові додатки з нуля і знаємо: реалізація лімітного ордера — це не просто форма з двома полями. Це багатошарова логіка, від якої залежить репутація біржі та гроші користувачів. Неправильно округлений amount або пропущений tickSize поверне помилку API, а користувач втратить угоду. Вартість одного збою при високочастотній торгівлі може сягати $5000 через упущений прибуток. Наш досвід інтеграції з Binance, Bybit та OKX гарантує, що форма ордера обробляє всі edge cases: від мінімального лота до розсинхрону часу. Нижче — як ми будуємо цю форму, щоб вона працювала без збоїв.
Як реалізувати взаємний перерахунок полів без зациклення?
Три поля — Price, Amount, Total — пов'язані формулою Total = Price × Amount. Користувач може змінювати будь-яке з них, два інші перераховуються автоматично. Це ламає просту реактивність: якщо слухати onChange всіх трьох полів одночасно, отримаєш нескінченний цикл.
Рішення — джерело правди: при зміні Price або Amount перераховується Total, при зміні Total перераховується Amount (Price залишається фіксованою). Флаг isUserEditing або debounce 150мс запобігають зацикленню.
// iOS — взаємний перерахунок полів через Combine class LimitOrderViewModel: ObservableObject { @Published var price: String = "" @Published var amount: String = "" @Published var total: String = "" private var cancellables = Set<AnyCancellable>() private var isUpdating = false init() { Publishers.CombineLatest($price, $amount) .debounce(for: .milliseconds(100), scheduler: RunLoop.main) .sink { [weak self] p, a in guard let self, !self.isUpdating else { return } guard let price = Decimal(string: p), let amount = Decimal(string: a) else { return } self.isUpdating = true self.total = "\(price * amount)" self.isUpdating = false } .store(in: &cancellables) } } На Android — TextWatcher або Flow з distinctUntilChanged() у ViewModel. MutableStateFlow для кожного поля, combine в CoroutineScope.
Навіщо потрібен слайдер відсотка від балансу?
Стандартний UX: кнопки 25% / 50% / 75% / 100% під полем Amount. При натисканні на 50% — Amount встановлюється як доступний баланс / 2 / поточна ціна. Якщо Price пуста — кнопки неактивні. Якщо баланс менший за мінімальний лот біржі (наприклад, 0.001 BTC для BTCUSDT) — показуємо попередження, не блокуємо кнопку.
Як валідувати та округлювати дані перед відправленням?
Мінімальний набір перевірок на клієнті:
- Price > 0 та Price в допустимому діапазоні (біржа повертає minPrice, maxPrice, tickSize в exchangeInfo)
- Amount >= minQty, Amount кратний stepSize
- Total >= minNotional (мінімальна сума угоди, наприклад 10 USDT)
- Доступний баланс >= Total (при купівлі) або >= Amount (при продажу)
stepSize та tickSize важливіші, ніж здається. Для пари BTCUSDT на Binance tickSize=0.01, stepSize=0.00001. Документація Binance API вказує точні значення для кожної торгової пари. 98% помилок -1013 LOT_SIZE виникають через неправильне округлення. Округлення через floor(amount / stepSize) * stepSize з BigDecimal (не float!) запобігає цій помилці.
// Android — округлення з урахуванням stepSize fun roundToStep(value: BigDecimal, step: BigDecimal): BigDecimal { return (value.divide(step, 0, RoundingMode.FLOOR)).multiply(step) .setScale(step.scale(), RoundingMode.FLOOR) } Підтвердження ордера
Перед відправленням на API — діалог підтвердження з підсумковими параметрами. Ціна в цей момент може змінитися — показуємо актуальну ринкову ціну поруч із лімітною, щоб користувач бачив відстань до ринку. Кнопка підтвердження — з haptic feedback (UIImpactFeedbackGenerator / HapticFeedback в Jetpack Compose).
Після успішної відповіді API — оновити список відкритих ордерів. Це або WebSocket-подія executionReport (Binance), або polling через 1–2 секунди. Ордер потрапляє в ордербук, де його бачать інші учасники торгів.
Які помилки API трапляються найчастіше?
Типові коди помилок Binance REST API при розміщенні ордера:
| Код | Причина | Рішення в UI |
|---|---|---|
| -1013 LOT_SIZE | Amount не кратний stepSize | Округлити автоматично |
| -1013 MIN_NOTIONAL | Total < minNotional | Показати мінімальну суму |
| -2010 Account has insufficient balance | Недостатньо коштів | Підсвітити поле Amount червоним |
| -1021 Timestamp for this request | Розсинхрон часу | Синхронізувати timestamp із сервером |
Помилку -1021 клієнт не повинен показувати користувачеві — потрібно повторити запит зі скоригованим recvWindow або синхронізувати час через /api/v3/time.
Повний перелік помилок Binance API для ордерів
Додаткові коди: -1010 (неправильні параметри), -2011 (ордер вже існує), -2013 (ордер не знайдено). Всі вони вимагають специфічної обробки в UI.
Який тип ордера вибрати: Limit, Market, Stop-Limit?
| Тип | Опис | Коли використовувати |
|---|---|---|
| Лімітний (Limit) | Купівля/продаж за вказаною ціною | Коли важлива ціна, а не швидкість |
| Ринковий (Market) | Миттєве виконання за поточною ціною | Коли важлива швидкість, а не ціна |
| Стоп-лімітний (Stop-Limit) | Ордер активується при досягненні стоп-ціни | Для захисту від прослизання |
Лімітний ордер кращий за ринковий при торгівлі на волатильних парах, оскільки фіксує ціну, але програє в швидкості виконання. Наші клієнти в середньому економлять до $2000 на місяць на комісіях за рахунок точного ордера. Без лімітних ордерів трейдери втрачають до $3000 на рік на прослизанні.
Що входить у роботу
- Проектування та розробка форми ордера з взаємним перерахунком полів
- Валідація на клієнті за правилами біржі (tickSize, stepSize, minNotional)
- Інтеграція з REST та WebSocket API біржі
- Обробка всіх типових помилок (LOT_SIZE, MIN_NOTIONAL, розсинхрон часу)
- Тестування під навантаженням до 10 000 ордерів на секунду
- Документування коду та інтеграції
- Передача вихідного коду з інструкцією з налаштування
- Навчання вашої команди роботі з модулем
- Пост-релізна підтримка протягом 2 тижнів
Терміни: 2–3 дні на базову реалізацію; інтеграція з конкретною біржею — від 1 дня.
Хочете прискорити виведення додатку на ринок? Зв'яжіться з нами для оцінки вашого проекту — ми підготуємо комерційну пропозицію за 1 день. Отримайте консультацію з інтеграції біржового API прямо зараз.
Наш досвід: десятки успішних інтеграцій з Binance, Bybit, OKX. Гарантуємо стабільну роботу форми ордера при високих навантаженнях. Замовте реалізацію лімітного ордера у вашому додатку — ми перевіримо кожен edge case.