交易接口/逐仓合约交易

订单列表

post

说明：查看订单列表

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.queryOrderPage

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

玩法ID，本玩法下应填2

accountIdinteger · longOptional

账户ID

accountCurrencystringOptional

账户货币

bizTypeinteger · int32Optional

业务类型，1-市价开；2-市价平；3-止损平仓单；4-止盈平仓单；5-爆仓强平单；6-到期平仓单；7-销户平仓单；8-手动强平单；9-延时订单；10-限价预埋单；11-停损预埋单；13-撮合限价开仓单；14-撮合限价平仓单

directioninteger · int32Optional

订单买卖方向，1-买；2-卖；

statusinteger · longOptional

订单状态，1-收到订单；2-订单成交；3-订单部分成交；4-订单取消；5-订单部分取消；6-订单拒绝；7-订单过期；

symbolIdinteger · int32Optional

产品ID

orderIdsstringOptional

订单ID串，多个订单ID间以,分割

positionIdinteger · longOptional

仓位id

sizeinteger · longOptional

每页条数，默认20

currentintegerOptional

当前页码

querySourcestringOptional

H5：移动端web；PC_Web：pcweb；System：系统；Android：安卓原生app；iOS：苹果原生app；HOS：鸿蒙OS；PC_Win：pcwindows客户端；PC_Mac：pcmac客户端；默认同登录来源。（枚举仅供参考）

thirdPartyOrderstringOptional

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.queryOrderPage

POST /api/global/tradeapi.app.OrderApiService.queryOrderPage HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 204

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "bizType": 1,
  "direction": 1,
  "status": 1,
  "symbolId": 1,
  "orderIds": "text",
  "positionId": 1,
  "size": 1,
  "current": 1,
  "querySource": "text",
  "thirdPartyOrder": "text"
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-11w38izu-238ws9-maphaym-1f261yz-1677573205",
  "code": "0",
  "data": [],
  "bizCode": "",
  "tm": 7,
  "msgParams": null,
  "ok": true
}

持仓列表

post

说明：查询持仓列表

group=tradeApi
version=0.0.1
bizType=tradeapi.app.PositionApiService.queryPositionPage

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

账户id

accountCurrencystringOptional

账户币种

statusinteger · int32Optional

1-持仓中；3-部分平仓；

orderIdinteger · longOptional

订单id

dealIdinteger · longOptional

成交id

symbolIdinteger · longOptional

产品id

startTimeinteger · longOptional

13位时间戳

endTimeinteger · longOptional

13位时间戳

sortFieldNamestringOptional

orderId-订单Id；openTime-执行时间；symbolId-产品Id；pnl-盈亏；

sortTypestringOptional

asc-升序；desc-降序；（默认desc）

sizeinteger · longOptional

默认20

currentinteger · longOptional

默认1

querySourcestringOptional

thirdPartyOrderstringOptional

Responses

200Success

application/json

post

/global/tradeapi.app.PositionApiService.queryPositionPage

POST /api/global/tradeapi.app.PositionApiService.queryPositionPage HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 235

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "status": 1,
  "orderId": 1,
  "dealId": 1,
  "symbolId": 1,
  "startTime": 1,
  "endTime": 1,
  "sortFieldName": "text",
  "sortType": "text",
  "size": 1,
  "current": 1,
  "querySource": "text",
  "thirdPartyOrder": "text"
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-6d6k11o7-00ve031-d863o8-4hk417e-1677572056",
  "code": "0",
  "data": [
    {
      "symbolId": 967,
      "orderId": 24153319,
      "dealId": 13394059,
      "canReduceMargin": "0.0000",
      "openPrice": "7.05",
      "remark": null,
      "takeProfitDecimal": "0.00",
      "closeNum": 0,
      "closeFee": "0.0000",
      "takeProfit": "0",
      "occupyTheMargin": "0.0000",
      "interest": "0.0000",
      "maintenanceMargin": "0.0000",
      "closeVolume": 0,
      "openVolume": 1,
      "closeTime": 0,
      "closeAccountDigits": 4,
      "symbolName": "AXS/USDT_PRD",
      "openTime": 1672023552024,
      "profit": null,
      "tradeType": 1,
      "direction": 1,
      "singleMargin": null,
      "margin": null,
      "openContractSize": 1,
      "resp": null,
      "openMargin": "0.3480",
      "openNum": 1,
      "openFee": "0.3525",
      "closeSymbolDigits": 2,
      "warningMargin": "0.0000",
      "stopLossDecimal": "0.00",
      "adjustCrossLevel": "1-100",
      "openSymbolDigits": 2,
      "volume": 1,
      "accountId": 1031767,
      "companyId": 360,
      "positionId": 2022122620993,
      "closeFreeDigits": null,
      "stopLoss": "0",
      "minVolume": null,
      "marginSetType": "2",
      "crossLevelNum": 20,
      "openAccountDigits": 4,
      "closePrice": "0.0000",
      "status": "1"
    }
  ],
  "bizCode": "C",
  "tm": 21,
  "msgParams": null,
  "ok": true
}

