Нонс — это число, которое однозначно идентифицирует каждый вызов к частным конечным точкам REST API. Нонс требуется для всех аутентифицированных вызовов к Spot REST API, включая конечные точки управления счетом (такие как Balance, QueryOrders, QueryLedgers и т. д.), конечные точки пополнения/заработка (DepositAddresses, DepositStatus и т. д.) и торговые конечные точки (AddOrder, CancelOrder и т. д.).

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

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

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

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

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 имеет свой отдельный нонс, и значение нонса является постоянным, что означает, что последнее использованное значение нонса останется неизменным, даже если ключ API не используется в течение некоторого времени.

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