Часто задаваемые вопросы о расширенных возможностях API

Last updated: 25 нояб. 2025 г.

Возможные значения статуса для транзакций пополнения/вывода средств

Используя конечные точки перевода REST API, клиенты могут вносить/выводить средства со своего аккаунта Kraken и запрашивать статус транзакции по внесению/выводу средств в реальном времени.

Пополнения/вывод средств проходят через несколько этапов между первоначальным запросом и завершением транзакции, поэтому конечные точки перевода будут возвращать различное значение статуса в зависимости от времени их вызова.

Обратите внимание, что значения статуса изначально были взяты со страниц 16/17 документа Internet Financial Exchange Protocol (IFEX), но значения были немного изменены для наилучшего соответствия криптовалютным транзакциям (например, используются не все возможные значения статуса).

Пополнение

Возможные значения статуса для транзакций по пополнению следующие:

•
Выполняется = пополнение получено, но все еще требует дополнительных подтверждений в блокчейне.
•
Успешно= пополнение достигло необходимого количества подтверждений в блокчейне.
•
Ошибка= не удалось выполнить пополнение (по одной или нескольким причинам).

Ниже приведены некоторые примеры того, как указанные выше значения статуса будут отображаться в ответах от конечной точки DepositStatus:

Статус «Выполняется»: {"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Статус «Успешно»: {"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Вывод

Возможные значения статуса для транзакций по выводу средств следующие:

•
Инициировано = запрос на вывод средств получен и проверяется на предмет корректности (наличие ограничений на переводы для счета и т. д.).
•
В ожидании = вывод средств ожидает обработки нашим шлюзом финансирования.
•
Выполняется = выведенные средства отправлены в блокчейн (в этот момент станет доступен идентификатор транзакции в блокчейне).
•
Успешно= транзакция по выводу средств имеет как минимум 1 подтверждение в блокчейне.
•
Удерживается= вывод средств был приостановлен и должен быть вручную проверен нашими специалистами по переводам.
•
Ошибка= не удалось вывести средства (по одной или нескольким причинам).

Ниже приведены некоторые примеры того, как указанные выше значения статуса будут отображаться в ответах от конечной точки WithdrawStatus:

Статус «Инициировано»: {"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Статус «В ожидании»:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Статус «Выполняется»: {"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Статус «Успешно»: {"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Статус «Ошибка»: {"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

Дополнительная информация о пополнениях/выводах средств доступна на страницах службы поддержки о денежных переводах и переводах криптовалюты.

Как получить исторические данные о времени и продажах (историю торговли) с помощью конечной точки REST API Trades?

Конечная точка REST API OHLC предоставляет лишь ограниченный объем исторических данных, а именно 720 точек данных за запрошенный интервал. Например, запрос данных OHLC с интервалом в 1 минуту вернет последние 720 минут (12 часов).

Для приложений, которым требуются дополнительные данные OHLC или тиковые данные, можно получить всю историю торгов на наших рынках (историческое время и объемы продаж) через конечную точку REST API Trades. OHLC для любого периода времени и любого интервала может быть создан на основе исторических данных о времени и объемах продаж.

Конечная точка Trades принимает необязательный параметр since, который указывает начальную дату/время данных. Значение since представляет собой отметку времени UNIX с разрешением в наносекундах (стандартная отметка времени UNIX в секундах с 9 дополнительными цифрами).

Например, вызов конечной точки Trades по адресу https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 вернет историческое время и данные о продажах по XBT/USD с 1 июня 2019 года в 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Последующие вызовы конечной точки Trades должны заменять значение параметра since на значение последнего параметра из результатов предыдущего вызова, например, https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Использование специального значения since, равного 0 (нулю), вернет исторические данные о времени и продажах с начала торговли на рынке (начиная с самой первой сделки).

Как размещать, просматривать и отменять ордера, используя пользовательский идентификатор?

Пользовательский идентификатор – это предоставленный клиентом идентификатор ордера, который можно использовать вместо фактического (предоставленного через API) идентификатора ордера для некоторых задач по управлению ордерами (в частности, для отмены ордеров).

Пользовательские идентификаторы реализованы максимально гибко и поэтому могут использоваться различными способами, в том числе:

•
как уникальный идентификатор (где каждый ордер имеет свой идентификатор пользователя),
•
для группировки связанных ордеров (например, группировка ордеров с разным уровнем кредитного плеча),
•
в качестве резервного идентификатора на случай, если фактический идентификатор ордера неизвестен.

Пользовательский идентификатор должен представлять собой числовое значение от 1 до 2 147 483 647 (по сути, любое положительное 32-битное число) и, следовательно, может быть реализован как простой счетчик, как случайное знаковое 32-битное значение или даже как временная метка в секундах (хотя этот способ перестанет работать после 19 января 2038 года, 3:14:07 UTC).

Размещение ордеров с пользовательским идентификатором

Ордера можно размещать с прикрепленным идентификатором пользователя, вызвав конечную точку AddOrder и включив параметр userref с идентификатором пользователя в качестве значения:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Просмотр ордеров с пользовательским идентификатором

Orders that already have a user reference attached can be viewed by calling the Open/Closed/QueryOrders endpoints and including the userref parameter with the existing user reference as the value (in this case the user reference acts as a filter, displaying only the associated orders):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Отмена ордеров с пользовательским идентификатором

Ордера, за которыми уже закреплен пользовательский идентификатор, можно отменить с помощью идентификатора пользователя, вызвав конечную точку CancelOrder и используя идентификатор пользователя в качестве значения txid (вместо значения идентификатора ордера):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Обратите внимание, что все открытые ордера с одинаковым пользовательским идентификатором будут отменены, поэтому можно сделать один вызов CancelOrder, чтобы отменить несколько ордеров одновременно (на что указывает значение счетчика 3 в следующем ответе):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

Почему я получаю сообщение об ошибке 403 при использовании Kraken API?

Эта проблема может быть связана с Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

ОБРАТИТЕ ВНИМАНИЕ: У Kraken включена функция проверки безопасности браузера (Browser Integrity Check).

Она может сработать, если ваш запрос содержит подозрительные заголовки. Например, в вашем запросе может отсутствовать пользовательский агент или использоваться нестандартный пользовательский агент; поэтому, пожалуйста, проверьте заголовки запроса.

Если вам не удается создать стандартные запросы, которые разрешены нашей системой, отправьте нам полную копию запросов, которые вы пытаетесь выполнить, включая ваш IP-адрес и все заголовки. Эта информация позволит нам провести дальнейшее расследование.

Kraken предлагает тестовую среду для API?

API для фьючерсов

Для наших API Futures REST и WebSocket (futures.kraken.com) мы предлагаем полноценную тестовую среду, используя URL-адрес API demo-futures.kraken.com.

Тестовые среды REST, WebSocket и FIX

Для наших REST/WebSocket API и FIX API мы в настоящее время предлагаем тестовую среду для квалифицированных клиентов. Для доступа к этой среде требуется пройти процесс регистрации, который можно начать, связавшись напрямую со специалистами по API.

Тестирование API с использованием параметра тестирования Validate

При размещении ордера через конечные точки REST API AddOrder или WebSocket API addOrder входной параметр validate можно использовать для имитации ордера.

Вызов AddOrder/addOrder с параметром validate, установленным в значение true (validate=1, validate=true, validate=anything и т. д.), приведет к проверке информации об ордере на наличие ошибок, но ответ API никогда не будет содержать идентификатор ордера (который всегда возвращался бы при успешном создании ордера без параметра validate).

Пример вызова AddOrder с параметром validate (обратите внимание на отсутствие идентификатора ордера):

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Небольшие реальные ордера и/или ордера с крайними ценовыми точками

Для комплексного тестирования API с использованием параметра Validate мы рекомендуем размещать небольшие рыночные ордера (ордера с минимальным размером ордера) или лимитные ордера, цена которых значительно отличается от текущей рыночной цены (например, разместить лимитный ордер на продажу ETH/USD по цене 800 долларов США при рыночной цене 200 долларов США).

Тестирование с использованием реальных ордеров позволяет вашему коду API взаимодействовать с нашим API в реальных условиях, поэтому каждый аспект тестирования будет точным (как ваши ордера влияют на книгу ордеров и т. д.).

Обновление TLS, которое может повлиять на ваши API-подключения

По соображениям безопасности мы недавно прекратили поддержку TLS 1.0 и 1.1. Если при попытке подключения к нашему API вы сталкиваетесь с сообщениями об ошибках соединения SSL/TLS, это, вероятно, связано с использованием одного из этих устаревших стандартов. Вам потребуется изменить клиент API, чтобы принудительно использовать TLS 1.2/1.3, или обновить версию .NET до 4.6 или выше, где TLS 1.2/1.3 используется по умолчанию.

Калькулятор аутентификации REST API (Google Sheet)

Следующая таблица Google может быть использована для расчета подписи аутентификации REST API для любой комбинации входных данных:

•
Закрытый (секретный) ключ API
•
Конечная точка API (Balance, TradeBalance, QueryOrders и т. д.)
•
Значение nonce (подробнее см. на странице поддержки «Что такое nonce?»)
•
Входные параметры конечной точки (например, asset=doge)

Калькулятор можно использовать для проверки корректности реализации алгоритма аутентификации, что позволит избежать потенциальных проблем (в частности, непредвиденных ошибок, связанных с недействительным ключом) на более поздних этапах разработки.

Инструкции по использованию

1
Откройте калькулятор аутентификации REST API в Chrome (или любом другом современном веб-браузере).
2
Создайте копию калькулятора на вашем Google Диске через меню «Файл» -> «Создать копию» (для этого вам потребуется войти в свой аккаунт Google).
3
Измените ключ API, конечную точку API, значение nonce и поля входных данных, используя ваш ключ API и данные запроса.
4
Сравните рассчитанную подпись аутентификации API со значением, рассчитанным вашим кодом API (два значения должны полностью совпадать).

В целях безопасности мы рекомендуем использовать калькулятор аутентификации с временным ключом API, а затем удалить ключ API из вашего аккаунта, как только будет подтверждена корректность реализации вашей подписи аутентификации.

Пример

Нужно ли мне использовать обертку клиентской библиотеки?

Главное преимущество использования наших оберток для клиентских библиотек заключается в том, что вам не нужно тратить время и силы на создание подписей API – это уже сделано за вас.

Если вы планируете вызывать только публичные методы, вы можете отказаться от клиентских библиотек, так как аутентификация не требуется.

Список доступных оберток можно найти здесь.