修改预埋单

post

group=tradeApi version=0.0.1 bizType=tradeapi.app.OrderApiService.updatePboOrder

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

非必填。如填，已该账户进行交易

pboIdstringRequired

stopLossnumberOptional

需乘以10的产品报价小数位次方，处理为整数传入。

takeProfitnumberOptional

需乘以10的产品报价小数位次方，处理为整数传入。

requestNumnumberOptional

requestPricenumberOptional

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.updatePboOrder

POST /api/global/tradeapi.app.OrderApiService.updatePboOrder HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "tradeType": 82,
  "pboId": "77",
  "stopLoss": 9,
  "accountId": 78,
  "requestPrice": 19,
  "takeProfit": 35,
  "requestNum": 47
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-dqxq8-qu20y7y-dq58lhn-39i483-1677570581",
  "code": "0",
  "data": {
    "tradeVolume": "0.1",
    "symbolId": 720,
    "orderId": 14460002,
    "fee": "-0.0668",
    "openOrClose": 1,
    "openPrice": "22.25",
    "takeProfit": "0",
    "positionId": 2023022819810,
    "interest": "0",
    "openDirection": 1,
    "stopLoss": "0",
    "executePrice": "22.25",
    "digits": 2,
    "symbolName": "BINAN_SOL_USDT",
    "profit": "0",
    "direction": 1
  },
  "bizCode": "",
  "tm": 162,
  "msgParams": null,
  "ok": true
}

下单

post

说明：合约逐仓交易下单

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.addMarketOrder

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

玩法ID，本玩法下应填2

accountIdinteger · longOptional

账户ID，非必填。如填，已该账户进行交易

bizTypeinteger · int32Required

业务类型，1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；13-聚合限价开仓单；14-聚合限价平仓单

directioninteger · int32Required

订单买卖方向，1-买；2-卖；

symbolIdinteger · longRequired

产品ID

positionIdinteger · longOptional

仓位ID，平仓下单时，必填

requestTimeinteger · longRequired

下单请求时间，13位时间戳

requestPricestringRequired

下单时价格，需乘以10的产品报价小数位次方，处理为整数传入。仅作下单记录，非成交价格。

requestNumstringRequired

下单手数或下单额度，配合entryType使用

stopLossstringOptional

止损单价，需乘以10的产品报价小数位次方，处理为整数传入。

takeProfitstringOptional

止盈单价，需乘以10的产品报价小数位次方，处理为整数传入。

expireTypeinteger · int32Optional

过期类型，仅预埋单有效。1-当日有效；2-当周有效；3-30天；4-90天；默认2

remarkstringOptional

备注

accountCurrencystringRequired

账户货币

accountDigitsinteger · int32Required

账户小数位

crossLevelNuminteger · int32Optional

杠杆倍数，本参数需针对产品一致。如不一致，将无法下单成功

entryTypeintegerRequired

下单类型 1 按数量 , 2 按额

blacklistbooleanOptional

黑名单客户订单（默认 false）

sourcestringOptional

H5：移动端web；PC_Web：pcweb；System：系统；Android：安卓原生app；iOS：苹果原生app；HOS：鸿蒙OS；PC_Win：pcwindows客户端；PC_Mac：pcmac客户端；默认同登录来源。（限制最高255字符，枚举仅供参考，只能使用字母、数字、下划线）

thirdPartyOrderstringOptional

（限制最高255字符，只能使用字母、数字、下划线）

slippagestringOptional

仅市价单有效。可为百分比（仅支持2位小数，超出部分按四舍五入处理）也可以时浮点型仅支持4位小数，超出部分按四舍五入处理）。其他格式不支持。

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.addMarketOrder

POST /api/global/tradeapi.app.OrderApiService.addMarketOrder HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 361

