Deribit API文檔

Deribit API 文檔詳解：新手入門指南

Deribit 是全球領先的加密貨幣期權和期貨交易平台，以其高流動性、深度市場和強大的 API 接口而聞名。對於希望自動化交易策略、構建交易機器人或將 Deribit 集成到現有系統中的交易者來說，理解並掌握 Deribit API 文檔至關重要。本文旨在為初學者提供一份詳盡的 Deribit API 文檔解讀，幫助你快速入門並構建自己的交易應用。

1. 什麼是 Deribit API？

API (Application Programming Interface) 應用程序編程接口，是 Deribit 平台提供的一組協議和工具，允許開發者通過代碼與平台進行交互。相比於手動交易，使用 API 具有以下優勢：

自動化交易：可以編寫程序自動執行交易策略，無需人工干預，利用量化交易的優勢。
高速執行： API 允許以極快的速度下達訂單，抓住瞬間的交易機會，避免滑點。
數據分析：可以實時獲取市場數據，進行技術分析，發現潛在的交易信號。
系統集成：可以將 Deribit 集成到現有的交易系統或風控系統中。
策略回測：可以使用歷史數據對交易策略進行回測，評估其盈利能力和風險，參見回測系統。

2. Deribit API 的類型

Deribit 提供兩種主要的 API 接口：

REST API：基於 HTTP 協議的 API，易於理解和使用，適用於簡單的交易任務和數據獲取。
WebSocket API：基於 WebSocket 協議的 API，提供實時數據流，適用於需要實時市場信息的交易應用，例如做市商策略。

選擇哪種 API 取決於你的具體需求。對於初學者來說，建議從 REST API 開始學習。

3. Deribit API 文檔結構

