阅读时间 … 分钟

AI 原生 Deribit 期权策略运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署至托管云端运行环境,提供一流的 MCP 控制、日志与区域选择支持。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Deribit
平台类型
加密货币衍生品交易所(期权为主)
资产类别
加密货币
支持的产品
BTC、ETH、SOL 期权(欧式、现金交割);反向永续与反向定期交割期货(BTC、ETH);线性 USDC 永续与线性 USDC 定期交割期货(BTC、ETH、SOL、XRP、TRX、AVAX);线性 USDC 期权(BTC、ETH、SOL、XRP、TRX、AVAX);DVOL 波动率指数期货
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Deribit API(基于 WebSocket 的 JSON-RPC、基于 HTTP 的 JSON-RPC、FIX 4.4)、CCXT、自定义客户端
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Deribit 角色
交易所账户、API 接入、市场接入、执行场所
关联关系
TradingHost 保持独立,与 Deribit 及其自 2025 年 8 月 14 日起之母公司 Coinbase 无任何隶属关系。

第 02 部分 · Deribit 平台功能

Deribit 平台功能

Deribit 是一个以期权为主导的交易平台:BTC、ETH 和 SOL 期权(欧式、现金交割)是其核心产品。次要产品线包括 BTC 和 ETH 的反向永续与定期交割期货,以及线性 USDC 产品系列(涵盖 BTC、ETH、SOL、XRP、TRX 和 AVAX 的永续、定期交割期货及期权),此外还提供 DVOL 波动率指数期货。其 API 采用基于 WebSocket 或 HTTP 的 JSON-RPC 协议,并为机构资金流提供 FIX 4.4 接口。Coinbase 于 2025 年 8 月 14 日完成了对 Deribit 的收购;主机名、身份验证和合约命名仍沿用 Deribit 自身品牌。具体端点细节可能会随时间变化,但整体架构保持稳定。具体的速率限制权重、手续费等级和交易对列表请参考 Deribit 的官方文档。

市场与策略模式

  • BTC、ETH 和 SOL 期权的 gamma 剥头皮策略
  • DVOL 与上市期权的波动率 Carry 策略
  • 日历价差与对角价差策略
  • delta 中性期权投资组合
  • 期权与永续合约对冲策略
  • Block RFQ 多腿组合结构
  • 基于 Portfolio Margin 的期权做市策略
  • DVOL 波动率指数期货交易

API 接口

产品范围
BTC、ETH、SOL 期权(欧式、现金交割);反向永续与定期交割期货(币本位保证金);线性 USDC 永续与定期交割期货;线性 USDC 期权;DVOL 波动率期货。位于 `test.deribit.com` 的测试网镜像了完整的交易产品线,并提供隔离的账户与凭证。
连接方式
基于 WebSocket 的 JSON-RPC (`wss://www.deribit.com/ws/api/v2`)、基于 HTTP 的 JSON-RPC (`https://www.deribit.com/api/v2`),以及带有自定义标签的 FIX 4.4 (`www.deribit.com:9880`)。对于低延迟期权交易,通过 WebSocket 下单是标准做法。FIX 适用于机构。Block RFQ 同样通过该 API 接口提供。
身份验证
通过 `public/auth` 提供多种授权类型的 API 密钥:Client Credentials(`client_id` 加 `client_secret`)、Client Signature(对 `timestamp + "\n" + nonce + "\n" + data` 进行 HMAC-SHA256 签名)、Basic Auth、deri-hmac-sha256 请求头认证,以及非对称(自生成)密钥。返回 `access_token` 和 `refresh_token`。支持子账户层级,拥有独立的 API 密钥和独立的速率限制信用池。大宗交易授权使用独立的 `enabled_features: block_trade_approvals` 标志。

具体细节请参考 Deribit

具体端点、速率限制权重、交易对列表、手续费等级和版本历史请参见 Deribit 官方文档。请以官方文档为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Deribit 策略

