# 交易接口/全仓合约交易

## 下单

> 说明：合约全仓交易下单\
> \
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.OrderApiService.addMarketOrder\
> \`\`\`<br>

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMOrderApiService.addMarketOrder":{"post":{"summary":"下单","deprecated":false,"description":"说明：合约全仓交易下单\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.addMarketOrder\n```\n","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"玩法ID，本玩法下应填1","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"账户ID，非必填。如填，已该账户进行交易","format":"long"},"bizType":{"type":"integer","title":"业务类型","description":"业务类型，1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；12-限价开","format":"int32"},"direction":{"type":"integer","title":"订单买卖方向","description":"订单买卖方向，1-买；2-卖；","format":"int32"},"symbolId":{"type":"integer","title":"产品ID","format":"long","description":"产品ID，产品ID"},"positionId":{"type":"integer","title":"仓位ID","description":"仓位ID，平仓下单时，必填","format":"long"},"requestTime":{"type":"integer","title":"下单请求时间","description":"下单请求时间，13位时间戳","format":"long"},"requestPrice":{"type":"string","title":"下单时价格","description":"下单时价格，需乘以10的`产品报价小数位`次方，处理为整数传入。仅作下单记录，非成交价格。"},"requestNum":{"type":"string","title":"下单手数","description":"下单手数"},"stopLoss":{"type":"string","title":"止损单价","description":"止损单价，需乘以10的`产品报价小数位`次方，处理为整数传入。"},"takeProfit":{"type":"string","title":"止盈单价","description":"止盈单价，需乘以10的`产品报价小数位`次方，处理为整数传入。"},"expireType":{"type":"integer","title":"过期类型","description":"过期类型，仅预埋单有效。1-当日有效；2-当周有效；3-30天；4-90天；默认2","format":"int32"},"remark":{"type":"string","title":"备注","description":"备注"},"accountCurrency":{"type":"string","title":"账户货币","description":"账户货币"},"accountDigits":{"type":"integer","title":"账户小数位","format":"int32","description":"账户小数位"},"crossLevelNum":{"type":"integer","title":"杠杆倍数","format":"int32","description":"杠杆倍数，仅开仓有效，同个产品应仅有一个杠杆倍数"},"source":{"type":"string","title":"订单来源","description":"H5：移动端web；PC_Web：pcweb；System：系统；Android：安卓原生app；iOS：苹果原生app；HOS：鸿蒙OS；PC_Win：pcwindows客户端；PC_Mac：pcmac客户端；默认同登录来源。（限制最高255字符，枚举仅供参考，只能使用字母、数字、下划线）"},"thirdPartyOrder":{"type":"string","title":"三方订单标识","description":"（限制最高255字符，只能使用字母、数字、下划线）"},"slippage":{"type":"string","title":"交易滑点","description":"仅市价单有效。可为百分比（仅支持2位小数，超出部分按四舍五入处理）也可以时浮点型仅支持4位小数，超出部分按四舍五入处理）。其他格式不支持。"}},"required":["tradeType","bizType","direction","symbolId","requestTime","requestPrice","requestNum","accountCurrency","accountDigits"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码","description":"模块标识码"},"code":{"type":"string","title":"状态返回码","description":"状态返回码"},"msg":{"type":"string","title":"状态描述","description":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）","description":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码","description":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割","description":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean","description":"响应是否成功"},"fail":{"type":"boolean","description":"响应是否失败"},"data":{"type":"object","properties":{"orderId":{"type":"integer","title":"订单号","format":"long","description":"订单号"},"positionId":{"type":"integer","title":"持仓单号","format":"long","description":"持仓单号"},"tradeVolume":{"type":"string","title":"交易手数","description":"交易手数"},"openPrice":{"type":"string","title":"开仓价","description":"开仓价"},"executePrice":{"type":"string","title":"成交价","description":"成交价"},"openDirection":{"type":"integer","title":"开仓时买卖方向","description":"开仓时买卖方向，1-买；2-卖；","format":"int32"},"direction":{"type":"integer","title":"本次下单买卖方向","description":"本次下单买卖方向，1-买；2-卖；","format":"int32"},"openOrClose":{"type":"integer","title":"本次下单开平类型","description":"本次下单开平类型，1-开仓；2-平仓；","format":"int32"},"symbolName":{"type":"string","title":"产品名称","description":"产品名称"},"symbolId":{"type":"integer","title":"产品Id","format":"long","description":"产品Id"},"stopLoss":{"type":"string","title":"止损价","description":"止损价，与入参一致"},"takeProfit":{"type":"string","title":"止盈价","description":"止盈价，与入参一致"},"digits":{"type":"integer","title":"产品小数位","format":"int32","description":"产品小数位"},"fee":{"type":"string","title":"下单手续费","description":"下单手续费"},"interest":{"type":"string","title":"利息","description":"利息，仅平仓是存在"},"profit":{"type":"string","title":"盈亏","description":"盈亏，仅平仓是存在"}},"title":"数据体","description":"数据体"}}}}},"headers":{}}}}}}}
````