{
  "tradeType": 1,
  "accountId": 1,
  "bizType": 1,
  "direction": 1,
  "symbolId": 1,
  "positionId": 1,
  "requestTime": 1,
  "requestPrice": "text",
  "requestNum": "text",
  "stopLoss": "text",
  "takeProfit": "text",
  "expireType": 1,
  "remark": "text",
  "accountCurrency": "text",
  "accountDigits": 1,
  "crossLevelNum": 1,
  "entryType": 1,
  "blacklist": true,
  "source": "text",
  "thirdPartyOrder": "text",
  "slippage": "text"
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-dqxq8-qu20y7y-dq58lhn-39i483-1677570581",
  "code": "0",
  "data": {
    "tradeVolume": "0.1",
    "symbolId": 720,
    "orderId": 14460002,
    "fee": "-0.0668",
    "openOrClose": 1,
    "openPrice": "22.25",
    "takeProfit": "0",
    "positionId": 2023022819810,
    "interest": "0",
    "openDirection": 1,
    "stopLoss": "0",
    "executePrice": "22.25",
    "digits": 2,
    "symbolName": "BINAN_SOL_USDT",
    "profit": "0",
    "direction": 1
  },
  "bizCode": "",
  "tm": 162,
  "msgParams": null,
  "ok": true
}

预埋单列表

post

group=tradeApi version=0.0.1 bizType=tradeapi.app.OrderApiService.queryPBOOrderPage

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

非必填。如填，已该账户进行交易

accountCurrencystringOptional

账户货币

sortFieldNamestringOptional

排序字段名 orderTime(openTime,orderId),symbolId,symbolCode

sortTypestringOptional

排序类型 desc 降序；asc 升序

querySourcestringOptional

订单来源

thirdPartyOrderstringOptional

三方订单ID

Responses

200Success

application/json

post

/global/tradeapi.app.CfdWBWOrderApiService.queryPBOOrderPage

POST /api/global/tradeapi.app.CfdWBWOrderApiService.queryPBOOrderPage HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "tradeType": 59,
  "accountCurrency": "aliqua fugiat laboris",
  "accountId": 85,
  "sortType": "eu ut enim Ut consequat",
  "sortFieldName": "少可县得"
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-dqxq8-qu20y7y-dq58lhn-39i483-1677570581",
  "code": "0",
  "data": {
    "tradeVolume": "0.1",
    "symbolId": 720,
    "orderId": 14460002,
    "fee": "-0.0668",
    "openOrClose": 1,
    "openPrice": "22.25",
    "takeProfit": "0",
    "positionId": 2023022819810,
    "interest": "0",
    "openDirection": 1,
    "stopLoss": "0",
    "executePrice": "22.25",
    "digits": 2,
    "symbolName": "BINAN_SOL_USDT",
    "profit": "0",
    "direction": 1
  },
  "bizCode": "",
  "tm": 162,
  "msgParams": null,
  "ok": true
}

设置仓位止损止盈

post

说明：设置仓位止损止盈

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.updateOrder

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

账户ID，必须与账户货币二者填其一

accountCurrencystringOptional

账户货币，必须与账户ID二者填其一

orderIdinteger · longRequired

订单ID

positionIdinteger · longRequired

仓位ID

accountDigitsinteger · longRequired

账户小数位

stopLossstringOptional

止损单价，需乘以10的产品报价小数位次方，处理为整数传入。

takeProfitstringOptional

止盈单价，需乘以10的产品报价小数位次方，处理为整数传入。

remarkstringOptional

备注

Responses

200Success

application/json

post

/global/tradeapi.app.CfdWBWOrderApiService.updateOrder

POST /api/global/tradeapi.app.CfdWBWOrderApiService.updateOrder HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "orderId": 1,
  "positionId": 1,
  "accountDigits": 1,
  "stopLoss": "text",
  "takeProfit": "text",
  "remark": "text"
}

200Success

{
  "msg": "Account balance is 0",
  "fail": true,
  "trace": "x-0ei175a-x4dh9u2-1g8s95r-m2708212-1677570735",
  "code": "E000031",
  "data": "tradeapi.app.OrderApiService.updateOrder",
  "bizCode": "CFD",
  "tm": 7,
  "msgParams": null,
  "ok": false
}

订单详情

post

说明：查看订单详情

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.queryOrderDetail

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

accountCurrencystringOptional

orderIdinteger · longRequired

Responses

200Success

application/json

post

/global/tradeapi.app.CfdWBWOrderApiService.queryOrderDetail

POST /api/global/tradeapi.app.CfdWBWOrderApiService.queryOrderDetail HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "orderId": 1
}

