提交订单
请求类型: POST
请求路径: /v4/order
请求参数
| 名称 | 类型 | 必填 | 默认值 | 描述 | 取值范围 |
|---|---|---|---|---|---|
| symbol | string | 是 | — | 交易对 | — |
| clientOrderId | string | 否 | — | 自定义订单号,正则: ^[a-zA-Z0-9_]{4,22}$ | — |
| side | string | 是 | — | 订单方向 | BUY, SELL |
| type | string | 是 | — | 订单类型 | LIMIT, MARKET |
| timeInForce | string | 是 | — | 有效方式 | GTC, FOK, IOC, GTX |
| bizType | string | 是 | — | 业务类型 | SPOT, LEVER |
| price | number | 否 | — | 价格。当为 LIMIT 订单时必填;MARKET 订单不需要填写 | — |
| quantity | number | 否 | — | 数量。当为 LIMIT 订单或按数量市价单时必填 | — |
| quoteQty | number | 否 | — | 金额。当为 LIMIT 订单或按金额市价单时必填 | — |
| nftId | string | 否 | — | NFT ID | — |
备注
- 创建 买入市价单 时,
quantity必须为空,quoteQty必填。 - 创建 卖出市价单 时,
quoteQty必须为空,quantity必填。
请求示例
curl --location --request POST 'https://sapi.xt.com/v4/order' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'validate-algorithms: HmacSHA256' \
--header 'validate-recvwindow: 60000' \
--header 'validate-appkey: xxxxxxxxxx' \
--header 'validate-timestamp: xxxxxxxxxx' \
--header 'validate-signature: xxxxxxxxxx' \
--data '{
"symbol": "XT_USDT",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTC",
"bizType": "SPOT",
"price": 10,
"quantity": 1
}'
Res
限流规则
- 20/s/apikey
响应示例
Response
{
"rc": 0,
"mc": "string",
"ma": [{}],
"result": {
"orderId": "6216559590087220004",
"ip": "127.0.0.1" // IP 地址
}
}