## 设置仓位止损止盈

> 说明：设置仓位止损止盈\
> \
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.OrderApiService.updateOrder\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMOrderApiService.updateOrder":{"post":{"summary":"设置仓位止损止盈","deprecated":false,"description":"说明：设置仓位止损止盈\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.updateOrder\n```","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"本玩法下应填1","format":"long"},"accountId":{"type":"integer","title":"账户ID","format":"long","description":"账户ID，必须与账户货币二者填其一"},"accountCurrency":{"type":"string","title":"账户货币","description":"账户货币，必须与账户ID二者填其一"},"orderId":{"type":"integer","title":"订单ID","format":"long","description":"订单ID"},"positionId":{"type":"integer","title":"仓位ID","format":"long","description":"仓位ID"},"accountDigits":{"type":"integer","title":"账户小数位","format":"long","description":"账户小数位"},"stopLoss":{"type":"string","title":"止损单价","description":"止损单价，需乘以10的`产品报价小数位`次方，处理为整数传入。"},"takeProfit":{"type":"string","title":"止盈单价","description":"止盈单价，需乘以10的`产品报价小数位`次方，处理为整数传入。"},"remark":{"type":"string","title":"备注","description":"备注"}},"required":["tradeType","orderId","positionId","accountDigits"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码"},"code":{"type":"string","title":"状态返回码"},"msg":{"type":"string","title":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"positionId":{"type":"integer","title":"仓位ID","format":"long"},"orderId":{"type":"integer","title":"订单ID","format":"long"},"dealId":{"type":"integer","title":"成交单ID","format":"long"},"status":{"type":"string","title":"仓位状态","description":"0-初始化；1-持仓中；2-已完成；3-部分平仓；"},"direction":{"type":"integer","format":"int32","title":"买卖方向","description":"1-买；2-卖；"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"symbolName":{"type":"string","title":"产品名称"},"openAccountDigits":{"type":"integer","title":"开仓账户小数位","format":"int32"},"openSymbolDigits":{"type":"integer","format":"int32","title":"开仓产品小数位"},"openContractSize":{"type":"integer","format":"int32","title":"合约大小"},"openPrice":{"type":"string","title":"开仓单价"},"openNum":{"type":"string","title":"开仓数量"},"closeAccountDigits":{"type":"integer","title":"平仓账户小数位","format":"int32"},"closeSymbolDigits":{"type":"integer","title":"平仓产品小数位","format":"int32"},"closePrice":{"type":"string","title":"平仓单价"},"closeFreeDigits":{"type":"string","title":"平仓手续费小数位"},"profit":{"type":"string","title":"盈亏"},"openMargin":{"type":"string","title":"开仓占用保证金"},"stopLoss":{"type":"string","title":"止损单价","description":"原始登记值，未处理"},"takeProfit":{"type":"string","title":"止盈单价","description":"原始登记值，未处理"},"remark":{"type":"string","title":"备注"},"margin":{"type":"string","title":"实时占用保证金"},"openTime":{"type":"integer","format":"long","title":"开仓时间","description":"13位时间戳"},"closeTime":{"type":"integer","format":"long","title":"平仓时间","description":"13位时间戳"},"openFee":{"type":"string","title":"开仓手续费"},"closeFee":{"type":"string","title":"平仓手续费"},"closeNum":{"type":"string","title":"平仓数量"},"openVolume":{"type":"string","title":"开仓手数"},"closeVolume":{"type":"string","title":"平仓手数"},"minVolume":{"type":"string","title":"单边最小手数"},"volume":{"type":"string","title":"手数"},"marginSetType":{"type":"string","title":"保证金类型","description":"1-比例；2-范围；"}}}}}}},"headers":{}}}}}}}
````

## 平仓记录

> 说明：查询历史平仓记录\
> \
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.OrderApiService.queryHistoryCloseOrderList\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMOrderApiService.queryHistoryCloseOrderList":{"post":{"summary":"平仓记录","deprecated":false,"description":"说明：查询历史平仓记录\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.queryHistoryCloseOrderList\n```","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"本玩法下应填1","format":"long"},"accountId":{"type":"integer","title":"账户ID","format":"long"},"sortFieldName":{"type":"string","title":"排序字段名","description":"pnl-利润；openTime-开仓时间；closeTime-平仓时间；orderId-订单id；symbolId-产品id；"},"sortType":{"type":"string","title":"排序类型","description":"desc-降序；asc-升序；"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"openStartTime":{"type":"integer","title":"开仓起始时间","description":"13位时间戳","format":"long"},"openEndTime":{"type":"integer","title":"开仓结束时间","description":"13位时间戳","format":"long"},"closeStartTime":{"type":"integer","title":"平仓起始时间","description":"13位时间戳","format":"long"},"closeEndTime":{"type":"integer","title":"平仓结束时间","description":"13位时间戳","format":"long"},"current":{"type":"integer","title":"页码","description":"默认1","format":"int32"},"size":{"type":"integer","title":"每页数据量","description":"默认20","format":"int32"},"querySource":{"type":"string","title":"订单来源","description":"H5：移动端web；PC_Web：pcweb；System：系统；Android：安卓原生app；iOS：苹果原生app；HOS：鸿蒙OS；PC_Win：pcwindows客户端；PC_Mac：pcmac客户端；（枚举仅供参考）"},"thirdPartyOrder":{"type":"string","title":"三方订单标识"}},"required":["tradeType","sortFieldName","sortType"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码"},"code":{"type":"string","title":"状态返回码"},"msg":{"type":"string","title":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"current":{"type":"integer","title":"当前页码","format":"int32"},"totalPnl":{"type":"number","title":"总利润","format":"double"},"size":{"type":"integer","title":"每页数据量","format":"int32"},"totalPage":{"type":"integer","title":"总页数","format":"int32"},"list":{"type":"array","items":{"type":"object","properties":{"symbolId":{"type":"integer","format":"long","title":"产品id"},"bizType":{"type":"integer","format":"int32","title":"平仓类型","description":"2-市价平；3-止损平仓；4-止盈平仓；5-爆仓强平；6-产品到期强平；7-销户平仓；8-手动强平；"},"orderId":{"type":"integer","format":"long","title":"订单id"},"openVolume":{"type":"string","title":"开仓手数"},"openPrice":{"type":"string","title":"开仓价"},"closeVolume":{"type":"string","title":"平仓手数"},"closePrice":{"type":"string","title":"平仓价"},"takeProfit":{"type":"string","title":"止盈价","description":"没设置则显示-"},"stopLoss":{"type":"string","title":"止损价","description":"没设置则显示-"},"closeTime":{"type":"integer","title":"平仓时间","format":"long","description":"13位时间戳"},"commission":{"type":"string","title":"手续费"},"symbolName":{"type":"string","title":"产品名称"},"openTime":{"type":"integer","format":"long","title":"开仓时间","description":"13位时间戳"},"profit":{"type":"string","title":"利润"},"interest":{"type":"string","title":"持仓利息"},"openDirection":{"type":"integer","title":"开仓方向","description":"1-买；2-卖；","format":"int32"},"closeDirection":{"type":"integer","format":"int32","description":"1-买；2-卖；","title":"平仓方向"},"source":{"type":"string","title":"订单来源","description":"H5：移动端web；PC_Web：pcweb；System：系统；Android：安卓原生app；iOS：苹果原生app；HOS：鸿蒙OS；PC_Win：pcwindows客户端；PC_Mac：pcmac客户端；默认同登录来源。（枚举仅供参考）"},"thirdPartyOrder":{"type":"string","title":"三方订单标识"}}},"title":"平仓列表集合"}},"title":"数据体"}}}}},"headers":{}}}}}}}
````

## 设置杠杆倍数

> 说明：合约-全仓玩法，设置客户对产品的杠杆倍数，影响该产品所以仓位\
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.OrderApiService.setCrossLevelNum\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMOrderApiService.setCrossLevelNum":{"post":{"summary":"设置杠杆倍数","deprecated":false,"description":"说明：合约-全仓玩法，设置客户对产品的杠杆倍数，影响该产品所以仓位\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.setCrossLevelNum\n```","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"本玩法下应填1","format":"long"},"companyId":{"type":"integer","title":"公司ID","format":"long"},"customerId":{"type":"integer","title":"客户ID","format":"long"},"customerNo":{"type":"string","title":"客户编号"},"customerGroupId":{"type":"integer","title":"客户组Id","format":"long"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"requestTime":{"type":"integer","title":"杠杆倍数","format":"int32"},"trace":{"type":"string","title":"追踪码"}},"required":["tradeType","customerId","customerNo","customerGroupId","requestTime","companyId","symbolId"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码"},"code":{"type":"string","title":"状态返回码"},"msg":{"type":"string","title":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"crossLevelNum":{"type":"integer","title":"杠杆倍数","format":"int32"}},"title":"数据体"}}}}},"headers":{}}}}}}}
````

## 下单试算

> 说明：试算下单保证金、手续费\
> \
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.OrderApiService.calculateMarketOrder\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMOrderApiService.calculateMarketOrder":{"post":{"summary":"下单试算","deprecated":false,"description":"说明：试算下单保证金、手续费\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.calculateMarketOrder\n```","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"本玩法下应填1","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"非必填。如填，已该账户进行交易","format":"long"},"bizType":{"type":"integer","title":"业务类型","description":"1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；12-限价开","format":"int32"},"direction":{"type":"integer","title":"订单买卖方向","description":"1-买；2-卖；","format":"int32"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"positionId":{"type":"integer","title":"仓位ID","description":"平仓下单时，必填","format":"long"},"requestTime":{"type":"integer","title":"下单请求时间","description":"13位时间戳","format":"long"},"requestPrice":{"type":"string","title":"下单时价格","description":"仅作下单记录，非成交价格*"},"requestNum":{"type":"string","title":"下单手数"},"expireType":{"type":"integer","title":"过期类型","description":"仅预埋单有效。1-当日有效；2-当周有效；","format":"int32"},"remark":{"type":"string","title":"备注"},"accountCurrency":{"type":"string","title":"账户货币"},"accountDigits":{"type":"integer","title":"账户小数位","format":"int32"},"crossLevelNum":{"type":"integer","title":"杠杆倍数","format":"int32","description":"仅开仓有效，同个产品应仅有一个杠杆倍数"}},"required":["tradeType","bizType","direction","symbolId","requestTime","requestPrice","requestNum","accountCurrency","accountDigits"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码"},"code":{"type":"string","title":"状态返回码"},"msg":{"type":"string","title":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"fee":{"type":"string","title":"手续费"},"margin":{"type":"string","title":"保证金"},"calculatePrice":{"type":"string","title":"计算价格"}},"title":"数据体"}}}}},"headers":{}}}}}}}
````