选择一种集成方式,Fork 一个 TradingHost 框架模板,然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。

  • 原生 Deribit API

    直接控制 Deribit 特有的行为、账户数据和订单执行逻辑。支持基于 WebSocket 和 HTTP 的 JSON-RPC,以及面向机构资金流的 FIX 4.4。Block RFQ 同样通过该 API 接口提供。

  • CCXT

    跨 Deribit 及其他加密货币交易所的通用接口。CCXT 通过 `deribit` 交易所类提供对 Deribit 的支持,涵盖期权、永续和定期交割期货,并包含统一的期权方法。

  • Freqtrade 或 Hummingbot

    目前 Freqtrade 和 Hummingbot 均未提供针对期权交易的官方 Deribit 连接器。Freqtrade 专注于现货和永续合约,且没有公开的 Deribit 支持记录;Hummingbot 则没有期权连接器类别。请改用原生 API 或 CCXT。

  • 自定义连接器

    您自己的内部交易引擎或专有的 Deribit 集成,包括用于低延迟期权交易的直接 WebSocket JSON-RPC,或用于机构执行的 FIX 4.4。

框架对 Deribit 产品的支持情况

各框架的支持范围有所不同。Deribit 以期权为主导,反向与线性永续合约及定期交割期货为次要产品。CCXT 通过 `deribit` 类提供支持,涵盖期权、永续和定期交割期货;原生 Deribit API 则可接入完整的交易产品线,包括 DVOL 波动率指数期货和 Block RFQ。Freqtrade 和 Hummingbot 未提供针对这些市场的官方 Deribit 连接器。Coinbase 于 2025 年 8 月 14 日完成了对 Deribit 的收购;API 的连续性在现有的主机名和身份验证机制下得以保留。

框架期权永续期货
Native Deribit API已支持已支持已支持
CCXT已支持已支持已支持
Freqtrade未记录支持未记录支持未记录支持
Hummingbot未记录支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。“no” 表示官方文档未明确说明支持。

TradingHost 不强求特定的框架,它只负责运行您的项目。

使用 AI 编写

上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环:AI 工具可以与您一同检查部署、查看日志并管理运行环境,但绝不会介入交易执行路径。

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

Deribit 提供交易所和 API 访问。TradingHost 则提供生产环境,用于运行您连接到 Deribit 的策略。

无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码,您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。

您

  • 您的代码库包含您的代码。
  • 您的部署定义了其运行方式。
  • 您的策略连接到 Deribit。

TradingHost

  • 保持运行环境持续在线。
  • 呈现日志和健康状况检查。
  • 区域选择。
  • 受控的部署环境。

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库,或者 fork 一个 TradingHost 框架运行环境(如 CCXT)作为可运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域(EU 或 US-East),提供您策略所需的环境变量(Deribit 的 `client_id` 和 `client_secret`,以及可选的 FIX 会话凭证),然后进行部署。TradingHost 会直接从您的代码库构建容器,并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

    通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问,方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。

  5. 步骤 05

    更新与重新部署

    将代码更改推送到 GitHub 的主分支(main branch),TradingHost 便会自动重新部署。

Section 05 · 运维说明

Deribit 运维说明

