Мы не раз видели, как команды застревают на этапе подписи запросов: HMAC-SHA512 с двойным хэшированием отпугивает даже опытных разработчиков. Алгоритм Kraken один из самых строгих среди публичных криптобирж. Но на практике интеграция на мобильных платформах занимает полдня, если знать нюансы. Наша команда с более чем 7-летним опытом и 30+ выполненными интеграциями биржевых API гарантирует стабильную работу без блокировок.
Проблемы, которые мы решаем
HMAC-SHA512 — основа подписи, но ошибки возникают из-за неверного декодирования приватного ключа. Privatkey — это Base64-бинарный секрет, а не ASCII-строка. На iOS типичная ошибка: передать Data(privateKey.utf8) вместо Data(base64Encoded: privateKey)!. На Android: забыть декодировать Base64 перед использованием в Mac.getInstance("HmacSHA512"). Результат — подпись сформирована, но сервер возвращает ошибку аутентификации.
Нестандартные имена активов: REST API использует XBT вместо BTC, XDG вместо DOGE. Пары выглядят как XBTZUSD. WebSocket v2 нормализован (BTC/USD), но REST и исторические данные — нет. Без таблицы маппинга пользователь не узнает свои активы. Мы реализуем алиасную карту из AssetPairs.
Rate limiting без подсказок: Kraken не возвращает заголовков с остатком лимита. Превышение — блокировка IP на несколько минут. Мы внедряем адаптивный интервал: баланс раз в 10 секунд, ордера раз в 30, все маркет-данные через WebSocket.
Как работает подпись запросов Kraken?
- Сгенерируйте nonce — Unix timestamp в миллисекундах.
- Вычислите SHA256 от nonce + postData (urlencoded строка).
- Создайте HMAC-SHA512 от urlPath + полученный хэш, используя Base64-декодированный приватный ключ.
Результат — API-Sign. Если nonce не первым в postData, Kraken вернёт EAPI:Invalid nonce. Неправильная подпись может стоить времени и денег: один ошибочный ордер — до $100 убытка. Наш подход исключает такие ошибки. Мы используем CryptoKit на iOS (доступен с iOS 13) и javax.crypto.Mac на Android. Подробнее в документации Kraken API.
Почему имена активов Kraken отличаются от стандартных?
Исторически Kraken использовал ISO-коды с префиксами: X — базовая, Z — котируемая валюта. XBT = Bitcoin, XDG = Dogecoin. Внутри пар префиксы удваиваются: XXBTZUSD. WebSocket v2 перешёл на читаемый формат (BTC/USD), но REST остался старым. Мы строим таблицу из AssetPairs и отображаем удобные названия, а в запросах используем оригинальные.
WebSocket API v2: обновления
С переходом на v2 изменился формат сообщений: вместо {"event":"subscribe"} — {"method":"subscribe","params":{...}}. Авторизация приватных каналов: получаем токен через REST /0/private/GetWebSocketToken, передаём в params.token при подписке на executions (ордера) или balances. Токен живёт 15 минут — необходим механизм обновления. Без него сессия тихо умрёт, и пользователь перестанет видеть обновления ордеров.
| Параметр | WebSocket v1 | WebSocket v2 |
|---|---|---|
| URL | wss://ws.kraken.com | wss://ws.kraken.com/v2 |
| Подписка | event: subscribe | method: subscribe, params: {...} |
| Имена активов | XBT/USD | BTC/USD |
| Приватные каналы | Токен в параметрах | Токен в params.token |
Пример кода подписи на Swift:
import CryptoKit func generateSignature(urlPath: String, body: Data, secret: String) -> String { let secretData = Data(base64Encoded: secret)! let nonce = "\(Date().timeIntervalSince1970 * 1000)" var postData = "nonce=\(nonce)" if let additionalData = String(data: body, encoding: .utf8) { postData += "&\(additionalData)" } let sha256 = SHA256.hash(data: postData.data(using: .utf8)!) let hmac = HMAC<SHA512>.authenticationCode(for: urlPath.data(using: .utf8)! + sha256.data, using: SymmetricKey(data: secretData)) return hmac.compactMap { String(format: "%02x", $0) }.joined() } | Данные | REST (поллинг) | WebSocket (push) |
|---|---|---|
| Баланс | /0/private/Balance | balances channel |
| Ордера | /0/private/OpenOrders | executions channel |
| Рыночные данные | /0/public/Ticker | ticker channel |
Что входит в работу
- Анализ текущей архитектуры приложения и выбор подходящего стека (iOS: URLSession + Combine, Android: OkHttp + Coroutines).
- Реализация подписи и обработки ошибок (включая реконнект WebSocket).
- Настройка push-уведомлений (APNs/FCM) для подтверждения ордеров.
- Тестирование на реальных торговых данных с симуляцией rate limit.
- Документация — описание эндпоинтов, примеры запросов, инструкция по эксплуатации.
- Гарантия — 30 дней бесплатной поддержки после запуска.
Хотите избежать этих проблем? Закажите интеграцию Kraken у нас — получите бесплатный анализ вашего приложения. Оценим ваш проект за один рабочий день. Свяжитесь с нами для консультации.
Стек и сроки
Для нативного iOS: CryptoKit (HMAC-SHA512), URLSessionWebSocketTask, Combine Publisher. Для Android: Mac с HmacSHA512, OkHttp WebSocket, Kotlin Coroutines + Flow. Интеграция spot (без маржи) — 3–4 недели. Futures API — отдельно, с другой аутентификацией. Если хотите оценить сроки для вашего проекта, свяжитесь с нами.
Оценим проект за один рабочий день. Получите консультацию по интеграции Kraken в ваше приложение — бесплатно.