200Success

{
  "bizCode": "text",
  "code": "text",
  "msg": "text",
  "tm": 1,
  "trace": "text",
  "msgParams": "text",
  "ok": true,
  "fail": true,
  "data": {
    "orderId": 1,
    "busiiType": 1,
    "direction": 1,
    "status": 1,
    "userGroupId": 1,
    "accountId": 1,
    "symbolId": 1,
    "digits": 1,
    "contractSize": 1,
    "requestPrice": "text",
    "requestNum": "text",
    "requestTime": 1,
    "executeMarginRate": 1,
    "executeMarginRateDigits": 1,
    "spread": 1,
    "pointRatio": 1,
    "executePrice": "text",
    "executeRate": 1,
    "rateDigits": 1,
    "fee": "text",
    "feeDigits": 1,
    "executeTime": 1,
    "createTime": 1,
    "updateTime": 1,
    "positionId": 1,
    "stopLoss": "text",
    "takeProfit": "text",
    "remark": "text",
    "source": "text",
    "thirdPartyOrder": "text"
  }
}

平仓记录

post

说明：查询历史平仓记录

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.queryHistoryCloseOrderList

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

accountCurrencystringOptional

sortFieldNamestringRequired

pnl-利润；openTime-开仓时间；closeTime-平仓时间；orderId-订单id；symbolId-产品id；

sortTypestringRequired

desc-降序；asc-升序；

symbolIdinteger · longOptional

openStartTimeinteger · longOptional

13位时间戳

openEndTimeinteger · longOptional

13位时间戳

closeStartTimeinteger · longOptional

13位时间戳

closeEndTimeinteger · longOptional

13位时间戳

currentinteger · int32Optional

默认1

sizeinteger · int32Optional

默认20

querySourcestringOptional

thirdPartyOrderstringOptional

Responses

200Success

application/json

post

/global/tradeapi.app.CfdWBWOrderApiService.queryHistoryCloseOrderList

POST /api/global/tradeapi.app.CfdWBWOrderApiService.queryHistoryCloseOrderList HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 245

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "sortFieldName": "text",
  "sortType": "text",
  "symbolId": 1,
  "openStartTime": 1,
  "openEndTime": 1,
  "closeStartTime": 1,
  "closeEndTime": 1,
  "current": 1,
  "size": 1,
  "querySource": "text",
  "thirdPartyOrder": "text"
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-77q3ivej-u4wi1d3a-5pbl5v-ypwj0-1677573497",
  "code": "0",
  "data": {
    "accountId": null,
    "trace": "x-77q3ivej-u4wi1d3a-5pbl5v-ypwj0-1677573497",
    "companyId": 360,
    "current": 1,
    "size": 20,
    "totalPage": 0,
    "ip": "47.242.92.158",
    "customerId": 1176,
    "list": [],
    "lang": "en-US",
    "totalPnl": 0,
    "customerNo": "86001175"
  },
  "bizCode": "",
  "tm": 6,
  "msgParams": null,
  "ok": true
}

设置仓位杠杆倍数

post

group=tradeApi
version=0.0.1
bizType=tradeapi.app.PositionApiService.updateCrossLevelNum

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

symbolIdinteger · longRequired

产品ID

requestTimeinteger · int32Required

杠杆倍数

Responses

200Success

application/json

post

/global/tradeapi.app.PositionApiService.updateCrossLevelNum

POST /api/global/tradeapi.app.PositionApiService.updateCrossLevelNum HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "tradeType": 1,
  "symbolId": 1,
  "requestTime": 1
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-6s8tc-2v65-i8270878-1727-1677574098",
  "code": "0",
  "data": {
    "crossLevelNum": 11
  },
  "bizCode": "",
  "tm": 17,
  "msgParams": null,
  "ok": true
}

修改仓位占用保证金

post

说明：合约-全仓玩法，设置客户对产品的杠杆倍数，影响该产品所有仓位

group=tradeApi
version=0.0.1
bizType=tradeapi.app.PositionApiService.updateOccupyTheMargin

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longRequired

账户id

accountCurrencystringOptional

账户币种

positionIdintegerOptional

仓位id

accountDigitsstringRequired

账户小数位

occupyTheMarginstringRequired

修改占用保证金金额，可以负数

orderIdintegerRequired

订单id

remarkstringRequired

备注

Responses

200Success

application/json

post

/global/tradeapi.app.PositionApiService.updateOccupyTheMargin