Deribit API 文檔 ([1](https://docs.deribit.com/)) 組織結構清晰，主要包含以下部分：

Authentication (認證)：詳細介紹了如何獲取 API 密鑰並進行身份驗證。
REST API Reference (REST API 參考)：列出了所有可用的 REST API 端點，包括請求參數、響應格式和錯誤代碼。
WebSocket API Reference (WebSocket API 參考)：列出了所有可用的 WebSocket 通道，包括訂閱的數據類型和消息格式。
Data Types (數據類型)：定義了 API 中使用的數據類型，例如貨幣對、訂單類型和時間戳。
Examples (示例)：提供了各種 API 請求和響應的示例代碼，方便開發者理解和使用。
Rate Limits (速率限制)：描述了 API 的速率限制，避免因請求過於頻繁而被限制。
Error Codes (錯誤代碼)：列出了所有可能的錯誤代碼及其含義，幫助開發者調試程序。

4. API 認證：獲取 API 密鑰

在使用 Deribit API 之前，你需要先創建一個 Deribit 賬戶，並生成 API 密鑰。

1. 登錄你的 Deribit 賬戶。 2. 進入「API Management」頁面 (通常在賬戶設置或個人資料中)。 3. 創建一個新的 API 密鑰，並設置相應的權限。權限包括：

   *   Read：只允许读取数据。
   *   Trade：允许下达订单。
   *   Withdraw： 允许提款（谨慎使用）。

4. 保存你的 API 密鑰 (包括 API key 和 API secret)。 API secret 需要妥善保管，切勿泄露。

5. REST API 詳解

以下是一些常用的 Deribit REST API 端點示例：

常用的 Deribit REST API 端點
Description \| Method \|
獲取所有可交易的工具列表 \| GET \|	獲取訂單簿 \| GET \|	獲取交易記錄 \| GET \|	獲取賬戶信息 \| GET \|	下達訂單 \| POST \|	取消訂單 \| POST \|	獲取未完成的訂單 \| GET \|	獲取當前持倉 \| GET \|

- 示例：獲取 BTC-PERPETUAL 的訂單簿**

``` GET /api/v2/public/get_order_book?instrument_name=BTC-PERPETUAL&depth=10 ```

此請求將返回 BTC-PERPETUAL 的前 10 級買賣訂單。

- 示例：下達買單**

``` POST /api/v2/private/place_order {

 "instrument_name": "BTC-PERPETUAL",
 "amount": 10,
 "side": "buy",
 "type": "limit",
 "price": 27000

} ```

此請求將下達一個以 27000 美元的價格購買 10 張 BTC-PERPETUAL 合約的限價買單。

6. WebSocket API 詳解

WebSocket API 提供實時數據流，適用於需要實時市場信息的交易應用。

以下是一些常用的 WebSocket 通道示例：

subscribe: ticker：訂閱特定工具的行情信息。
subscribe: trade：訂閱特定工具的交易信息。
subscribe: orderbook：訂閱特定工具的訂單簿信息。
subscribe: positions：訂閱賬戶持倉信息。
subscribe: open_orders：訂閱未完成的訂單信息。

- 示例：訂閱 BTC-PERPETUAL 的行情信息**

```json {

 "jsonrpc": "2.0",
 "id": 1,
 "method": "subscribe",
 "params": ["ticker", "BTC-PERPETUAL"]

} ```

訂閱後，服務器將持續發送 BTC-PERPETUAL 的行情信息。

7. 錯誤處理

在使用 Deribit API 時，可能會遇到各種錯誤。理解錯誤代碼並進行適當的處理至關重要。常見的錯誤包括：

Invalid API Key： API 密鑰無效。
Insufficient Funds：賬戶餘額不足。
Invalid Parameters：請求參數無效。
Rate Limit Exceeded：請求頻率超過限制。

Deribit API 文檔中提供了完整的錯誤代碼列表及其含義，可以參考文檔進行調試。良好的錯誤處理機制可以提高程序的健壯性和可靠性。

8. 速率限制 (Rate Limits)

Deribit API 實施了速率限制，以防止濫用和保證平台的穩定性。速率限制的詳細信息可以在 API 文檔中找到。通常，速率限制會根據 API 端點和用戶等級進行調整。如果超過速率限制，API 將返回錯誤代碼，你需要等待一段時間後再進行請求。為了避免超過速率限制，建議：

批量請求：將多個請求合併到一個請求中。
緩存數據：緩存常用的數據，避免重複請求。
優化代碼：減少不必要的請求。
使用指數退避算法：在遇到速率限制時，採用指數退避算法，逐漸增加請求間隔。

9. 編程語言和 SDK

Deribit API 支持多種編程語言，例如 Python、JavaScript、Java 等。許多開發者社區也提供了 Deribit API 的 SDK (Software Development Kit)，方便開發者快速集成 Deribit API。例如，可以使用 Python 的 `requests` 庫進行 REST API 請求，使用 `websockets` 庫進行 WebSocket API 連接。

10. 進階主題與資源

Deribit 交易策略：學習如何使用 Deribit API 構建各種交易策略，例如套利交易、趨勢跟蹤和均值回歸。
Deribit 市場深度分析：利用 API 獲取市場數據，進行訂單流分析，判斷市場情緒和潛在的交易機會。
Deribit 風險管理：使用 API 監控賬戶風險，設置止損和止盈點，保護資金安全。
Deribit 官方文檔： [2](https://docs.deribit.com/)
Deribit 開發者論壇：查找其他開發者的經驗和解決方案。
Deribit API 示例代碼： GitHub 上有很多開源的 Deribit API 示例代碼，可以參考學習。

總結

Deribit API 為開發者提供了強大的工具，可以構建各種自動化交易應用。通過理解 API 文檔，掌握 API 的使用方法，並結合良好的編程實踐，你可以充分利用 Deribit 的優勢，實現你的交易目標。學習 API 需要時間和實踐，希望本文能夠幫助你快速入門並構建自己的 Deribit 交易機器人或集成應用。

🚀 在币安期货享受 10% 的交易返现

立即在币安（Binance）开始你的加密货币期货交易之旅 —— 全球最受信赖的加密交易平台。

✅ 终身 10% 手续费折扣
✅ 高达 125 倍杠杆 交易主流期货市场
✅ 高流动性、极速执行与移动交易支持

利用先进工具和风险控制功能 —— 币安是你认真交易的首选平台。

立即开始交易

📈 Premium Crypto Signals – 100% Free

🚀 Get trading signals from high-ticket private channels of experienced traders — absolutely free.

✅ No fees, no subscriptions, no spam — just register via our BingX partner link.

🔓 No KYC required unless you deposit over 50,000 USDT.

💡 Why is it free? Because when you earn, we earn. You become our referral — your profit is our motivation.

🎯 Winrate: 70.59% — real results from real trades.

We’re not selling signals — we’re helping you win.

Join @refobibobot on Telegram

Description \| Method \|
獲取所有可交易的工具列表 \| GET \|	獲取訂單簿 \| GET \|	獲取交易記錄 \| GET \|	獲取賬戶信息 \| GET \|	下達訂單 \| POST \|	取消訂單 \| POST \|	獲取未完成的訂單 \| GET \|	獲取當前持倉 \| GET \|

平台	期貨特點	註冊
Binance Futures	槓桿高達125倍，USDⓈ-M 合約	立即註冊
Bybit Futures	永續反向合約	開始交易
BingX Futures	跟單交易	加入BingX
Bitget Futures	USDT 保證合約	開戶
BitMEX	加密貨幣交易平台，槓桿高達100倍	BitMEX

Deribit API文檔

目次