跳到主要内容

创建跟踪单

请求类型: POST 描述: /future/trade/v1/entrust/create-track


限流规则

200/s/apikey


参数说明

名称类型必填默认值描述范围
callbackstringTRUEN/A回调幅度配置FIXED; PROPORTION
callbackValnumberTRUEN/A回调值(大于0)大于0
orderSidestringTRUEN/A订单方向BUY; SELL
origQtynumberTRUEN/A原始数量(张)
positionSidestringTRUEN/A持仓方向BOTH; LONG; SHORT
positionTypestringTRUEN/A持仓类型CROSSED; ISOLATED
symbolstringTRUEN/A交易对
triggerPriceTypestringTRUEN/A触发价格类型INDEX_PRICE; MARK_PRICE; LATEST_PRICE
activationPricenumberFALSEN/A激活价格
clientMediastringFALSEN/A客户端媒介
clientMediaChannelstringFALSEN/A客户端媒介渠道
clientOrderIdstringFALSEN/A客户端订单ID
expireTimeintegerFALSEN/A过期时间

请求示例

curl -X POST "https://fapi.xt.com/future/trade/v1/entrust/create-track" \
-H "validate-appkey: $APPKEY" # 必须
-H "validate-timestamp: $TIMESTAMP" # 必须
-H "validate-signature: $SIGNATURE" # 必须
-H "Content-Type: application/x-www-form-urlencoded" # 必须
-d "symbol=btc_usdt" # 必须
-d "callback=FIXED" # 必须
-d "callbackVal=1" # 必须
-d "orderSide=BUY" # 必须
-d "origQty=1" # 必须
-d "positionSide=LONG" # 必须
-d "positionType=CROSSED" # 必须
-d "triggerPriceType=INDEX_PRICE" # 必须
-d "activationPrice=999"

响应示例

{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {},
"returnCode": 0
}

错误码

错误码描述
invalid_symbol交易对不存在
symbol_is_not_trading交易对当前无法交易
The trading pair currently does not support placing orders through the OpenAPI.该交易对当前不支持通过 OpenAPI 下单
deposit_coupon_exists该抵扣券已领取或已绑定
exist_bonus_positon_not_create_reverse_position不可创建反向仓位
invalid_params参数设置有误或置空了
invalid_exceed_max_rate_limit回调幅度设置不能超过最大值
invalid_below_min_rate_limit回调幅度设置不能低于最小值
invalid_exceed_max_price_limit回调幅度设置不能超过最新成交价的
invalid_exceed_min_price_limit回调率设置不能低于最新成交价的
invalid_activation_price触发价格不合法
invalid_quantity_scale数量必须为整数
user_can_not_trade账户禁止交易
sub_account_not_trade子账户不可交易
user_can_not_open_position账户禁止开仓
symbol_is_not_open_position当前交易对已暂停开新仓