在容器化云端运行环境中实际运行 Deribit 策略时可能遇到的坑,这些内容既不在 Deribit 的文档中,也不在框架的 README 中。以下所有陈述均引用或改写自 Deribit 的官方文档;部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · Greeks

    市场数据中已包含 Greeks

    Deribit 在期权行情(ticker)和订单簿 Greeks 中发布 delta、gamma、vega 和 theta;策略应当直接从交易平台读取 Greeks,而不是自行重新计算,因为 Deribit 自身的标记价格和 IV 定义直接决定了保证金和强平逻辑。

  2. 02 · 保证金模型

    Portfolio Margin 与 Standard Margin 是独立的模型

    Standard Margin 计算单笔持仓的保证金,期货和期权之间没有对冲抵消。Portfolio Margin 则对整个投资组合(价格和波动率)进行情景压力测试,并以最坏情况下的损失作为保证金要求,从而大幅降低已对冲期权组合的保证金占用。这两种模型均可在逐仓或全仓模式下运行。

  3. 03 · 大宗交易

    Block trade 与 Block RFQ 使用独立的工作流

    双方 block trade 先使用 `/private/verify_block_trade`,然后使用带有交易对手签名的 `/private/execute_block_trade`。Block RFQ 支持跨期权、期货和现货对的多达 20 个 leg,并采用多做市商模型。API key 需要具备 `enabled_features: block_trade_approvals` 权限以支持审批流程。

  4. 04 · 结算

    每日结算与到期交割均在 08:00 UTC 进行

    永续合约和期货的每日盯市结算于每日 08:00 UTC 进行,期间会有短暂的交易暂停。周度期权在每周五 08:00 UTC 到期,月度期权在每月最后一个周五 08:00 UTC 到期。交割价格采用相关 Deribit Index 在 07:30 至 08:00 UTC 期间的 30 分钟 TWAP。跨结算窗口持有持仓的策略应提前预估此时间段的影响。

  5. 05 · 测试网

    测试网运行在独立的主机上,且状态完全独立

    生产环境运行在 `https://www.deribit.com/api/v2` 和 `wss://www.deribit.com/ws/api/v2`;测试网运行在 `https://test.deribit.com/api/v2` 和 `wss://test.deribit.com/ws/api/v2`。测试网的账户、余额、子账户和 API key 与生产环境完全隔离,不共享凭证。FIX 测试网运行在 `test.deribit.com:9881`。

  6. 06 · Coinbase 收购

    收购后的 API 与品牌延续性

    Coinbase 于 2025 年 8 月 14 日完成了对 Deribit 的收购。Deribit 继续以其自身品牌运营(deribit.com 上显示为 "Deribit by Coinbase"),并保留其原有的 API 主机名、身份验证和产品界面。目前尚未发布任何合并或替换的端点;与 Coinbase 平台的整合已被列入未来路线图,而非当前的迁移计划。现有的 API key、FIX 会话和合约名称继续正常使用。

  7. 07 · 频率限制

    基于子账户信用额度,在不同池之间分配

    每个子账户都有独立的信用额度池(漏桶 CPS 补充机制),且撮合引擎请求(下单、撤单、改单)与非撮合请求具有不同的费用配置。账户等级和近期的交易活跃度会提高该上限。可通过 `/private/get_account_summary` 进行查询。

Section 06 · 适用场景

适用场景

TradingHost Deribit 运行环境最适合用于:

  • 期权交易员
  • 波动率与衍生品量化研究员
  • 做市商
  • AI 辅助算法交易员
  • 运行多腿组合结构的机构交易台

连接 GitHub 并创建首个策略完全免费。

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的平台,与 Deribit 及其自 2025 年 8 月 14 日起的主母公司 Coinbase 均无任何隶属关系。

不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接到 Deribit 并发送指令。TradingHost 仅提供运行该代码的托管运行环境。

不提供。Deribit API 访问权限由 Deribit 官方提供。您需要自行负责您的 Deribit 账户、API 权限、凭证以及对 Deribit 条款的合规性。

不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost,您可以自己编写或生成策略(通常配合 Cursor 或 Claude Code),将其作为您的代码保存在 GitHub 中,并使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有并提供策略逻辑;而 TradingHost 则是运行您自己的策略。

AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和可用性监控。而 TradingHost 为您提供专为交易策略打造的托管运行环境:开箱即用的 GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制、日志和健康状况监控界面。如果您想自己运营基础设施,AWS 是可行的。如果您希望将运行环境作为托管服务,TradingHost 是更快捷的途径。

可以。TradingHost 支持运行 Python 策略;您可以选择与您的技术栈匹配的框架运行环境,或者直接部署您自己的代码仓库。

可以。TradingHost 支持任何可以在容器内运行的语言。

CCXT 的 `deribit` 交易所模块涵盖了期权、永续和定期交割期货,包括统一的期权方法。您可以将基于 CCXT 的项目从 GitHub 部署到 TradingHost 容器中,并将 Deribit 的 `client_id` 和 `client_secret` 作为机密信息(secrets)注入。平台同样支持原生的 Deribit JSON-RPC over WebSocket 和 FIX 4.4;运行环境与语言和库无关。有关完整的设置说明,请参阅 CCXT 框架运行环境文档。

