跳到主要内容

提交订单

请求类型: POST 请求路径: /v4/order


请求参数

名称类型必填默认值描述取值范围
symbolstring交易对
clientOrderIdstring自定义订单号,正则: ^[a-zA-Z0-9_]{4,22}$
sidestring订单方向BUY, SELL
typestring订单类型LIMIT, MARKET
timeInForcestring有效方式GTC, FOK, IOC, GTX
bizTypestring业务类型SPOT, LEVER
pricenumber价格。当为 LIMIT 订单时必填;MARKET 订单不需要填写
quantitynumber数量。当为 LIMIT 订单或按数量市价单时必填
quoteQtynumber金额。当为 LIMIT 订单或按金额市价单时必填
nftIdstringNFT 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 地址
}
}