OKX API 交易大升級！ 一文掌握 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 在以下方面進行了關鍵改進：

1. 提高資本配置效率

2. 同時支援多種交易產品

3. REST 和 WebSocket API 中的訂單操作

4. 統一的 JSON 格式用於錯誤報告

5. 更靈活的 WebSocket 訂閱與定時推送

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

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，以獲得更好的功能和更無縫的交易體驗。

閱讀更多：

如何下載 OKX APP：https://www.okx.com/zh-hant/learn/novice-general-guide-1-cn

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

延伸閱讀：

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

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

• OKX 中文Line群

• OKX 繁中TG群

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

• OKX 中文IG

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

• OKX LINE 官方帳號