下单(TRADE)
类型:TRADE
公开端点:
POST /fapi/v1/order
Rocky 实现:POST /fapi/v1/order✓
创建一个新订单。目前仅支持 LIMIT;MARKET 在撮合引擎补充 MARKET 类型之前直接返回 -1100。
请求
POST /fapi/v1/order
Query / body 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 是 | standard pair,如 BTCUSDT。 |
side | string | 是 | BUY 或 SELL。 |
type | string | 是 | 目前仅接受 LIMIT。 |
quantity | string | 是 | 标的资产数量。 |
price | string | LIMIT 必填 | 限价。 |
newClientOrderId | string | 否 | 自定义幂等 key;不传则自动生成 UUID。 |
响应 — 200
{
"orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
"clientOrderId": "my-bot-1748275200-001",
"symbol": "BTCUSDT",
"status": "NEW",
"side": "BUY",
"type": "LIMIT",
"price": "76500.00",
"origQty": "0.001",
"updateTime": 1748275200500
}
错误
| HTTP | code | msg |
|---|---|---|
400 | -1100 | 未知 symbol、side 非法、不支持的 type( 如 MARKET)。 |
400 | -1102 | LIMIT 单缺少 price。 |
422 | -2010 | 余额不足以锁定所需保证金。 |
401 | -2015 | API key 无效或已吊销。 |
其他标准参数 暂未支持:
timeInForce、reduceOnly、closePosition、stopPrice、activationPrice、callbackRate、workingType、priceProtect、newOrderRespType、positionSide。杠杆由系统级LEVERAGE_V1=10固定,无法逐单设置。