Deribit API

Deribit API 入門指南

簡介

Deribit 是一個領先的加密貨幣衍生品交易所，提供強大的期權和期貨交易平台。對於希望自動化交易策略、構建交易機器人或將 Deribit 的功能集成到現有系統中的交易者來說，Deribit API (應用程序編程接口) 是至關重要的工具。本指南旨在為初學者提供 Deribit API 的全面介紹，涵蓋其基本概念、認證方法、常用功能以及一些實用示例。

為什麼使用 Deribit API？

手動交易雖然可行，但存在諸多限制。Deribit API 允許交易者：

**自動化交易:** 根據預定義的規則自動執行交易，無需人工干預，實現高頻交易或套利策略。
**提高效率:** 快速執行大量訂單，減少人工操作的延遲和錯誤。
**定製化交易工具:** 構建自定義的交易界面和分析工具，以滿足特定需求。
**數據分析:** 訪問歷史和實時市場數據，進行技術分析和量化交易研究。
**算法交易:** 實施複雜的交易算法和策略，例如均值回歸和趨勢跟蹤。
**與現有系統集成:** 將 Deribit 交易功能集成到其他應用程序或平台中。

Deribit API 類型

Deribit 提供幾種不同的 API 接口，以滿足不同用戶的需求：

**REST API:** 最常用的 API 類型，使用 HTTP 請求進行通信。它易於理解和使用，適合簡單的交易任務和數據獲取。
**WebSocket API:** 提供實時市場數據和訂單狀態更新。它是一種雙向通信協議，可以實現低延遲的交易執行和監控。
**FIX API:** 金融信息交換協議，一種高性能、可靠的交易協議，主要面向機構投資者。

本指南將重點介紹 REST API，因為它對於初學者來說是最容易上手的。

API 認證

在使用 Deribit API 之前，您需要進行認證才能訪問您的賬戶和交易功能。認證過程涉及以下步驟：

1. **創建 API 密鑰:** 在 Deribit 賬戶設置中，生成一個 API 密鑰 (API Key) 和一個 API 密鑰密碼 (API Secret)。請務必妥善保管這些信息，不要泄露給他人。 2. **權限設置:** 在創建 API 密鑰時，您可以設置不同的權限級別，例如只讀 (Read-Only)、交易 (Trade) 和提現 (Withdraw)。根據您的需求選擇適當的權限。 3. **簽名驗證:** Deribit API 使用 HMAC SHA256 簽名驗證請求的真實性。每個 API 請求都需要包含一個簽名，該簽名使用您的 API 密鑰和密鑰密碼生成。

REST API 基礎

Deribit REST API 使用 JSON 格式進行數據交換。每個 API 請求都包含以下要素：

**URL:** API 端點地址，例如獲取賬戶信息的端點為 `https://api.deribit.com/api/v2/account`。
**HTTP 方法:** 常用的 HTTP 方法包括 GET (獲取數據)、POST (創建數據)、PUT (更新數據) 和 DELETE (刪除數據)。
**請求頭 (Headers):** 包含認證信息和內容類型等元數據。例如，`Content-Type: application/json` 和 `X-Deribit-API-Key: YOUR_API_KEY`。
**請求體 (Body):** 對於 POST、PUT 和 DELETE 請求，請求體包含要發送的數據，通常是 JSON 格式。

常用 API 端點

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

常用 Deribit REST API 端點
描述 \| HTTP 方法 \|	獲取賬戶信息，例如餘額和保證金 \| GET \|	獲取當前持倉 \| GET \|	獲取未完成的訂單 \| GET \|	獲取歷史訂單 \| GET \|	提交新的訂單 \| POST \|	取消訂單 \| POST \|	獲取可用交易品種列表 \| GET \|	獲取特定交易品種的當前價格 \| GET \|	獲取特定交易品種的訂單簿 \| GET \|	獲取特定交易品種的歷史交易記錄 \| GET \|

示例：獲取賬戶餘額

以下是一個使用 Python 和 `requests` 庫獲取賬戶餘額的示例：

```python import requests import hmac import hashlib import time

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

def get_account_balance(api_key, api_secret):

   timestamp = str(int(time.time()))
   message = timestamp + "GET/api/v2/account"
   signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()

   headers = {
       "Content-Type": "application/json",
       "X-Deribit-API-Key": api_key,
       "X-Deribit-Timestamp": timestamp,
       "X-Deribit-Signature": signature
   }

   response = requests.get("https://api.deribit.com/api/v2/account", headers=headers)

   if response.status_code == 200:
       data = response.json()
       print(data)
   else:
       print(f"Error: {response.status_code} - {response.text}")

get_account_balance(api_key, api_secret) ```

- 說明:**

將 `YOUR_API_KEY` 和 `YOUR_API_SECRET` 替換為您的實際 API 密鑰和密鑰密碼。
該示例使用 HMAC SHA256 簽名驗證請求。
`requests.get()` 函數發送 GET 請求到指定的 API 端點。
響應的 JSON 數據包含賬戶信息，例如餘額和保證金。

訂單類型

Deribit API 支持多種訂單類型，包括：

**限價單 (Limit Order):** 以指定的價格或更好的價格買入或賣出。
**市價單 (Market Order):** 以當前市場價格立即買入或賣出。
**止損單 (Stop Loss Order):** 當價格達到指定水平時，自動觸發市價單。
**止盈單 (Take Profit Order):** 當價格達到指定水平時，自動觸發市價單。
**條件單 (Conditional Order):** 只有當特定條件滿足時才會被執行的訂單。

風險管理

使用 Deribit API 進行交易時，務必注意風險管理：

**設置止損單:** 限制潛在損失。
**控制倉位大小:** 避免過度槓桿化。
**監控市場風險:** 了解市場波動性和潛在風險。
**測試您的策略:** 在真實交易之前，使用模擬賬戶進行回測和測試。
**定期審查您的代碼:** 確保您的交易策略和代碼沒有錯誤。

進階主題

**WebSocket API:** 了解如何使用 WebSocket API 實時獲取市場數據和訂單狀態更新。
**FIX API:** 探索 FIX API 的高級功能，例如訂單路由和風險管理。
**數據分析:** 使用 API 獲取歷史數據，進行回溯測試和模型訓練。
**期權定價模型:** 結合 API 數據，運用 Black-Scholes 模型等期權定價模型進行交易。
**量化交易策略:** 開發和實施複雜的量化交易策略，例如動量交易和配對交易。

資源鏈接

**Deribit API 文檔:** [1](https://docs.deribit.com/)
**Deribit 官方網站:** [2](https://www.deribit.com/)
**Python Requests 庫:** [3](https://requests.readthedocs.io/)

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