修改跟单配置 (TRADE)

• POST /capi/v3/copy/follower/settings

权重(IP): 10

请求参数

参数名	类型	是否必填	说明
traderId	Long	是	带单交易员 UID。
settingType	String	是	配置方式：unified 统一配置，per_symbol 分别配置。
unifiedTraceConfig	对象	条件必填	settingType 为 unified 时必填，symbols 用来控制需要跟单的交易对。
symbolTraceConfigs	数组	条件必填	settingType 为 per_symbol 时必填。必须为每个跟单交易对传一条配置。

跟单配置对象

参数名	类型	是否必填	说明
symbol	String	条件必填	交易对，例如 BTCUSDT。仅 symbolTraceConfigs 必填。
symbols	数组	条件必填	交易对列表。仅 unifiedTraceConfig 必填；每个交易对都必须是支持跟单的交易对。
traceType	String	是	跟单类型：percent、amount。
traceValue	String	是	跟单值。
maxHoldQty	String	否	最大持仓数量，范围 10-100000；symbolTraceConfigs 中必填。
stopProfitRatio	String	否	止盈比例，范围 0-4；symbolTraceConfigs 中必填。
stopLossRatio	String	否	止损比例，范围 0-4；symbolTraceConfigs 中必填。
slippageRatio	String	否	滑点比例，0 表示不限制，否则范围为 0.001-0.01；symbolTraceConfigs 中必填。
marginType	String	否	保证金类型：cross、isolated、trader。symbolTraceConfigs 中只允许 trader。
leverageType	String	否	杠杆类型：fixed、trader、specify。symbolTraceConfigs 中只允许 fixed 和 trader。
fixedLongLeverage	Integer	否	固定多仓杠杆。symbolTraceConfigs[].leverageType 为 fixed 时必填；统一配置不传默认 10。
fixedShortLeverage	Integer	否	固定空仓杠杆。symbolTraceConfigs[].leverageType 为 fixed 时必填；统一配置不传默认 10。
customLeverages	数组	条件必填	自定义杠杆列表。统一配置 leverageType 为 specify 时必填，其中的交易对必须和 unifiedTraceConfig.symbols 完全一致。
customLeverages[].symbol	String	是	交易对。
customLeverages[].longLeverage	Integer	否	多仓杠杆，默认 10。
customLeverages[].shortLeverage	Integer	否	空仓杠杆，默认 10。

统一配置请求示例

curl -X POST "https://api-contract.weex.com/capi/v3/copy/follower/settings" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "Content-Type: application/json" \
   -d '{
     "traderId": 123456,
     "settingType": "unified",
     "unifiedTraceConfig": {
       "symbols": ["BTCUSDT", "ETHUSDT"],
       "traceType": "amount",
       "traceValue": "100",
       "maxHoldQty": "1000",
       "stopProfitRatio": "0.2",
       "stopLossRatio": "0.1",
       "slippageRatio": "0.001",
       "marginType": "trader",
       "leverageType": "specify",
       "customLeverages": [
         {
           "symbol": "BTCUSDT",
           "longLeverage": 10,
           "shortLeverage": 10
         },
         {
           "symbol": "ETHUSDT",
           "longLeverage": 10,
           "shortLeverage": 10
         }
       ]
     }
   }'

分别配置请求示例

{
  "traderId": 123456,
  "settingType": "per_symbol",
  "symbolTraceConfigs": [
    {
      "symbol": "BTCUSDT",
      "traceType": "amount",
      "traceValue": "100",
      "maxHoldQty": "1000",
      "stopProfitRatio": "0.2",
      "stopLossRatio": "0.1",
      "slippageRatio": "0.001",
      "marginType": "trader",
      "leverageType": "fixed",
      "fixedLongLeverage": 10,
      "fixedShortLeverage": 10
    }
  ]
}

返回参数

返回标准成功响应。

返回示例

{
  "code": "200",
  "msg": "success",
  "requestTime": 1627354109502
}