提交订单

请求类型: 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 地址
  }
}