OKX API 交易大升級！一文掌握 API v5 升級以及它的功能優勢

OKX

發佈於 2022年12月06日

更新於 2025年2月26日

閱讀時長 6 分鐘

OKX API v5 全面升級，功能更強大、更高效！快速掌握新特性與優勢，助您實現更流暢的交易體驗與市場掌控力。

通常交易需要使用交易平台來篩選股票或比特幣等加密貨幣資產。交易者找到要交易的資產，觀察報價、圖表和訂單簿，然後透過介面下達市價單、限價單或止損單。

這本身是對過去股票交易系統的重大進步，但仍然不是最有效的過程，特別是對於高頻交易而言。當今高級交易者的需求是透過自動化或演算法交易系統來滿足的，這些系統允許交易者對其策略進行編程並使其執行和適應市場條件，而無需持續的人工輸入。

API，即應用程式介面，是此類自動交易系統的核心，本質上是一組允許軟體平台即時共享資料和有效通訊的程式碼。

演算法交易公司和專業交易者是 API 交易的主要用戶，而零售交易者也可以將 API 連接用於其投資組合管理應用程式或透過第三方軟體進行交易。

為了滿足用戶的需求，OKX 提供了先進的 API 功能並持續升級。在本文中，我們將簡要介紹 OKX 上的 API 交易以及新的 OKX API v5 升級的概述。

API 交易基礎知識，掌握必備的三個工具

API交易需要三個必備工具：

API 金鑰
API文件
連接介面

API 金鑰是唯一標識符，用於對存取交易所 API 的交易者和開發人員進行身份驗證。簡單來說，API 金鑰由公鑰和秘密金鑰組成，其運作方式非常類似於使用者名稱和密碼組合。

API 文件包含有關如何使用和整合 API 的技術資訊 - 本質上充當開發人員和交易者的參考手冊。

API 主要有兩種類型：REST 和 WebSocket。 REST 代表表述性狀態傳輸 (Representational State Transfer)，是最常見的 Web 服務，支援 HTTP 下的各種格式（例如 JSON 和 XML）。 WebSocket 是一種新的 HTML5 協議，可實現客戶端和伺服器之間高效的資料傳輸。這對於想要編程並將腳本、機器人或其他軟體與交易所連接的開發人員特別有用。

OKX 上進行 API 交易

OKX 提供三類 API 交易：帳戶、交易、行情。在帳戶和交易模組中，使用者可以下單、查詢訂單狀態和帳戶資訊。此外，OKX 用戶還可以透過公開的市場資料API存取交易對的歷史價格資料。

OKX 在 API v3 中為使用者同時支援 REST 和 WebSocket API，交易者可以使用該 API 進行五種交易產品，包括現貨、保證金、期貨、永續合約和選擇權。

雖然零售和機構交易者都可以使用 API v3，但為了繼續改善用戶體驗，OKX 一直致力於升級其 API 系統，以提高資金效率、錯誤報告機制等。

OKX API v5

為了提供用戶更無縫的交易體驗，OKX 推出了新的 API v5，目前可供所有統一帳戶用戶使用。作為 v3 的重大升級（v4 被跳過，因為「4」在東亞地區被認為是不吉利的數字），v5 在以下方面進行了關鍵改進：

提高資本配置效率
同時支援多種交易產品
REST 和 WebSocket API 中的訂單操作
統一的 JSON 格式用於錯誤報告
更靈活的 WebSocket 訂閱與定時推送

在本文中，我們比較了 API v3 和 v5 的功能以及新版本中 API 交易的改進方式。

全面了解 OKX API v5 的核心功能與升級亮點，探索更高效的交易解決方案，輕鬆應對數字資產市場需求。

API v5 功能升級

API v5 的功能升級適用於所有 API 使用者。這些涉及帳戶資金使用、多業務線支援等。

帳戶資金使用情形

在 API v3 中，每個業務線都有一個對應的帳戶。這意味著用戶需要將資金從一種交易產品轉移到另一種交易產品。頻繁的資金轉移既耗時又降低了用戶的資金效率。而且，不同交易產品帳戶之間的資金轉帳僅限每秒一次。

使用 API v5 時，交易者可以提高資本效率。與 OKX 的統一帳戶類似，使用 API v5 的交易者將能夠在一個帳戶中使用他們的資金。此外，v5中各個部位的盈虧也根據用戶的帳戶模式進行合併——從而提高資金效率。

跨產品統一 API

與 API v3 不同，API v5 中的端點（例如用於下訂單和檢索倉位的端點）在各個產品中是統一的。同一 API 中的所有儀器類型都使用相同的請求和回應資料模型，這意味著我們不再需要單獨對每個產品 API 進行建模。

API 訂單操作

訂單操作包括下新訂單、修改訂單和取消訂單。雖然 v3 中只有 REST API 支援訂單操作，但新的 API v5 允許 REST 和 WebSocket API 都支援訂單操作。

API 場景化升級

場景升級是指針對特定功能或格式的升級。其中包括訂單模式升級以及時間功能和REST響應功能的格式升級。

