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,如果不存在且從未做過刪除操作,用戶可直接退出頁面,無需做更多的升級操作。
否則,用戶的賬戶裏可分為兩種情況:
- 即存在V1的API key也存在V2的API key,為防止意外發生,請根據以下操作指南完成升級。
- 只存在V1的API key,請根據以下操作指南完成升級。
步驟1:
進入KuCoin網頁(僅限PC端),刪除V1版本API key,創建V2版本API key(目前默認只能創建V2的key)
步驟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升級操作已完成。