可以。Deribit 提供 BTC、ETH 和 SOL 期权(欧式、现金结算)以及其他山寨币的线性 USDC 期权。TradingHost 负责运行策略容器、部署、日志和健康监测,而交易执行则通过 Deribit API 进行。Greeks 指标会展示在交易所的行情数据中,您还可以在 Deribit 账户级别启用 Portfolio Margin,以实现跨品种的保证金抵消。

可以,只要您的项目是这样设计的。您可以在单个运行环境中运行多个策略进程或服务,也可以将它们拆分到不同的运行环境中,以实现隔离和运行清晰度。有关多策略模型的详细信息,请参阅 TradingHost 运行环境页面。

最快的方法是 fork 一个 TradingHost 框架运行环境(例如 CCXT)以获取开箱即用的项目,或者直接连接您自己的 GitHub 策略仓库。绑定 GitHub 仓库并创建策略是免费的;运行环境方案已在定价页面列出。

保存在您通过 GitHub 控制的机密信息(secrets)工作流中。TradingHost 在运行时通过 GitHub 仓库机密信息、环境机密信息或您自己授权的机密管理流程读取它们。TradingHost 不需要托管您的 Deribit `client_id` 和 `client_secret`。有关完整的处理模型,请参阅平台机密信息文档。

Portfolio Margin 会对整个账户持仓(价格和 IV)进行情景压力测试,并以最坏情况作为保证金要求,这能显著降低对冲或价差期权持仓的保证金要求。Standard Margin 则将每个仓位独立对待,不进行抵消。如果您的策略持有相互对冲的期权和期货 leg,Portfolio Margin 通常能降低资金占用;如果您运行的是方向性持仓,Standard Margin 则更简单。两者均可在隔离或跨币种保证金模式下运行。

可以。TradingHost 支持针对 AI IDE(包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI agent)的 MCP 控制。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是控制和可观测性界面,而不是交易执行路径。有关完整信息,请参阅 MCP 控制界面文档。

两者皆可。MCP 控制界面在基于 CLI 的 agent(Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用)和 IDE 内部同样表现出色。此外,GitHub 原生部署循环在没有任何 AI 工具的情况下也能正常工作:向您的 main 分支进行常规的 git push 即可触发重新部署。

运行环境会检测到崩溃,并公开相关的日志和健康状态信息。在支持的情况下,受影响的策略可以重新启动,而不会干扰同一容器中运行的其他策略。您的策略代码仍需负责安全的错误处理、防重复下单保护和风险控制。关于日志和健康状态界面,请参阅可观测性(observability)部分。

这意味着 API key、secret 或签名未通过验证。常见原因包括:将测试网(testnet)的 key 粘贴到了 www.deribit.com(或反之)、HMAC 签名认证中时间戳(timestamp)字段的时钟偏差、签名字符串不正确(格式应为 `timestamp + "\n" + nonce + "\n" + data`,两个换行符均必不可少),或者该 key 已被撤销。请在 Deribit 控制台中重新检查该 key,并确认环境主机名与该 key 相匹配。

是的。测试网地址为 `https://test.deribit.com/api/v2`、`wss://test.deribit.com/ws/api/v2` 以及 FIX 端口 `test.deribit.com:9881`。测试网的账户、余额、子账户和 API key 与生产环境是完全隔离的。常见的做法是在容器中设置 `DERIBIT_ENV=test`,并据此解析基础 URL。

Coinbase 于 2025 年 8 月 14 日完成了对 Deribit 的收购。从策略编写者的角度来看,API 或交易工具层面没有任何变化:主机名(www.deribit.com、test.deribit.com)、身份验证、FIX 会话、交易工具命名以及 JSON-RPC 接口均与此前保持一致。该品牌目前以 "Deribit by Coinbase" 的形式呈现。虽然有迹象表明未来会与 Coinbase 平台进行整合,但目前尚未发布任何合并后的端点。

TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由与物理距离详情,请参阅区域页面。

不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。