KuCoin API key 升級操作指南

為了進一步提高API安全性,KuCoin對API key進行了升級,推出了具有更高安全特性的V2版本。請您於2021年5月13日15:00:00(UTC+8)前進行升級並與對應的大客戶經理反饋升級進度,升級方式:刪除V1版本,重新創建V2版本API key,並使用V2方式認證。

 

前提:

進入KuCoin網頁(僅限PC端),進入API創建頁面,查看自己的賬戶裏面是否存在V1的API key,如果不存在且從未做過刪除操作,用戶可直接退出頁面,無需做更多的升級操作。

否則,用戶的賬戶裏可分為兩種情況:

  1. 即存在V1的API key也存在V2的API key,為防止意外發生,請根據以下操作指南完成升級。
  2. 只存在V1的API key,請根據以下操作指南完成升級。

 

步驟1:

進入KuCoin網頁(僅限PC端),刪除V1版本API key,創建V2版本API key(目前默認只能創建V2的key)

mceclip0.png

 

步驟2:

創建V2版本的API key後,您將得到以下三個信息:

  • Key
  • Secret
  • Passphrase

Key和Secret由KuCoin隨機生成並提供,Passphrase是您在創建API時使用的密碼。以上信息若遺失將無法恢復,需要重新申請API KEY。

 

API權限

您可在KuCoin Web端管理API權限。API權限分為以下幾類:

 

通用權限 - 允許API訪問大部分的GET請求。

交易權限 - 允許API具有下單權限。

提現權限 - 允許API劃轉資金,包含充值和提現。子賬號沒有提現權限。 授權提現權限時請注意,不需要郵箱驗證和谷歌驗證就可以使用API進行轉賬。

請參考下方API文檔,看接口具體需要哪些權限。

 

步驟3:

若您使用了KuCoin官方維護的任何SDK, 請您將SDK升級到最新版本,並直接替換步驟2中的三個信息即可重啟程序。 至此,您的API key升級操作已完成。

SDK: https://github.com/Kucoin

 

步驟4:

若您未使用KuCoin官方維護的SDK,請按照以下提示調整您的代碼:

 

創建請求

Rest請求頭必須包含以下內容:

 

KC-API-KEY API-KEY以字符串傳遞

KC-API-SIGN 簽名

KC-API-TIMESTAMP 請求的時間戳

KC-API-PASSPHRASE 創建API時填的API-KEY的密碼

KC-API-KEY-VERSION API-KEY版本號,可通過API管理頁面查看版本號

 

簽名

請求頭中的 KC-API-SIGN:

 

使用 API-Secret 對 {timestamp + method + endpoint + body} 拼接的字符串進行HMAC-sha256加密。

再將加密內容使用 base64 編碼。

請求頭中的 KC-API-PASSPHRASE:

 

對於V1版的API-KEY,請使用明文傳遞

對於V2版的API-KEY,需要將KC-API-KEY-VERSION指定為2,並將passphrase使用API-Secret進行HMAC-sha256加密,再將加密內容通過base64編碼後傳遞

注意:

 

加密的 timestamp 需要和請求頭中的KC-API-TIMESTAMP保持一致

用於加密的body需要和請求中的Request Body的內容保持一致

請求方法需要大寫

對於 GET, DELETE 請求,endpoint 需要包含請求的參數(/api/v1/deposit-addresses?currency=BTC)。如果沒有請求體(通常用於GET請求),則請求體使用空字符串””。

 

至此,您的API key升級操作已完成。

語言