交易接口/全仓合约交易

下单

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，本玩法下应填1

accountIdinteger · longOptional

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

bizTypeinteger · int32Required

业务类型，1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；12-限价开

directioninteger · int32Required

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

symbolIdinteger · longRequired

产品ID，产品ID

positionIdinteger · longOptional

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

requestTimeinteger · longRequired

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

requestPricestringRequired

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

requestNumstringRequired

下单手数

stopLossstringOptional

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

takeProfitstringOptional

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

expireTypeinteger · int32Optional

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

remarkstringOptional

备注

accountCurrencystringRequired

账户货币

accountDigitsinteger · int32Required

账户小数位

crossLevelNuminteger · int32Optional

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

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.CfdMMOrderApiService.addMarketOrder

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

{
  "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,
  "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.updateOrder

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填1

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.CfdMMOrderApiService.updateOrder

POST /api/global/tradeapi.app.CfdMMOrderApiService.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.queryHistoryCloseOrderList

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填1

accountIdinteger · longOptional

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

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.CfdMMOrderApiService.queryHistoryCloseOrderList

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

{
  "tradeType": 1,
  "accountId": 1,
  "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.OrderApiService.setCrossLevelNum

Header parameters

companyIdstringOptionalExample: {{company}}

tokenstringOptionalExample: {{LoginResult.data.token}}

langstringOptionalExample: en-US

groupstringOptionalExample: tradeApi

tracestringOptionalExample: {{mock_trace}}

versionstringOptionalExample: 0.0.1

Body

tradeTypeinteger · longRequired

本玩法下应填1

companyIdinteger · longRequired

customerIdinteger · longRequired

customerNostringRequired

customerGroupIdinteger · longRequired

symbolIdinteger · longRequired

requestTimeinteger · int32Required

tracestringOptional

Responses

200Success

application/json

post

/global/tradeapi.app.CfdMMOrderApiService.setCrossLevelNum

POST /api/global/tradeapi.app.CfdMMOrderApiService.setCrossLevelNum HTTP/1.1
Host: prewppc-3.cmfbl.com
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "tradeType": 1,
  "companyId": 1,
  "customerId": 1,
  "customerNo": "text",
  "customerGroupId": 1,
  "symbolId": 1,
  "requestTime": 1,
  "trace": "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.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

本玩法下应填1

accountIdinteger · longOptional

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

bizTypeinteger · int32Required

1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；12-限价开

directioninteger · int32Required

1-买；2-卖；

symbolIdinteger · longRequired

positionIdinteger · longOptional

平仓下单时，必填

requestTimeinteger · longRequired

13位时间戳

requestPricestringRequired

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

requestNumstringRequired

expireTypeinteger · int32Optional

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

remarkstringOptional

accountCurrencystringRequired

accountDigitsinteger · int32Required

crossLevelNuminteger · int32Optional

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

Responses

200Success

application/json

post

/global/tradeapi.app.CfdMMOrderApiService.calculateMarketOrder

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

{
  "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
}

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.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

本玩法下应填1

accountIdinteger · longOptional

positionIdinteger · longRequired

Responses

200Success

application/json

post

/global/tradeapi.app.CfdMMPositionApiService.queryPositionDetail

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

{
  "tradeType": 1,
  "accountId": 1,
  "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

本玩法下应填1

accountIdinteger · longOptional

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-减少；

assetsIdinteger · longOptional

langstringOptional

Responses

200Success

application/json

post

/global/tradeapi.app.CfdMMOrderApiService.queryCapitalFlowList

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

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

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
}

Previous资金接口/客户取款接口 Next交易接口/逐仓合约交易

Last updated 1 month ago