本文详细讲解如何通过 python 的 ccxt 库在 bybit 交易所安全、可靠地开立与平仓短线空头头寸，涵盖 api 配置、市价单下单逻辑、订单状态验证及关键注意事项。
在 Bybit 上执行做空（short）操作，本质是先卖出合约，再以更低价格买回平仓。CCXT 将这一过程抽象为标准的限价/市价订单接口，但需特别注意：Bybit 的永续合约（如 BTC/USD）默认采用反向合约（inverse perpetual），且交易方向由订单类型（sell / buy）决定，而非显式指定“short”参数。
以下为完整可运行示例（基于 CCXT v4.x，兼容 Bybit v5 API）：
import ccxt
import time
# 1. 初始化 Bybit 交易所实例（务必启用 rate limiting）
exchange = ccxt.bybit({
'apiKey': 'YOUR_API_KEY',
'secret': 'YOUR_SECRET',
'enableRateLimit': True, # 必须开启，避免触发限流
'options': {
'defaultType': 'swap', # 明确使用永续合约（非 spot）
'recvWindow': 5000,
},
'timeout': 30000,
})
# 2. 设置交易标的与数量（注意：Bybit 永续合约以合约张数或基础币计价）
symbol = 'BTC/USDT' # 推荐使用 USDT 本位合约（更直观），对应 Bybit 的 USDT-margined perpetual
quantity = 0.01 # 开仓数量（单位：BTC，即基础资产）
try:
# 3. 开立空头头寸：发送市价卖单（sell → 做空）
print("Opening short position...")
open_order = exchange.create_market_order(
symbol=symbol,
side='sell',
amount=quantity,
params={'positionIdx': 2} # positionIdx=2 表示「仅减仓」不适用；此处应设为 0（单向持仓模式）或省略（Bybit 默认单向）
)
print(f"✅ Short opened: {open_order['id']} | Size: {open_order['amount']} {symbol.split('/')[0]}")
time.sleep(1.5)
# 4. 查询当前持仓（验证是否建仓成功）
positions = exchange.fetch_positions([symbol])
for pos in positions:
if pos['side'] == 'short' and float(pos['contracts']) > 0:
print(f"? Active short position: {pos['contracts']} contracts, PnL: {pos['unrealizedPnl']}")
# 5. 平仓空头：发送市价买单（buy → 买入归还，完成平仓）
print("Closing short position...")
close_order = exchange.create_market_order(
symbol=symbol,
side='buy',
amount=quantity,
params={'reduceOnly': True} # 关键！确保只平仓，不反向开多
)
print(f"✅ Short closed: {close_order['id']}")
time.sleep(1.5)
# 再次检查持仓应为 0
final_positions = exchange.fetch_positions([symbol])
print(f"? Final positions: {[p for p in final_positions if float(p['contracts']) != 0]}")
except Exception as e:
print(f"❌ Error: {str(e)}")? 关键注意事项：
- ✅ API 权限：确保你的 Bybit API 密钥已开启「交易」和「读取持仓」权限（Dashboard → API Management）；
- ✅ 合约类型：BTC/USDT 对应 USDT 本位永续合约（推荐新手），而 BTC/USD 是反向合约（以 BTC 计价，盈亏结算为 BTC），需额外注意保证金与强平逻辑；
- ✅ reduceOnly 参数：平仓时务必传入 'reduceOnly': True，否则可能意外开立反向多单；
- ✅ 持仓模式：Bybit 支持「单向」与「双向」持仓模式。默认为单向（positionIdx=0），若使用双向模式（positionIdx=1 或 2），需明确指定 positionIdx 参数；
- ✅ 数量单位：amount 字段在永续合约中代表「基础资产数量」（如 BTC/USDT 中的 BTC 数量），非张数或 USDT 金额；
- ⚠️ 风险提示：做空存在无限理论亏损风险（价格上涨无上限），务必设置止损单（create_limit_stop_order）并监控保证金率。
掌握以上流程后，你即可将该逻辑封装为函数，集成至量化策略或风控系统中。CCXT 的统一接口大幅降低了跨平台开发成本，但始终建议在实盘前于 Bybit 模拟交易环境（testnet）充分验证。
