Что такое nonce?

Одноразовый код (nonce) — это число, которое однозначно идентифицирует каждый вызов частных конечных точек REST API. Одноразовый код требуется для всех аутентифицированных вызовов Spot REST API, включая конечные точки управления счетом (такие как Баланс, Запросы ордеров, Запросы реестров и т. д.), конечные точки пополнения/заработка (Адреса депозитов, Статус депозита и т. д.), а также торговые конечные точки (Добавить ордер, Отменить ордер и т. д.).

Для аутентификации Futures REST, значение nonce не требуется.

Одноразовый код (nonce) реализован как счетчик, который должен быть уникальным и увеличиваться с каждым вызовом API. Например, если начальное значение nonce равно 0, последующие действительные значения nonce будут 1, 2, 3, 4 и так далее.

Хотя простой счетчик, подобный описанному выше, обеспечил бы действительный nonce, более эффективный метод генерации действительных значений nonce — это использование метки времени UNIX в миллисекундах (количество миллисекунд с 1 января 1970 года в 00:00:00 UTC). Использование метки времени с разрешением в миллисекунды или выше для nonce гарантирует выполнение всех требований к действительному nonce (уникальность и постоянное увеличение) и предоставляет достаточные значения для трейдеров, совершающих быстрые последовательные вызовы API (маркет-мейкеры, высокочастотные торговые боты и т. д.).

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

Python

api_nonce = str(int(time.time()*1000))

JavaScript

var api_nonce = Date.now().toString()

PHP

$api_nonce = explode(' ', microtime());
$api_nonce = $api_nonce[1].substr($api_nonce[0], 2, 3);

Каждый ключ API имеет свой отдельный nonce, и значение nonce является постоянным, что означает, что последнее использованное значение nonce останется неизменным, даже если ключ API не используется в течение некоторого времени.

Обратите внимание, что невозможно сбросить nonce для конкретного ключа API. В случае, если значение nonce становится недействительным (например, из-за случайного использования метки времени UNIX, относящейся к далекому будущему), решением будет удалить затронутый ключ API и сгенерировать новый ключ API, который автоматически будет иметь новое начальное значение nonce, равное 0 (нулю).