POST /api/global/tradeapi.app.PositionApiService.updateOccupyTheMargin HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "positionId": 1,
  "accountDigits": "text",
  "occupyTheMargin": "text",
  "orderId": 1,
  "remark": "text"
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-6s8tc-2v65-i8270878-1727-1677574098",
  "code": "0",
  "data": {
    "crossLevelNum": 11
  },
  "bizCode": "",
  "tm": 17,
  "msgParams": null,
  "ok": true
}

持仓详情

post

说明：查询持仓详情

group=tradeApi
version=0.0.1
bizType=tradeapi.app.PositionApiService.queryPositionDetail

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

accountCurrencystringOptional

positionIdinteger · longRequired

Responses

200Success

application/json

post

/global/tradeapi.app.PositionApiService.queryPositionDetail

POST /api/global/tradeapi.app.PositionApiService.queryPositionDetail HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "tradeType": 1,
  "accountId": 1,
  "accountCurrency": "text",
  "positionId": 1
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-11wdkt-kg9i-ld2y-53mz854-1677571927",
  "code": "0",
  "data": {
    "symbolId": 720,
    "orderId": 14460003,
    "dealId": 94870543,
    "canReduceMargin": "0.0000",
    "openPrice": "22.18",
    "remark": null,
    "takeProfitDecimal": "0.00",
    "closeNum": 0,
    "closeFee": "0.0000",
    "takeProfit": "0",
    "occupyTheMargin": "0.0000",
    "interest": "0.0000",
    "maintenanceMargin": "0.0000",
    "closeVolume": 0,
    "openVolume": 0.1,
    "closeTime": 0,
    "closeAccountDigits": 4,
    "symbolName": "BINAN_SOL_USDT",
    "openTime": 1677571033093,
    "profit": null,
    "tradeType": 1,
    "direction": 1,
    "singleMargin": null,
    "margin": null,
    "openContractSize": 1,
    "resp": null,
    "openMargin": "0.2209",
    "openNum": 0.1,
    "openFee": "0.0665",
    "closeSymbolDigits": 2,
    "warningMargin": "0.0000",
    "stopLossDecimal": "0.00",
    "adjustCrossLevel": "1-100",
    "openSymbolDigits": 2,
    "volume": 0.1,
    "accountId": 1031767,
    "companyId": 360,
    "positionId": 2023022819827,
    "closeFreeDigits": null,
    "stopLoss": "0",
    "minVolume": null,
    "marginSetType": "2",
    "crossLevelNum": 10,
    "openAccountDigits": 4,
    "closePrice": "0.0000",
    "status": "1"
  },
  "bizCode": "C",
  "tm": 27,
  "msgParams": null,
  "ok": true
}

资金流水

post

说明：分页查询账户资金流水

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.queryCapitalFlowList

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

账户id

sizeinteger · longOptional

每页数据条数

currentinteger · longOptional

当前页

businessTypeinteger · int32Optional

业务类型，0-不限制；1-存款；2-取款；3-系统清零；4-额度调整；5-冻结；6-交易；36-划转；42-奖励；

statusinteger · int32Optional

状态，0-不限制；1-初始化；2-处理成功；3-处理失败；

startTimeinteger · longOptional

起始时间，13位时间戳

endTimeinteger · longOptional

结束时间，13位时间戳

operateinteger · int32Optional

资金流向，0-不限制；1-增加；2-减少；

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.queryCapitalFlowList

POST /api/global/tradeapi.app.OrderApiService.queryCapitalFlowList HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "tradeType": 1,
  "accountId": 1,
  "size": 1,
  "current": 1,
  "businessType": 1,
  "status": 1,
  "startTime": 1,
  "endTime": 1,
  "operate": 1
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-n72ql-snasw1-ts561r-31e7q-1677572540",
  "code": "0",
  "data": {
    "total": 40,
    "current": 1,
    "size": 20,
    "records": [
      {
        "amount": "-0.0665",
        "businessType1": 6001,
        "amountAfter": "109849175.3769",
        "businessType1Name": "Open position fee",
        "updateTime": 1677571033166,
        "remark": null,
        "version": 0,
        "subjectId": 1504110734228991000,
        "accountId": 1031767,
        "createTime": 1677571033151,
        "businessTypeName": "transaction",
        "createdBy": null,
        "updateBy": null,
        "bookkeepId": 2023022819827,
        "currency": "USDT",
        "digits": 4,
        "amountIn": "0.0000",
        "amountOut": "0.0665",
        "id": 238603703,
        "businessType": 6,
        "customerNo": "86001175",
        "status": 2
      }
    ]
  },
  "bizCode": "A",
  "tm": 13,
  "msgParams": null,
  "ok": true
}

