Bitget API触发订单报错43011：clientOid参数不符合规范求助

API 探路者

2026-7-8

解决Bitget API触发订单报错43011（clientOid不符合规范）

问题原因

错误码43011明确指向clientOid参数不符合规范，你的代码中clientOid使用了test@483939290000，其中包含了Bitget API不允许的特殊字符@。

Bitget API对clientOid的要求

仅允许包含字母、数字、下划线（_）
长度限制在1-32字符范围内
同一API密钥下需保证全局唯一（避免重复提交时的冲突）

修正后的代码

将clientOid替换为符合规范的字符串，比如把@改成_，或者直接使用纯数字字母组合：

import hashlib
import hmac
import base64
import requests
import json
import time

api_key = "key here"
secret_key = "secret"
passphrase = "pass"
base_url = "https://api.bitget.com"
endpoint = "/api/mix/v1/plan/placePlan"

# 修正clientOid格式，去掉@改用下划线
payload = {
    "symbol": "BTCUSDT_UMCBL",
    "marginCoin": "USDT",
    "size": "0.001",
    "executePrice": "33145.5",
    "triggerPrice":"33145.5",
    "side":"open_long",
    "orderType":"limit",
    "triggerType":"market_price",
    "clientOid":"test_483939290000"  # 替换@为下划线，符合格式要求
}

# Convert the payload to JSON format
payload_str = json.dumps(payload)

# Generate the signature
timestamp = str(int(time.time() * 1000))
message = timestamp + "POST" + endpoint + payload_str
signature = base64.b64encode(hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), 
hashlib.sha256).digest())

# Set the request headers
headers = {
    "ACCESS-KEY": api_key,
    "ACCESS-SIGN": signature,
    "ACCESS-TIMESTAMP": timestamp,
    "ACCESS-PASSPHRASE": passphrase,
    "Content-Type": "application/json"
}

# Send the request
response = requests.post(base_url + endpoint, headers=headers, data=payload_str)

# Print the response
print(response.json())