API 下單模式

API v3 僅支援開倉和平倉——如果用戶在同一衍生性合約中同時持有多頭和空頭頭寸，這些頭寸將被單獨查看，並且不能相互抵消。

與統一帳戶結合，API v5 為使用者提供了新的網路模式。這意味著同一交易對或工具中的各種多頭和空頭部位可以相互抵消，並且用戶可以查看淨頭寸。

WebSocket 訂閱功能

訂閱功能使用戶能夠獲取數據。與 API v3 相比，API v5 允許使用者同時訂閱多個交易對。

此外，API v5 對帳戶通道和倉位通道進行定時推送，更方便風險管理。

REST 回應的格式

回應是指當使用者嘗試檢索資訊時傳回給使用者的資料。 API v3 中有兩種 REST 回應格式－正常傳回格式和錯誤報告格式。這兩種格式在同一介面中不相容，造成使用者不便。相反，API v5 遵循統一的 REST 回應 JSON 格式。

API v5 私人清算令

在 API v3 中，使用者無法直接查看私募強平訂單的狀態。他們需要透過 REST API 連接端點來實現這一點。

API v5 的訂單通道支援私密強平訂單。使用者可以直接查看狀態，「類別」欄位指示訂單是部分爆倉還是全部爆倉。

API v5 已開倉合約數量

API v3 中的使用者想要查看已開立合約數量時，需要向 WebSocket 帳號頻道傳送請求才能查看。

在 API v5 中，讀取已開啟合約的數量更加簡單，使用者可以透過 REST API 中的「取得最大合約數量」介面來取得此類資訊。

API v5 子帳戶模組

API v5 提供此模組來支援：

子帳戶 API Key 的管理，包括建立、刪除和重置功能。
查詢子帳戶的帳戶餘額。
兩個子帳戶之間直接轉帳。

時間格式

API v3 採用 ISO8601 時間格式，參考 UTC 時區。但是，這種時間格式可能並不相容於所有程式語言。這需要額外的時區轉換功能。

API v5 採用更通用的時間格式：Unix Epoch，它不考慮時區。 API v5 函式庫中也有相關資源，方便開發者進行時間格式轉換。

現貨交易市場秩序

使用 API v5 進行現貨交易時，使用者可以根據自己的需求選擇下市價單時的大小單位。相較之下，API v3 用戶只能使用報價貨幣作為買入市價單單位，並使用基礎貨幣作為賣出市價單單位。

API v5 的推出

自 3 月 31 日起，API v5 可供所有統一帳戶使用者使用。由於 API v3 將在 v5 全面推出後不久停止，我們鼓勵用戶將其 API 升級到 v5，以獲得更好的功能和更無縫的交易體驗。

策略跟單是什麼？1 分鐘搞懂 OKX 虛擬貨幣策略跟單操作！: https://www.okx.com/zh-hant/learn/trading-bot-copytrading-zh

延伸閱讀：

OKX交易所｜【API】申請教學，量化交易不可或缺的功能一次告訴你！：https://quantpass.org/okx-api/

加入 OKX 繁中社區了解更多加密貨幣知識，還有不定期空投及周邊贈送！

追蹤 OKX 中文 IG，了解加密貨幣和 OKX 最新動態，更多精彩活動好禮等你來拿：

OKX 中文IG

【OKX LINE 官方帳號】正式上線 🔥 每週簽到、積分換限量周邊、空投紅包禮物等你抱回家 🧡

OKX LINE 官方帳號

免責聲明

本文章可能包含不適用於您所在地區的產品相關內容。本文僅致力於提供一般性信息，不對其中的任何事實錯誤或遺漏負責任。本文僅代表作者個人觀點，不代表 OKX 的觀點。本文無意提供以下任何建議，包括但不限於：(i) 投資建議或投資推薦；(ii) 購買、出售或持有數字資產的要約或招攬；或 (iii) 財務、會計、法律或稅務建議。持有的數字資產 (包括穩定幣) 涉及高風險，可能會大幅波動，甚至變得毫無價值。您應根據自己的財務狀況仔細考慮交易或持有數字資產是否適合您。有關您具體情況的問題，請諮詢您的法律/稅務/投資專業人士。本文中出現的信息 (包括市場數據和統計信息，如果有) 僅供一般參考之用。儘管我們在準備這些數據和圖表時已採取了所有合理的謹慎措施，但對於此處表達的任何事實錯誤或遺漏，我們不承擔任何責任。 © 2025 OKX。本文可以全文複製或分發，也可以使用本文 100 字或更少的摘錄，前提是此類使用是非商業性的。整篇文章的任何複製或分發亦必須突出說明：“本文版權所有 © 2025 OKX，經許可使用。”允許的摘錄必須引用文章名稱並包含出處，例如“文章名稱，[作者姓名 (如適用)]，© 2025 OKX”。部分內容可能由人工智能（AI）工具生成或輔助生成。不允許對本文進行衍生作品或其他用途。