17370845950

本文详解如何通过 python 的 ccxt 库在 bybit 交易所开立和关闭现货/合约空头头寸，涵盖 api 配置、市价卖单开空、市价买单平空的完整流程，并强调关键参数设置与风险注意事项。

在 Bybit 上使用 CCXT 开仓与平仓空头头寸，核心在于正确调用市价订单（Market Order）并理解其在不同交易模式下的行为差异。需特别注意：Bybit 分为现货（Spot）与永续合约（USDT-M 或 COIN-M）两类市场，而 create_market_sell_order 是否真正开空，取决于当前账户类型与持仓模式。

✅ 正确前提（以 USDT 本位永续合约为例）：

• 必须启用 逐仓（isolated）或全仓（cross）保证金模式；
• 确保已切换至合约交易接口（CCXT 默认 bybit() 实例连接的是永续合约 v5，但需显式指定 defaultType: 'swap' 更稳妥）；
• 若使用 BTC/USD（反向合约），请确认是否为 BTC/USD:BTC 格式；主流推荐使用 BTC/USDT:USDT（USDT 本位）。

以下是经过验证的完整示例代码（适配 Bybit v5 合约 API）：

import ccxt
import time

# 初始化 Bybit 交易所实例（明确指定合约类型）
exchange = ccxt.bybit({
    'apiKey': 'YOUR_API_KEY',
    'secret': 'YOUR_SECRET',
    'enableRateLimit': True,
    'options': {
        'defaultType': 'swap',  # 关键！指定为永续合约
        'recvWindow': 10000,
    },
    'urls': {
        'api': 'https://api.bybit.com',  # 生产环境
        # 'api': 'https://api-testnet.bybit.com',  # 测试网（调试时启用）
    }
})

symbol = 'BTC/USDT:USDT'  # USDT 本位永续合约交易对（务必使用此格式）
amount = 0.001  # 开仓数量（按合约张数或基础币计，依 symbol 而定）

try:
    # ✅ 开空：发送市价卖单 → 建立空头头寸
    open_short = exchange.create_market_sell_order(symbol, amount)
    print(f"[OPEN] Short order ID: {open_short['id']}, Status: {open_short['status']}")

    time.sleep(1.5)
    # 查询订单详情（确认成交）
    filled_open = exchange.fetch_order(open_short['id'], symbol)
    print(f"[FILLED] Opened short at avg price: {filled_open['average']:.2f}")

    # ✅ 平空：发送市价买单 → 对冲并关闭空头头寸
    close_short = exchange.create_market_buy_order(symbol, amount)
    print(f"[CLOSE] Close order ID: {close_short['id']}, Status: {close_short['status']}")

    time.sleep(1.5)
    filled_close = exchange.fetch_order(close_short['id'], symbol)
    print(f"[FILLED] Short position closed at avg price: {filled_close['average']:.2f}")

except Exception as e:
    print(f"❌ Error: {str(e)}")

⚠️ 重要注意事项：

• API 权限：确保你的 Bybit API 密钥已开启「合约交易」权限（在 API 管理后台勾选 Contract Trading）；
• 保证金模式：首次开仓前，建议先用 exchange.set_margin_mode('isolated', symbol) 和 exchange.set_leverage(10, symbol) 显式设置杠杆与保证金模式；
• 订单类型限制：Bybit 合约不支持 create_limit_sell_order 直接开空（因需指定价格且可能触发拒绝），市价单（market）是最可靠方式；
• 测试先行：强烈建议先在 Bybit Testnet 创建 API 并运行上述代码验证逻辑；
• 错误处理：实际生产中应捕获 ccxt.InsufficientFunds、ccxt.OrderNotFound、ccxt.InvalidOrder 等异常，并加入重试与日志机制。

? 总结：开空即“卖出合约”，平空即“买入相同数量合约”——本质是方向相反的等量对冲操作。只要 symbol 正确、defaultType 设为 'swap'、API 权限完备，create_market_sell_order 与 create_market_buy_order 即可稳定实现空头建仓与平仓。切勿在现货市场误用该逻辑（现货卖币 ≠ 开空），务必区分交易品种类型。