Nonce란 무엇인가요?

Nonce는 REST API 프라이빗 엔드포인트에 대한 각 호출을 고유하게 식별하는 숫자입니다. Nonce는 계정 관리 엔드포인트(예: Balance, QueryOrders, QueryLedgers 등), 자금/수익 엔드포인트(DepositAddresses, DepositStatus 등) 및 거래 엔드포인트(AddOrder, CancelOrder 등)를 포함하여 Spot REST API에 대한 모든 인증된 호출에 필요합니다.

Futures REST 인증의 경우, nonce 값은 필요하지 않습니다.

Nonce는 고유해야 하며 API 호출마다 증가해야 하는 카운터로 구현됩니다. 예를 들어, 시작 nonce 값이 0이라고 가정하면, 후속 유효 nonce 값은 1, 2, 3, 4 등이 됩니다.

위와 같은 간단한 카운터가 유효한 nonce를 제공할 수 있지만, 유효한 nonce 값을 생성하는 더 효과적인 방법은 밀리초 단위의 UNIX timestamp(1970년 1월 1일 00:00:00 UTC 이후의 밀리초 수)를 사용하는 것입니다. nonce에 밀리초 또는 더 높은 해상도의 timestamp를 사용하면 유효한 nonce의 모든 요구 사항(고유성 및 항상 증가)이 충족됨을 보장하며, 빠른 연속 API 호출을 하는 트레이더(market makers, high frequency trading bots 등)에게 충분한 값을 제공합니다.

다음은 다양한 프로그래밍 언어에서 유효한 밀리초 해상도 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 값은 영구적입니다. 즉, API 키가 한동안 사용되지 않더라도 가장 최근에 사용된 nonce는 변경되지 않습니다.

특정 API 키의 nonce를 재설정하는 것은 불가능합니다. nonce 값이 유효하지 않게 되는 경우(예: 실수로 미래의 UNIX timestamp를 사용하는 경우), 해결책은 해당 API 키를 삭제하고 새 API 키를 생성하는 것입니다. 새 API 키는 자동으로 0(영)의 새로운 시작 nonce 값을 갖게 됩니다.