🛠 连接器信息¶

• 交易所类型：去中心化交易所 (DEX)
• 市场类型：限价订单簿 (CLOB)

ℹ️ 交易所信息¶

• 官网: https://www.derive.xyz
• CoinMarketCap: https://coinmarketcap.com/currencies/derive/
• CoinGecko: https://www.coingecko.com/en/coins/derive
• 费用: https://docs.derive.xyz/reference/fees-1
• 支持的国家: https://www.derive.xyz/terms-of-use#:~:text=restricted%20region
• 推荐链接： https://www.derive.xyz/invite/7SA0V

🔑 关于速率限制¶

• 系统采用固定窗口算法实施速率限制，每 5 秒重置一次请求配额，以保障系统稳定。做市商如需更高速率限制，可联系支持团队申请。

  

  

• Derive 速率限制： https://docs.derive.xyz/reference/rate-limits

速率限制¶

以下速率限制旨在保护我们的系统。速率限制器采用“固定窗口”算法，每 5 秒离散地补充请求配额。

做市商有资格获得更高的速率限制。
如需申请提高速率，请联系我们的支持团队。

注意：
REST 和 WebSocket 的突发请求每 5 秒刷新一次。
例如，交易者可在单次突发中发送 5 次匹配请求，但必须等待 5 秒后才能发送下一批请求。

匹配、非匹配与自定义请求¶

以下请求被计为匹配和按交易对匹配请求：

• private/order
• private/replace （计为 1 次请求）
• private/cancel
• private/cancel_by_nonce
• private/cancel_by_instrument
• private/cancel_by_label （若设置了 instrument_name 参数）

自定义速率限制请求¶

• private/cancel_all – 1 TPS
• private/cancel_by_label – 10 TPS （若未设置 instrument_name 参数）

所有上述之外的请求均计为非匹配。

REST¶

通过 REST API 发送的所有非匹配请求，均按 IP 地址以固定的10 TPS速率限制，允许5 倍突发。

若超出限制，将返回429 Too Many Requests响应。

🔑 如何连接¶

生成 API 密钥¶

• 连接

  

• 点击“主页”标签

  

• 点击“开发者”标签

  

• 注册您的会话密钥（即您的公钥地址，例如 MetaMask）

  

• 输入名称和您的公钥地址

  

• 点击“注册”按钮完成。现在您可以使用新的会话密钥。

  

将密钥添加到 Hummingbot¶

在 Hummingbot 客户端内运行 connect derive：

• 输入 Derive 地址作为 Derive 钱包地址

  

• 输入您的子账户 ID

  

>>> connect derive

Enter Your Derive Wallet address >>>

Enter your wallet private key >>>

Enter your Subaccount ID >>>

Enter your Derive Account Type (trader/market_maker) >>>

若连接成功：

You are now connected to derive

🔀 现货连接器¶

对接现货市场 API 接口

• ID: derive
• 连接类型：WebSocket
• API 文档: https://docs.derive.xyz
• Github 文件夹

订单类型¶

此连接器支持以下 OrderType 常量：

• LIMIT
• LIMIT_MAKER
• MARKET

模拟交易¶

通过运行 connect derive_paper_trade 而非 connect derive，访问此连接器的 模拟交易 版本。

如果默认不可用，您可以配置 Hummingbot 以添加此模拟交易交易所。更多信息请参见添加交易所。

🔀 永续合约连接器¶

集成至永续期货市场 API 端点

• ID: derive_perpetual
• 连接类型：WebSocket
• Github 文件夹

使用方法¶

在 Hummingbot 客户端中运行 connect derive_perpetual：

• 输入 Derive 地址作为 DerivePerpetual 钱包地址

  

• 输入您的子账户 ID

  

>>> connect derive_perpetual

Enter Your DerivePerpetual Wallet address >>>
Enter your wallet private key >>>
Enter your Subaccount ID >>>
Enter your Derive Account Type (trader/market_maker) >>>

若连接成功：

You are now connected to derive_perpetual

订单类型¶

此连接器支持以下 OrderType 常量：

• LIMIT
• LIMIT_MAKER
• MARKET

仓位模式¶

此连接器支持以下仓位模式：

• 单向

模拟交易（Derive 测试网）¶

该永续合约交易所提供模拟交易模式： https://testnet.derive.xyz

创建账户并生成 API 密钥后，您可以在 Hummingbot 客户端中使用 connect derive_perpetual_testnet 命令输入这些密钥。连接成功后，您即可使用测试网中的可用永续合约策略/脚本。

附加信息：永续合约连接器¶

• 注意：仅适用于永续合约。仓位杠杆定义为：名义价值绝对值 / 扣除期权后的抵押品净额。

• Derive 杠杆： https://docs.derive.xyz/reference/private-get_positions#:~:text=leverage

• 示例视图