## 持仓详情

> 说明：查询持仓详情\
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.PositionApiService.queryPositionDetail\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMPositionApiService.queryPositionDetail":{"post":{"summary":"持仓详情","deprecated":false,"description":"说明：查询持仓详情\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.PositionApiService.queryPositionDetail\n```","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"本玩法下应填1","format":"long"},"accountId":{"type":"integer","title":"账户ID","format":"long"},"positionId":{"type":"integer","title":"仓位id","format":"long"}},"required":["tradeType","positionId"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码"},"code":{"type":"string","title":"状态返回码"},"msg":{"type":"string","title":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"positionId":{"type":"integer","title":"仓位ID","format":"long"},"orderId":{"type":"integer","title":"订单ID","format":"long"},"dealId":{"type":"integer","title":"成交单ID","format":"long"},"status":{"type":"string","title":"仓位状态","description":"0-初始化；1-持仓中；2-已完成；3-部分平仓；"},"direction":{"type":"integer","format":"int32","title":"买卖方向","description":"1-买；2-卖；"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"symbolName":{"type":"string","title":"产品名称"},"openAccountDigits":{"type":"integer","title":"开仓账户小数位","format":"int32"},"openSymbolDigits":{"type":"integer","format":"int32","title":"开仓产品小数位"},"openContractSize":{"type":"integer","format":"int32","title":"合约大小"},"openPrice":{"type":"string","title":"开仓单价"},"openNum":{"type":"string","title":"开仓数量"},"closeAccountDigits":{"type":"integer","title":"平仓账户小数位","format":"int32"},"closeSymbolDigits":{"type":"integer","title":"平仓产品小数位","format":"int32"},"closePrice":{"type":"string","title":"平仓单价"},"closeFreeDigits":{"type":"string","title":"平仓手续费小数位"},"profit":{"type":"string","title":"盈亏"},"openMargin":{"type":"string","title":"开仓占用保证金"},"stopLoss":{"type":"string","title":"止损单价","description":"原始登记值，未处理"},"takeProfit":{"type":"string","title":"止盈单价","description":"原始登记值，未处理"},"remark":{"type":"string","title":"备注"},"margin":{"type":"string","title":"实时占用保证金"},"openTime":{"type":"integer","format":"long","title":"开仓时间","description":"13位时间戳"},"closeTime":{"type":"integer","format":"long","title":"平仓时间","description":"13位时间戳"},"openFee":{"type":"string","title":"开仓手续费"},"closeFee":{"type":"string","title":"平仓手续费"},"closeNum":{"type":"string","title":"平仓数量"},"openVolume":{"type":"string","title":"开仓手数"},"closeVolume":{"type":"string","title":"平仓手数"},"minVolume":{"type":"string","title":"单边最小手数"},"stopLossDecimal":{"type":"string","title":"止损单价","description":"`stopLoss`根据`closeSymbolDigits`处理后结果。用于前端直接展示"},"takeProfitDecimal":{"type":"string","title":"止盈单价","description":"`takeProfit`根据`closeSymbolDigits`处理后结果。用于前端直接展示"},"volume":{"type":"string","title":"手数"},"marginSetType":{"type":"string","title":"保证金类型","description":"1-比例；2-范围；"},"source":{"type":"string","title":"订单来源","description":"H5：移动端web；PC_Web：pcweb；System：系统；Android：安卓原生app；iOS：苹果原生app；HOS：鸿蒙OS；PC_Win：pcwindows客户端；PC_Mac：pcmac客户端；默认同登录来源。（枚举仅供参考）"},"thirdPartyOrder":{"type":"string","title":"三方订单标识"}},"title":"数据体"}}}}},"headers":{}}}}}}}
````

## 资金流水

> 说明：分页查询账户资金流水\
> \
> \`\`\`\
> group=tradeApi\
> version=0.0.1\
> bizType=tradeapi.app.OrderApiService.queryCapitalFlowList\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"交易接口/全仓合约交易"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/tradeapi.app.CfdMMOrderApiService.queryCapitalFlowList":{"post":{"summary":"资金流水","deprecated":false,"description":"说明：分页查询账户资金流水\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.queryCapitalFlowList\n```","tags":["交易接口/全仓合约交易"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"group","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tradeType":{"type":"integer","title":"玩法ID","description":"本玩法下应填1","format":"long"},"accountId":{"type":"integer","format":"long","title":"账户ID"},"size":{"type":"integer","title":"每页数据条数","format":"long"},"current":{"type":"integer","title":"当前页","format":"long"},"businessType":{"type":"integer","format":"int32","title":"业务类型","description":"0-不限制；1-存款；2-取款；3-系统清零；4-额度调整；5-冻结；6-交易；36-划转；42-奖励；"},"status":{"type":"integer","format":"int32","title":"状态","description":"0-不限制；1-初始化；2-处理成功；3-处理失败；"},"startTime":{"type":"integer","format":"long","description":"13位时间戳","title":"起始时间"},"endTime":{"type":"integer","format":"long","description":"13位时间戳","title":"结束时间"},"operate":{"type":"integer","format":"int32","title":"资金流向","description":"0-不限制；1-增加；2-减少；"},"assetsId":{"type":"integer","format":"long","title":"资产Id"},"lang":{"type":"string","title":"语种"}},"required":["tradeType"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码","description":"模块标识码"},"code":{"type":"string","title":"状态返回码","description":"状态返回码，0成功，其他失败"},"msg":{"type":"string","title":"状态描述","description":"状态描述"},"tm":{"type":"integer","format":"int64","title":"处理时长（毫秒）","description":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码","description":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割","description":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean","description":"成功标志"},"fail":{"type":"boolean","description":"失败标志"},"data":{"type":"object","properties":{"total":{"type":"integer","title":"总数","format":"long","description":"总数"},"size":{"type":"integer","format":"long","title":"每页条数","description":"每页条数"},"current":{"type":"integer","format":"long","title":"当前页","description":"当前页"},"records":{"type":"array","items":{"type":"object","properties":{"remark":{"type":"string","title":"备注","description":"备注"},"createTime":{"type":"integer","title":"创建日期","description":"创建日期,13位时间戳","format":"long"},"updateTime":{"type":"integer","format":"long","title":"更新时间","description":"更新时间,13位时间戳"},"subjectId":{"type":"integer","format":"long","title":"科目ID","description":"科目ID"},"bookkeepId":{"type":"integer","format":"long","title":"凭证ID","description":"凭证ID"},"amountIn":{"type":"string","title":"增加金额","description":"增加金额"},"amountOut":{"type":"string","title":"减少金额","description":"减少金额"},"status":{"type":"integer","format":"int32","title":"状态","description":"状态，1-初始化；2-处理成功；3-处理失败；"},"amountAfter":{"type":"string","title":"变动后余额","description":"变动后余额"},"businessType":{"type":"integer","title":"业务类型","format":"int32","description":"业务类型，1-存款；2-取款；3-系统清零；4-额度调整；5-冻结；6-交易；36-划转；42-奖励；"},"businessType1":{"type":"integer","format":"int32","description":"业务子类型，1001-前端存款；1002-存款手续费；2001-前端取款；2002-取消取款；2003-取款手续费；2004-取消手续费；2005-确认转账；3001-系统清零；4001-额度调整_存款；4002-额度调整_取款；4003-额度调整_其他；4004-额度调整_赠金；4005-额度调整_释放不可提；4006-额度调整_不可提；4007-额度调整_转入返佣；5001-冻结；5002-解冻；6001-开仓手续费；6002-平仓手续费；6003-隔夜利息；6004-市价平仓盈亏；6005-止损平仓盈亏；6006-止盈平仓盈亏；6007-系统强平盈亏；6008-到期强平盈亏；6009-手动强平盈亏；36001-划入金额；36002-划出金额；42001-发放奖励；42002-扣回奖励；42003-发放返佣；42004-扣回返佣；","title":"业务子类型"},"customerNo":{"type":"string","title":"客户编号","description":"客户编号"},"digits":{"type":"string","title":"小数位","description":"小数位"},"currency":{"type":"string","title":"币种","description":"币种"},"businessTypeName":{"type":"string","title":"业务类型名称","description":"业务类型名称，按传入`lang`确认语种"},"businessType1Name":{"type":"string","title":"业务子类型名称","description":"业务子类型名称，按传入`lang`确认语种"},"accountId":{"type":"integer","title":"账户Id","format":"long","description":"账户Id"},"orderId":{"type":"integer","format":"long","description":"订单id"},"dealId":{"type":"integer","format":"long","description":"成交id"}},"title":"数据体","description":"数据体"},"title":"流水集合","description":"流水集合"}},"description":"数据体"}}}}},"headers":{}}}}}}}
````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-cn.multimarkets.org/client-api/geng-duo-.../jiao-yi-jie-kou-quan-cang-he-yue-jiao-yi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.