API 常見問答
一、請問 Passphrase 指的是什麼呢？
Passphrase 是您申請 APIKey 時填寫的密碼，需要您自行記住，一旦忘記無法找回，只能重新創建 APIKey 。
二、請問如何創建模擬盤 APIKey ？
模擬盤 API 交易需要在模擬盤上創建 APIKey ：登錄 OKX 賬戶—>交易—>模擬交易—>個人中心—>創建模擬盤 APIKey —>開始模擬交易
三、APIKey 會過期嗎？
1、實盤未綁定 IP 且擁有交易或提幣權限的 APIKey ，將在閒置 14 天之後自動刪除，只有調用私有類或賬戶類需要身份驗證的接口才不算是閒置，比如查看賬戶餘額、賬單數據、下單操作等。
2、綁定了 IP 或權限只有只讀的 APIKey 不會過期。
四、接口下單合約能否以 USDT 或者幣爲單位下單？
不可以；合約下單，接口默認是以張爲單位下單的；如果您需要計算張幣轉換，可以參考張幣轉換接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-unit-convert
五、接口如何獲取漲跌幅？
接口無法直接獲取到漲跌幅，但是可以通過計算公式計算：最新成交價與 24 小時前那一分鐘的K線開盤價相比的漲跌數值 / 24 小時前一分鐘的K線開盤價*100% 。可通過行情接口獲取上述公式數據：https://www.okx.com/docs-v5/zh/#order-book-trading-market-data-get-ticker（last-open24h）/ open24h。
六、下單時報錯：51000 Parameter posSide error 是什麼原因？
需要先檢查一下賬戶模式：單向持倉/雙向持倉，可通過：https://www.okx.com/docs-v5/zh/#trading-account-rest-api-get-account-configuration 獲取 posMode 查看。
1、在單向持倉下且使用合約下單情況下，posSide 參數必填，填寫 long 或 short 。
2、如果是雙向持倉，或者是在單向持倉下進行現貨、槓桿交易posSide僅支持傳入net或者是不傳。
七、合約面值和最小下單數量可以通過哪個接口進行獲取？
可以直接使用獲取交易產品基礎信息接口獲取：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instruments 合約面值：ctVal，最小下單數量：minSz。
八、instId 的格式是什麼樣的？
可以直接使用獲取交易產品基礎信息接口獲取：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instrumentsinstId格式舉例：現貨/現貨槓桿：BTC- USDT永續合約：幣本位：BTC-USD-SWAP、U本位：BTC- USDT -SWAP 字母必須全部大寫交割合約：幣本位：BTC-USD-210326 、U本位：BTC- USDT -210326 年份後兩位+當週或者次周或當月或次月或當季或次季時間期權合約：BTC-USD-210326-2000-C 看漲期權 、BTC-USD-210326-2000-P 看跌期權
九、怎麼設置止盈止損？
1、如果是下單附加止盈止損，可以參考下單接口：https://www.okx.com/docs-v5/zh/#order-book-trading-trade-post-place-order 的attachAlgoOrds 數組參數。
2、如果是單獨下單止盈止損，可以參考策略委託接口：https://www.okx.com/docs-v5/zh/#order-book-trading-algo-trading-post-place-algo-order。
十、設置止盈止損觸發價時報錯：51046、51047、51048、51049
止盈觸發價 / 止損觸發價設定規則：賣出時，止盈觸發價大於最新成交價，止損觸發價小於最新成交價；買入時，止盈觸發價小於最新成交價，止損觸發價大於最新成交價。
十一、接口報錯：50102 Timestamp request expired
這是時間戳過期報錯，需要您調用獲取系統時間接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-system-time，將您的本地時間跟我們的服務器時間進行一下同步，時間差值控制在 30s 內就可以有效規避這個問題的，需要注意的是，請求頭中的時間是 UTC0 時的時間，獲取服務器時間接口獲取到的時間是 UTC+8 的時間戳。
十二、接口報錯：50101 APIKey does not match current environment
這個是因爲 APIKey 和當前環境不匹配導致的，實盤調用需要使用實盤 APIKey ，且請求的header 裏面 x-simulated-trading 這個參數值需要爲 0 ；模擬盤調用需要使用模擬盤 APIKey ，且請求的 header 裏面 x-simulated-trading 這個參數值需要爲 1 。
十三、接口報錯：51010 Request unsupported under current account mode
這個跟您的賬戶模式有關係，如果您要下單現貨槓桿或合約，需要調整爲除現貨模式外的其他3種模式！您可以通過接口：https://www.okx.com/docs-v5/zh/#trading-account-rest-api-set-position-mode設置，也可以在網頁或 App 上設置；注意：首次設置必須要在頁面或 App 上設置：交易頁面右上角設置圖標-賬戶模式。
十四、接口報錯：51121 Order quantity must be a mult IP le of the lot size.
在 API 中合約下單是以張爲單位的，必須是該幣對最小下單數量的倍數，最小下單數量可以通過產品接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instruments 的minSz字段獲取。
十五、提幣報錯：58207 Withdrawal address is not whitelisted for verification exemption；在提幣頁面關閉了白名單校驗爲什麼還是會報錯呢？
使用 API 接口提幣是必須要在頁面添加提幣地址並勾選免驗證按鈕的，頁面是否關閉白名單校驗並不會影響接口功能。
十六、接口報錯： 50004 API endpoint request timeout (does not mean that the request was successful or failed, please check the request result)
50004一般是服務器壓力過大導致，每天 8、16、24 點是資金費收取時間點，此時服務器壓力較大，建議錯開這幾個整點進行交易，其他時刻報錯 50004 可以稍後重試；如果遇到下單報錯 50004，不代表接口請求實際結果，請求可能成功也可能失敗，請您以實際結果爲準！
溫馨提示：
如果以上 QA 無法解答您的疑問，或您還有其他 API 相關問題，可以通過 OKX App 掃碼聯繫我們！打開 App，點擊左上角全功能圖標，再點擊右上角掃碼圖標，掃描右側二維碼即可。