取消限价单（仅用于聚合模式）

post

说明：取消限价单（仅用于聚合模式）

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.closeTradePboOrder

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

玩法ID，本玩法下应填2

orderIdinteger · int32Required

订单id

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.closeTradePboOrder

POST /api/global/tradeapi.app.OrderApiService.closeTradePboOrder HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "tradeType": 1,
  "orderId": 1
}

200Success

{
  "msg": "ut",
  "ok": false,
  "msgParams": "aute",
  "trace": "deserunt commodo cillum",
  "bizCode": "34",
  "code": "60",
  "fail": true,
  "tm": 67,
  "data": {}
}

检查订单状态

post

说明：检查订单状态

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.checkOrderStatus

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

玩法ID，本玩法下应填2

orderIdinteger · longRequired

订单id

operatorTypeinteger · min: 1 · max: 2Required

1=调整杠杆倍数，2=调整保证金，3=订单是否成交

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.checkOrderStatus

POST /api/global/tradeapi.app.OrderApiService.checkOrderStatus HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "tradeType": 1,
  "orderId": 1,
  "operatorType": 1
}

200Success

{
  "msg": "ut",
  "ok": false,
  "msgParams": "aute",
  "trace": "deserunt commodo cillum",
  "bizCode": "34",
  "code": "60",
  "fail": true,
  "tm": 67,
  "data": {}
}

下单试算

post

说明：试算下单保证金、手续费

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.calculateMarketOrder

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

非必填。如填，已该账户进行交易

bizTypeinteger · int32Required

业务类型，1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；13-聚合限价开仓单；14-聚合限价平仓单

directioninteger · int32Required

1-买；2-卖；

symbolIdinteger · longRequired

positionIdinteger · longOptional

平仓下单时，必填

requestTimeinteger · longRequired

13位时间戳

requestPricestringRequired

仅作下单记录，非成交价格*

requestNumstringRequired

expireTypeinteger · int32Optional

仅预埋单有效。1-当日有效；2-当周有效；

remarkstringOptional

accountCurrencystringRequired

accountDigitsinteger · int32Required

crossLevelNuminteger · int32Optional

仅开仓有效，同个产品应仅有一个杠杆倍数

stopLossnumber · doubleOptional

止损单价，需乘以10的产品报价小数位次方，处理为整数传入。

takeProfitnumber · doubleOptional

止盈单价，需乘以10的产品报价小数位次方，处理为整数传入。

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.calculateMarketOrder

POST /api/global/tradeapi.app.OrderApiService.calculateMarketOrder HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "tradeType": 1,
  "accountId": 1,
  "bizType": 1,
  "direction": 1,
  "symbolId": 1,
  "positionId": 1,
  "requestTime": 1,
  "requestPrice": "text",
  "requestNum": "text",
  "expireType": 1,
  "remark": "text",
  "accountCurrency": "text",
  "accountDigits": 1,
  "crossLevelNum": 1,
  "stopLoss": 1,
  "takeProfit": 1
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-7rf727-m64d8ar-72dn4ij-23o3vt-1677574738",
  "code": "0",
  "data": {
    "margin": "10000.6584",
    "calculatePrice": "136.719",
    "fee": "0.0000"
  },
  "bizCode": "",
  "tm": 31,
  "msgParams": null,
  "ok": true
}

计算爆仓价格

post

说明：计算爆仓价格

group=tradeApi
version=0.0.1
bizType=tradeapi.app.OrderApiService.calculationBurstPrice

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填2

accountIdinteger · longOptional

非必填。

positionIdinteger · longRequired

adjustMarginnumber · doubleRequired

正数为增加保证金金额；负数为减少保证金金额

Responses

200Success

application/json

post

/global/tradeapi.app.OrderApiService.calculationBurstPrice

POST /api/global/tradeapi.app.OrderApiService.calculationBurstPrice HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "tradeType": 1,
  "accountId": 1,
  "positionId": 1,
  "adjustMargin": 1
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "x-7rf727-m64d8ar-72dn4ij-23o3vt-1677574738",
  "code": "0",
  "data": {
    "evaluateClosePrice": "136.719"
  },
  "bizCode": "",
  "tm": 31,
  "msgParams": null,
  "ok": true
}

Previous交易接口/全仓合约交易 Next交易接口/杠杆交易

Last updated 1 month ago