下单
POST🔒 Trading
在指定交易对上下达普通现货订单（市价单 MARKET 或限价单 LIMIT）。
请求头
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| BROKER-ID | String | 否 | 可选的经纪商/合作方标识符，用于标记通过其下达的订单 |
请求体
Limit
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| orderType | String | 是 | LIMIT |
| symbol | String | 是 | 交易对，例如 BTC-USDT |
| orderSide | String | 是 | BUY 或 SELL |
| orderPrice | Double | 是 | 成交的限价 |
| orderSize | Double | 是 | 以基础货币计的订单数量 |
| timeInForce | String | 否 | 有效方式策略（GTC、IOC、FOK） |
| clOrderId | String | 否 | 客户端提供的订单标识符，在响应中回显（最多 64 个字符） |
| postOnly | Boolean | 否 | 若为 true，则当订单会立即撮合时拒绝该订单（post-only / 只做挂单方） |
Market
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| orderType | String | 是 | MARKET — LIMIT · MARKET · PEG · OCO · TWAP · CONDITIONAL · TRAILING |
| symbol | String | 是 | 交易对，例如 BTC-USDT |
| orderSide | String | 是 | BUY 或 SELL |
| clOrderId | String | 否 | 客户端提供的订单标识符，在响应中回显（最多 64 个字符） |
| quoteOrderSize | Double | 否 | 以计价货币计的订单金额；仅用于 BUY 方向 |
| orderSize | Double | 否 | 以基础货币计的订单数量；仅用于 SELL 方向 |
响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| orderId | String | 服务器分配的订单标识符 |
| clOrderId | String | 若提供了客户端订单标识符，则回显该标识符 |
| status | Integer | 反映订单当前状态的数字状态码（ 例如已成交、已撤销、已拒绝） |
| market | String | 交易对，例如 BTC-USDT |
| type | Integer | 标识订单类型的数字代码（例如 LIMIT、MARKET、TWAP、PEG） |
| orderSide | String | BUY 或 SELL |
| orderPrice | Double | 订单价格 |
| postOnly | Boolean | 订单是否以 post-only（只挂单）方式提交 |
| timestamp | Long | 服务器端事件时间戳，单位为纪元毫秒 |
| orderDetailType | String | 适用时的订单详细子类型（例如算法 TWAP 订单的 TWAP） |
| message | String | 可选的诊断信息；仅在返回时出现（例如拒绝原因） |
| userQuoteCurrency | String | 为用户配置的计价货币 |
| orderCurrency | String | 'quote' 或 'base'；指示下方填充的是计价数量字段还是基础数量字段 |
| originalOrderBaseSize | Double | 以基础货币计的原始数量；当 orderCurrency 为 'base' 时填充 |
| originalOrderQuoteSize | Double | 以计价货币计的原始数量；当 orderCurrency 为 'quote' 时填充 |
| currentOrderBaseSize | Double | 以基础货币计的当前有效数量；当 orderCurrency 为 'base' 时填充 |
| currentOrderQuoteSize | Double | 以计价货币计的当前有效数量；当 orderCurrency 为 'quote' 时填充 |
| remainingOrderBaseSize | Double | 以基础货币计的剩余未成交数量；当 orderCurrency 为 'base' 时填充 |
| remainingOrderQuoteSize | Double | 以计价货币计的剩余未成交数量；当 orderCurrency 为 'quote' 时填充 |
| filledBaseSize | Double | 最近一 次撮合成交的数量，以基础货币计 |
| totalFilledBaseSize | Double | 所有撮合的累计成交数量，以基础货币计 |
| avgFilledPrice | Double | 成交量加权平均成交价格 |
| time_in_force | String | 有效方式策略（GTC、IOC、FOK）；当不适用于该订单类型时为 null |
example
POST
https://api.btse.com/spot/api/v4/trade/ordersRequest (Limit)
{
"symbol": "BTC-USD",
"orderType": "LIMIT",
"orderSide": "BUY",
"orderSize": 0.00001,
"orderPrice": 61024.1
}
Request (Market)
{
"symbol": "BTC-USD",
"orderType": "MARKET",
"orderSide": "BUY",
"quoteOrderSize": 1.9
}
Response (Limit)
[
{
"orderId": "4eca2eb4-e6ad-4355-ae12-5ce757b105b3",
"clOrderId": "",
"status": 2,
"market": "BTC-USD",
"type": 76,
"orderSide": "BUY",
"orderPrice": 61024.1,
"postOnly": false,
"timestamp": 1784891308063,
"orderDetailType": null,
"message": null,
"userQuoteCurrency": "USD",
"orderCurrency": "base",
"originalOrderBaseSize": 0.00001,
"originalOrderQuoteSize": null,
"currentOrderBaseSize": 0.00001,
"currentOrderQuoteSize": null,
"remainingOrderBaseSize": 0.00001,
"remainingOrderQuoteSize": null,
"filledBaseSize": 0,
"totalFilledBaseSize": 0,
"avgFilledPrice": 0,
"time_in_force": "GTC"
}
]
Response (Market)
[
{
"orderId": "859af358-c6d2-49c3-a2cf-48ba5b74b968",
"clOrderId": "",
"status": 5,
"market": "BTC-USD",
"type": 77,
"orderSide": "BUY",
"orderPrice": 64235.9701,
"postOnly": false,
"timestamp": 1784891308215,
"orderDetailType": null,
"message": null,
"userQuoteCurrency": "USD",
"orderCurrency": "quote",
"originalOrderBaseSize": null,
"originalOrderQuoteSize": 1.9,
"currentOrderBaseSize": null,
"currentOrderQuoteSize": 1.9,
"remainingOrderBaseSize": null,
"remainingOrderQuoteSize": 0.61528059,
"filledBaseSize": 0.00002,
"totalFilledBaseSize": 0.00002,
"avgFilledPrice": 64235.9701,
"time_in_force": "GTC"
}
]