【2026】OKX API 串接教學｜建立金鑰、權限與 IP 白名單設定
OKX 是全球用戶數前三大的知名加密貨幣交易所，除了在網站或 App 手動操作，使用者也能建立 API 金鑰，授權外部程式在指定範圍內讀取帳戶資料或執行交易。
而我們的 Carry Labs 應用程式需要透過 API 連接 OKX 帳戶，才能取得餘額、委託與倉位狀態，並依策略送出或取消訂單。這本篇將以 OKX 網頁版為主，完整說明如何進入 API 頁面、設定權限、建立 Passphrase，並將三項憑證填入 Carry Labs。
在閱讀本文章前，請確保您已註冊 OKX，可以使用我們 Carry Labs 連結註冊，獲得 20% 手續費折扣專屬優惠：OKX 註冊教學。
API 是什麼？為何 Carry Labs 需要串接 API？
API 是 Application Programming Interface（應用程式介面）的縮寫，可視為 OKX 與 Carry Labs 之間的資訊管道。完成授權後，Carry Labs 應用程式只會在該組金鑰被允許的範圍內呼叫 OKX API。
例如，Read 唯讀權限可用來查詢帳戶、帳單、訂單或倉位；Trade 交易權限則可用於建立與取消訂單、執行部分資金劃轉及調整交易設定。套利策略往往需要兩個市場盡量同步成交，因此由程式透過 API 執行，通常比人工切換頁面更能降低時間差。
建立 OKX API 前需要準備什麼？
開始前請先確認：
- 已完成 OKX 帳戶登入，以及所在地區要求的身份驗證與安全設定。
- 可正常接收 OKX 要求的 Email、手機、驗證器或 Passkey 安全驗證。
更多細節，可以參考這篇文章：OKX 註冊教學。
OKX API 設定 圖文流程教學
Step 1：登入 OKX 並進入「API 與連接」
使用瀏覽器開啟你所屬地區的 OKX 官方網站並登入。登入後點選右上角用戶選單，並進入「總覽」。
接著選擇「API 與連接憑證」。
然後點擊右上角的「創建 API Key」。
Step 2：選擇帳戶與用途
- 1在建立頁面輸入一個容易辨識的 API 名稱，例如「Carry Labs 應用程式」。而在「用途」這邊，保留預設的「API 交易」即可。
- 2「權限」這裡，新增「交易」權限。
- 3在「IP 白名單」選項，請關閉白名單。值得一提的是，之所以不綁定 IP，是因為一般家用與行動網路多為動態 IP；數據機重新連線、路由器重啟、切換 Wi-Fi，或電信商重新分配位址後，對外 IP 都可能改變。若綁定目前的 IP，日後可能因 IP 變動而無法讀取資料或執行交易。不綁定 IP，代表這組 API 不會限制只能由特定位址使用，因此裝置與憑證安全更加重要。請只在自己管理且可信任的電腦上使用 Carry Labs，並保持作業系統、防毒軟體與程式版本為最新狀態。不要使用共用電腦、破解軟體、陌生瀏覽器擴充功能或來路不明的遠端控制工具。
關閉白名單時，請勾選「我已瞭解並接受此風險」，並點擊繼續。
- 1接著，請自行設定此 API 專屬的密碼（Passphrase），這組密碼將會在後續驗證和 Carry Labs 中使用到，需為 8～32 的字元，至少一個大小寫、數字和符號。
- 2點擊「提交全部」，即可完成創建。
接著，OKX 便會要求我們完成一系列的驗證，包含手機驗證、Email 驗證及人臉驗證，請依序完成。
Step 3：完成安全驗證並複製三項憑證
完成後，請點擊新創建的 API 右側，進入編輯介面。
此時 OKX 會要求我們再次進行驗證，包含輸入前面設定的 API 專屬密碼，並發送、填入手機驗證碼，最後點擊「確認」。
完成後，請停留在此畫面，並稍晚貼上 Carry Labs 應用程式：
- API Key：公開識別這組 API 的字串。
- 密鑰（Secret Key）：用來產生請求簽章的私密金鑰。
需要注意的是，Secret Key 只會在此處完整顯示。不要用截圖、Email、聊天訊息、公開 GitHub、未加密記事本或一般雲端文件保存 API Key、Secret Key 與 Passphrase；任何一項遺失或疑似外洩，都應刪除舊金鑰並重建。
Step 4：在 Carry Labs 填入 OKX 憑證
登入 Carry Labs 應用程式，進入右上角的「交易所 API Key」設定。
接著在 OKX 對應列依欄位貼上：
- OKX 的 API Key → Carry Labs 的「API Key」。
- OKX 的 密鑰 → Carry Labs 的「密鑰 Secret Key」。
- 建立時設定的專屬密碼（Passphrase） → Carry Labs 的「Passphrase」。
完成後，點擊「儲存」。三項資料都必須完全一致，且前後不能有空格、換行或漏字。
其他常見疑問
Q：OKX API 會自動失效嗎？
A：會失效，但不是建立後固定幾天就失效。依 OKX 官方目前規則，未綁定 IP，且開啟交易 Trade 或提領 Withdraw（我們沒有開啟）權限的 API Key，如果連續 14 天沒有使用，會被 OKX 自動刪除。因此，Carry Labs 正常連線並持續讀取餘額、訂單或倉位時，理論上就會被視為持續使用，不會因為單純沒有下單滿 14 天而失效。但若使用者解除串接、關閉程式，或 Carry Labs 連續 14 天都沒有成功呼叫 OKX 的私有 API，該金鑰便可能被自動刪除。
Q：OKX API 有哪些安全注意事項？
- 不要把任何 API 憑證傳給自稱 OKX 或 Carry Labs 客服的陌生帳號。
- 不要把憑證貼進 LINE、Telegram、Discord、AI 聊天、遠端協助畫面或公開程式碼。
- 每個服務建立獨立金鑰，只授予最低必要權限；停止使用後立即刪除。
- 優先使用專用子帳戶與固定 IP，並限制帳戶內可承受風險的資金量。
- 發現陌生訂單、異常 IP 或權限遭變更時，立即刪除金鑰、檢查帳戶安全並聯繫雙方官方客服。
結語
完成 OKX API 串接後，Carry Labs 可在你授權的範圍內讀取餘額、訂單與倉位，並執行套利策略所需的交易。完成設定後，先可以進行小額讀取、下單與撤單測試。更多 OKX 與期現套利相關教學，可以參考下方文章！