ByBit API v5报错170130：参数无效但未指明具体参数求助

尝试使用统一账户发送现货订单，已确认签名格式正确且按ByBit V5 API文档操作，但收到错误码170130，提示“参数'%s'的数据无效”却未指明具体参数，以下是相关请求和响应信息：

请求构建信息 #

RequestBuilder {
method: POST,
url: Url {
    scheme: "https",
    cannot_be_a_base: false,
    username: "",
    password: None,
    host: Some(
        Domain(
            "api.bybit.com",
        ),
    ),
    port: None,
    path: "/v5/order/create",
    query: None,
    fragment: None,
},
headers: {
    "content-type": "application/json",
    "x-bapi-api-key": xxxxxxxxxxxxxx,
    "x-bapi-timestamp": "1676755850417",
    "x-bapi-sign": xxxxxxxxxxxxxxxx,
    "x-bapi-recv-window": "5000",
},
}

请求体 #

{"category":"spot","symbol":"ETHUSDT","side":"Sell","order_type":"Market","qty":"0.1"}

发送请求的Rust代码 #

// Set up the HTTP client
    let client = reqwest::Client::new();
    let mut headers = HeaderMap::new();
    headers.insert("Content-Type", HeaderValue::from_static("application/json"));
    headers.insert("X-BAPI-API-KEY", HeaderValue::from_str(&api_key)?);
    headers.insert("X-BAPI-TIMESTAMP", HeaderValue::from_str(&timestamp)?);
    headers.insert("X-BAPI-SIGN", HeaderValue::from_str(&sign)?);
    headers.insert("X-BAPI-RECV-WINDOW", HeaderValue::from_static(recv_window));

    let body = serde_json::to_string(&order)?;

        // Submit the order
        let request = client
            .post("https://api.bybit.com/v5/order/create")
            .headers(headers.clone())
            .body(body.clone());

        let response = request.send().await?;

响应信息 #

Response {
url: Url {
    scheme: "https",
    cannot_be_a_base: false,
    username: "",
    password: None,
    host: Some(
        Domain(
            "api.bybit.com",
        ),
    ),
    port: None,
    path: "/v5/order/create",
    query: None,
    fragment: None,
},
status: 200,
headers: {
    "content-type": "application/json; charset=utf-8",
    "content-length": "122",
    "x-bapi-limit": "20",
    "x-bapi-limit-status": "19",
    "x-bapi-limit-reset-timestamp": "1676755851552",
    "ret_code": "170130",
    "traceid": "78d2bec29fead6e40447a63ba1eae5d9",
    "timenow": "1676755851556",
    "server": "Openresty",
    "expires": "Sat, 18 Feb 2023 21:30:51 GMT",
    "cache-control": "max-age=0, no-cache, no-store",
    "pragma": "no-cache",
    "date": "Sat, 18 Feb 2023 21:30:51 GMT",
    "connection": "keep-alive",
},
}

错误原因排查方向 #

• 参数命名错误：请求体中的order_type不符合API规范，ByBit V5现货订单接口要求该参数为驼峰式的orderType，参数名格式不匹配会直接触发参数无效错误。
• 数量与余额验证：确认账户中ETH可用余额是否足够覆盖0.1 ETH的下单量，虽然0.1在ETHUSDT现货最小交易单位范围内，但余额不足可能被归类为参数无效。
• 签名计算细节：检查签名生成时，是否将请求体参数按ASCII码升序排序后拼接，统一账户POST请求的签名规则要求包含排序后的请求体参数，排序错误会导致签名验证不通过，间接触发参数无效提示。
• 时间同步问题：验证本地服务器时间与ByBit服务器时间差是否超过设置的recv_window（5000ms），时间不同步会导致请求过期，引发参数验证错误。

内容的提问来源于stack exchange，提问作者standard