# 交易接口/逐仓合约交易 ## 订单列表 > 说明：查看订单列表\ > \ > \`\`\`\ > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.queryOrderPage\ > \`\`\` ````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.OrderApiService.queryOrderPage":{"post":{"summary":"订单列表","deprecated":false,"description":"说明：查看订单列表\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.queryOrderPage\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，本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"账户ID","format":"long"},"accountCurrency":{"type":"string","title":"账户货币","description":"账户货币"},"bizType":{"type":"integer","title":"业务类型","description":"业务类型，1-市价开；2-市价平；3-止损平仓单；4-止盈平仓单；5-爆仓强平单；6-到期平仓单；7-销户平仓单；8-手动强平单；9-延时订单；10-限价预埋单；11-停损预埋单；13-撮合限价开仓单；14-撮合限价平仓单","format":"int32"},"direction":{"type":"integer","title":"订单买卖方向","description":"订单买卖方向，1-买；2-卖；","format":"int32"},"status":{"type":"integer","title":"订单状态","description":"订单状态，1-收到订单；2-订单成交；3-订单部分成交；4-订单取消；5-订单部分取消；6-订单拒绝；7-订单过期；","format":"long"},"symbolId":{"type":"integer","title":"产品ID","format":"int32","description":"产品ID"},"orderIds":{"type":"string","title":"订单ID串","description":"订单ID串，多个订单ID间以,分割"},"positionId":{"type":"integer","title":"仓位id","format":"long","description":"仓位id"},"size":{"type":"integer","format":"long","title":"每页条数","description":"每页条数，默认20"},"current":{"type":"integer","title":"当前页码","description":"当前页码"},"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"]}}}},"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"},"size":{"type":"integer","title":"每页数据量","format":"int32"},"total":{"type":"integer","title":"数据总数","format":"int32"},"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","title":"主键","format":"long"},"dealId":{"type":"integer","title":"成交单id","format":"long"},"bizType":{"type":"integer","title":"订单业务类型","description":"1-市价开；2-市价平；3-止损平仓单；4-止盈平仓单；5-爆仓强平单；6-到期平仓单；7-销户平仓单；8-手动强平单；9-延时订单；10-限价预埋单；11-停损预埋单；","format":"int32"},"direction":{"type":"integer","title":"订单买卖方向","description":"1-买；2-卖；","format":"int32"},"status":{"type":"integer","title":"订单状态","description":"1-收到订单；2-订单成交；3-订单部分成交；4-订单取消；5-订单部分取消；6-订单拒绝；7-订单过期；","format":"int32"},"customerGroupId":{"type":"integer","title":"客户组ID","format":"long"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"digits":{"type":"integer","title":"产品小数位","format":"long"},"symbolName":{"type":"string","title":"产品名称"},"requestPrice":{"type":"string","title":"请求价格","description":"*"},"requestNum":{"type":"string","title":"请求数量","description":"*"},"contractSize":{"type":"integer","title":"产品合约大小","format":"int32"},"executePrice":{"type":"string","title":"成交价","description":"*"},"requestTime":{"type":"integer","title":"请求时间","description":"13位时间戳","format":"long"},"executeTime":{"type":"integer","title":"成交时间","description":"13位时间戳","format":"long"},"fee":{"type":"string","title":"成交手续费","description":"*"},"executeMargin":{"type":"integer","title":"执行保证金","description":"*","format":"int32"},"accountDigits":{"type":"integer","title":"账户小数位","format":"int32"},"executeNum":{"type":"string","title":"已成交数量"},"cancelNum":{"type":"string","title":"已取消数量"},"positionId":{"type":"integer","title":"仓位ID","format":"long"},"stopLoss":{"type":"string","title":"止损单价","description":"*"},"takeProfit":{"type":"string","title":"止盈单价","description":"*"},"remark":{"type":"string","title":"备注"},"createTime":{"type":"integer","title":"创建时间","description":"13位时间戳","format":"long"},"updateTime":{"type":"integer","title":"最后更新时间","description":"13位时间戳","format":"long"},"seq":{"type":"integer","title":"报价序号","format":"long"},"interest":{"type":"integer","title":"持仓利息","format":"long"},"pnl":{"type":"integer","title":"盈亏","format":"long"},"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.PositionApiService.queryPositionPage\ > \`\`\` ````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.PositionApiService.queryPositionPage":{"post":{"summary":"持仓列表","deprecated":false,"description":"说明：查询持仓列表\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.PositionApiService.queryPositionPage\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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"账户id","format":"long"},"accountCurrency":{"type":"string","title":"账户货币","description":"账户币种"},"status":{"type":"integer","format":"int32","title":"仓位状态","description":"1-持仓中；3-部分平仓；"},"orderId":{"type":"integer","title":"订单ID","format":"long","description":"订单id"},"dealId":{"type":"integer","format":"long","title":"成交单ID","description":"成交id"},"symbolId":{"type":"integer","format":"long","title":"产品ID","description":"产品id"},"startTime":{"type":"integer","title":"开始时间","format":"long","description":"13位时间戳"},"endTime":{"type":"integer","format":"long","title":"结束时间","description":"13位时间戳"},"sortFieldName":{"type":"string","title":"排序字段名","description":"orderId-订单Id；openTime-执行时间；symbolId-产品Id；pnl-盈亏；"},"sortType":{"type":"string","title":"排序方式","description":"asc-升序；desc-降序；（默认desc）"},"size":{"type":"integer","title":"每页条数","description":"默认20","format":"long"},"current":{"type":"integer","title":"当前页","description":"默认1","format":"long"},"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"]}}}},"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":"array","items":{"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":"平仓数量","description":"*"},"openVolume":{"type":"string","title":"开仓手数","description":"*"},"closeVolume":{"type":"string","title":"平仓手数","description":"*"},"minVolume":{"type":"string","title":"单边最小手数","description":"*"},"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.updatePboOrder ```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.OrderApiService.updatePboOrder":{"post":{"summary":"修改预埋单","deprecated":false,"description":"group=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.updatePboOrder","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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"非必填。如填，已该账户进行交易","format":"long"},"pboId":{"type":"string","title":"预埋单ID"},"stopLoss":{"type":"number","title":"止损单价","description":"需乘以10的`产品报价小数位`次方，处理为整数传入。"},"takeProfit":{"type":"number","title":"止盈单价","description":"需乘以10的`产品报价小数位`次方，处理为整数传入。"},"requestNum":{"type":"number","title":"请求数量/额度"},"requestPrice":{"type":"number","title":"请求价格"}},"required":["tradeType","pboId"]}}}},"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":{"orderId":{"type":"integer","title":"订单号","format":"long"},"positionId":{"type":"integer","title":"持仓单号","format":"long"},"tradeVolume":{"type":"string","title":"交易手数"},"openPrice":{"type":"string","title":"开仓价"},"executePrice":{"type":"string","title":"成交价"},"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":"产品名称"},"symbolId":{"type":"integer","title":"产品Id","format":"long"},"stopLoss":{"type":"string","title":"止损价","description":"与入参一致"},"takeProfit":{"type":"string","title":"止盈价","description":"与入参一致"},"digits":{"type":"integer","title":"产品小数位","format":"int32"},"fee":{"type":"string","title":"下单手续费"},"interest":{"type":"string","title":"利息","description":"仅平仓是存在"},"profit":{"type":"string","title":"盈亏","description":"仅平仓是存在"}},"title":"数据体"}}}}},"headers":{}}}}}}} ``` ## 下单 > 说明：合约逐仓交易下单\ > \ > \`\`\`\ > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.addMarketOrder\ > \`\`\` ````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.OrderApiService.addMarketOrder":{"post":{"summary":"下单","deprecated":false,"description":"说明：合约逐仓交易下单\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.addMarketOrder\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，本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"账户ID，非必填。如填，已该账户进行交易","format":"long"},"bizType":{"type":"integer","title":"业务类型","description":"业务类型，1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；13-聚合限价开仓单；14-聚合限价平仓单","format":"int32"},"direction":{"type":"integer","title":"订单买卖方向","description":"订单买卖方向，1-买；2-卖；","format":"int32"},"symbolId":{"type":"integer","title":"产品ID","format":"long","description":"产品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":"下单手数或下单额度，配合entryType使用"},"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":"杠杆倍数，本参数需针对产品一致。如不一致，将无法下单成功"},"entryType":{"type":"integer","description":"下单类型 1 按数量 , 2 按额"},"blacklist":{"type":"boolean","title":"黑名单客户订单","description":"黑名单客户订单（默认 false）"},"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","description":"仅市价单有效。可为百分比（仅支持2位小数，超出部分按四舍五入处理）也可以时浮点型仅支持4位小数，超出部分按四舍五入处理）。其他格式不支持。","title":"交易滑点"}},"required":["tradeType","bizType","direction","symbolId","requestTime","requestPrice","requestNum","accountCurrency","accountDigits","entryType"]}}}},"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","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":"盈亏，仅平仓是存在"},"source":{"type":"string","title":"订单来源","description":"H5、Android、IOS、MT5"}},"title":"数据体","description":"数据体","required":["source"]}}}}},"headers":{}}}}}}} ```` ## 预埋单列表 > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.queryPBOOrderPage ```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.CfdWBWOrderApiService.queryPBOOrderPage":{"post":{"summary":"预埋单列表","deprecated":false,"description":"group=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.queryPBOOrderPage","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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"非必填。如填，已该账户进行交易","format":"long"},"accountCurrency":{"type":"string","title":"账户货币","description":"账户货币"},"sortFieldName":{"type":"string","title":"排序字段","description":"排序字段名 orderTime(openTime,orderId),symbolId,symbolCode"},"sortType":{"type":"string","title":"排序类型","description":"排序类型 desc 降序；asc 升序"},"querySource":{"type":"string","title":"订单来源","description":"订单来源"},"thirdPartyOrder":{"type":"string","title":"三方订单ID","description":"三方订单ID"}},"required":["tradeType"]}}}},"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":{"id":{"type":"string","title":"预埋单ID"},"symbolId":{"type":"integer","title":"产品Id","format":"long"},"type":{"type":"integer","title":"订单类型：9：预埋单，10:延时单 11:止损止盈单 0：市价单","format":"long"},"direction":{"type":"integer","title":"本次下单买卖方向","description":"1-买；2-卖；","format":"int32"},"state":{"type":"integer","title":"是否转成市价单 0:否，1:是；","format":"int32"},"requestPrice":{"type":"integer","title":"请求价格"},"openPrice":{"type":"string","title":"请求价格(已处理小数位)"},"digits":{"type":"integer","title":"产品小数位","format":"int32"},"orderTime":{"type":"integer","title":"预埋单和延时单生成时间"},"delayTime":{"type":"string","title":"延时区间开始时间，单位毫秒，延时单用"},"delayEndTime":{"type":"string","title":"延时区间结束时间，单位毫秒，延时单用"},"exchangeTime":{"type":"string","title":"转成市价单生成时间"},"reserve":{"type":"string","title":"保留字段"},"customerGroupId":{"type":"string","title":"客户组ID"},"contractSize":{"type":"integer","title":"本次下单开平类型","description":"1-开仓；2-平仓；","format":"int32"},"requestVolume":{"type":"integer","title":"请求数量"},"stopLoss":{"type":"integer","title":"止损价"},"stopLossTarget":{"type":"integer","title":"止损单价(已处理小数位)"},"takeProfit":{"type":"integer","title":"止盈单价"},"takeProfitTarget":{"type":"integer","title":"止盈单价(已处理小数位)"},"tradeType":{"type":"integer","title":"下单手续费"},"expireType":{"type":"string","title":"过期类型1.当日有效2.当周有效；3-30天；4-90天；"},"remark":{"type":"string","title":"备注"},"loanAmount":{"type":"integer","title":"借款金额(杠杆全仓)"},"tradeModel":{"type":"integer","title":"成交模式"},"crossLevelNum":{"type":"integer","title":"杠杆倍数"}},"title":"数据体"}}}}},"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.CfdWBWOrderApiService.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":"本玩法下应填2","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":{},"title":"数据体","description":"*"}}}}},"headers":{}}}}}}} ```` ## 订单详情 > 说明：查看订单详情\ > \ > \`\`\`\ > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.queryOrderDetail\ > \`\`\` ````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.CfdWBWOrderApiService.queryOrderDetail":{"post":{"summary":"订单详情","deprecated":false,"description":"说明：查看订单详情\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.queryOrderDetail\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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"*","format":"long"},"accountCurrency":{"type":"string","title":"账户货币","description":"*"},"orderId":{"type":"integer","title":"订单ID","format":"long"}},"required":["tradeType","orderId"]}}}},"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":{"orderId":{"type":"integer","title":"订单ID","format":"long"},"busiiType":{"type":"integer","title":"订单业务类型","description":"1-市价开；2-市价平；3-止损平仓单；4-止盈平仓单；5-爆仓强平单；6-到期平仓单；7-销户平仓单；8-手动强平单；9-延时订单；10-限价预埋单；11-停损预埋单；","format":"int32"},"direction":{"type":"integer","title":"订单买卖方向","description":"1-买；2-卖；","format":"int32"},"status":{"type":"integer","title":"订单状态","description":"1-收到订单；2-订单成交；3-订单部分成交；4-订单取消；5-订单部分取消；6-订单拒绝；7-订单过期；","format":"int32"},"userGroupId":{"type":"integer","title":"客户组ID","format":"long"},"accountId":{"type":"integer","title":"账户ID","format":"long"},"symbolId":{"type":"integer","title":"产品ID","format":"long"},"digits":{"type":"integer","title":"产品小数位","format":"long"},"contractSize":{"type":"integer","title":"产品合约大小","format":"int32"},"requestPrice":{"type":"string","title":"请求价格","description":"*"},"requestNum":{"type":"string","title":"请求数量","description":"*"},"requestTime":{"type":"integer","title":"请求时间","description":"13位时间戳","format":"long"},"executeMarginRate":{"type":"integer","title":"执行保证金比例","description":"*","format":"int32"},"executeMarginRateDigits":{"type":"integer","title":"执行保证金比例小数位","description":"*","format":"int32"},"spread":{"type":"integer","title":"成交点差","description":"*","format":"int32"},"pointRatio":{"type":"integer","title":"成交大点比例","description":"*","format":"int32"},"executePrice":{"type":"string","title":"成交价","description":"*"},"executeRate":{"type":"integer","title":"成交汇率","description":"*","format":"long"},"rateDigits":{"type":"integer","title":"汇率小数位","format":"long"},"fee":{"type":"string","title":"成交手续费","description":"*"},"feeDigits":{"type":"integer","title":"成交手续费小数位","format":"long"},"executeTime":{"type":"integer","title":"成交时间","description":"13位时间戳","format":"long"},"createTime":{"type":"integer","title":"创建时间","description":"13位时间戳","format":"long"},"updateTime":{"type":"integer","title":"最后更新时间","description":"13位时间戳","format":"long"},"positionId":{"type":"integer","title":"仓位ID","format":"long"},"stopLoss":{"type":"string","title":"止损单价","description":"*"},"takeProfit":{"type":"string","title":"止盈单价","description":"*"},"remark":{"type":"string","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":"数据体"}}}}},"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.CfdWBWOrderApiService.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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"*","format":"long"},"accountCurrency":{"type":"string","title":"账户货币","description":"*"},"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":"总利润","description":"*","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.PositionApiService.updateCrossLevelNum\ > \`\`\` ````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.PositionApiService.updateCrossLevelNum":{"post":{"summary":"设置仓位杠杆倍数","deprecated":false,"description":"```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.PositionApiService.updateCrossLevelNum\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":"本玩法下应填2","format":"long"},"symbolId":{"type":"integer","title":"产品ID","format":"long","description":"产品ID"},"requestTime":{"type":"integer","title":"杠杆倍数","format":"int32","description":"杠杆倍数"}},"required":["tradeType","requestTime","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.PositionApiService.updateOccupyTheMargin\ > \`\`\` ````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.PositionApiService.updateOccupyTheMargin":{"post":{"summary":"修改仓位占用保证金","deprecated":false,"description":"说明：合约-全仓玩法，设置客户对产品的杠杆倍数，影响该产品所有仓位\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.PositionApiService.updateOccupyTheMargin\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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","format":"long","description":"账户id"},"accountCurrency":{"type":"string","title":"账户货币","description":"账户币种"},"positionId":{"type":"integer","title":"仓位ID","description":"仓位id"},"accountDigits":{"type":"string","title":"账户小数位","description":"账户小数位"},"occupyTheMargin":{"type":"string","title":"修改占用保证金金额","description":"修改占用保证金金额，可以负数"},"orderId":{"type":"integer","title":"订单Id","description":"订单id"},"remark":{"type":"string","title":"备注","description":"备注"}},"required":["tradeType","accountId","accountDigits","occupyTheMargin","orderId","remark"]}}}},"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.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.PositionApiService.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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"*","format":"long"},"accountCurrency":{"type":"string","title":"账户货币","description":"*"},"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":"平仓数量","description":"*"},"openVolume":{"type":"string","title":"开仓手数","description":"*"},"closeVolume":{"type":"string","title":"平仓手数","description":"*"},"minVolume":{"type":"string","title":"单边最小手数","description":"*"},"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.OrderApiService.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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","format":"long","title":"账户ID","description":"账户id"},"size":{"type":"integer","title":"每页数据条数","format":"long","description":"每页数据条数"},"current":{"type":"integer","title":"当前页","format":"long","description":"当前页"},"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-减少；"}},"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":{}}}}}}} ```` ## 取消限价单（仅用于聚合模式） > 说明：取消限价单（仅用于聚合模式）\ > \ > \`\`\`\ > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.closeTradePboOrder\ > \`\`\` ````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.OrderApiService.closeTradePboOrder":{"post":{"summary":"取消限价单（仅用于聚合模式）","deprecated":false,"description":"说明：取消限价单（仅用于聚合模式）\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.closeTradePboOrder\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":"","description":"玩法ID，本玩法下应填2","format":"long"},"orderId":{"type":"integer","format":"int32","title":"","description":"订单id"}},"required":["tradeType","orderId"]}}}},"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":{"leftover":{"type":"string","description":"取消数量"}},"description":"数据体"}}}}},"headers":{}}}}}}} ```` ## 检查订单状态 > 说明：检查订单状态\ > \ > \`\`\`\ > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.checkOrderStatus\ > \`\`\` ````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.OrderApiService.checkOrderStatus":{"post":{"summary":"检查订单状态","deprecated":false,"description":"说明：检查订单状态\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.checkOrderStatus\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":"","description":"玩法ID，本玩法下应填2","format":"long"},"orderId":{"type":"integer","description":"订单id","format":"long","title":""},"operatorType":{"type":"integer","description":"1=调整杠杆倍数，2=调整保证金，3=订单是否成交","minimum":1,"maximum":2}},"required":["tradeType","orderId","operatorType"]}}}},"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":{},"description":"返回结果，operatorType=3时，0未成交1已成交"}}}}},"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.OrderApiService.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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"非必填。如填，已该账户进行交易","format":"long"},"bizType":{"type":"integer","title":"业务类型","description":"业务类型，1-市价开；2-市价平；10-限价预埋单；11-停损预埋单；13-聚合限价开仓单；14-聚合限价平仓单","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":"仅开仓有效，同个产品应仅有一个杠杆倍数"},"stopLoss":{"type":"number","title":"止损单价","description":"止损单价，需乘以10的`产品报价小数位`次方，处理为整数传入。","format":"double"},"takeProfit":{"type":"number","title":"止盈单价","description":"止盈单价，需乘以10的`产品报价小数位`次方，处理为整数传入。","format":"double"}},"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":"状态返回码","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"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"fee":{"type":"string","title":"手续费","description":"手续费"},"margin":{"type":"string","title":"保证金","description":"保证金"},"calculatePrice":{"type":"string","title":"计算价格","description":"计算价格"},"maintainMargin":{"type":"string","title":"维持保证金比例","description":"维持保证金比例"},"calculateNum":{"type":"string","title":"计算交易数量","description":"计算交易数量"},"evaluateProfit":{"type":"string","title":"预计盈利","description":"预计盈利。仅开仓并且`takeProfit`有填时有效"},"evaluateLoss":{"type":"string","title":"预计亏损","description":"预计亏损。仅开仓并且`stopLoss`有填时有效"},"evaluateClosePrice":{"type":"string","title":"预计强平价","description":"预计强平价。仅开仓有效"}},"title":"数据体","description":"数据体"}}}}},"headers":{}}}}}}} ```` ## 计算爆仓价格 > 说明：计算爆仓价格\ > \ > \`\`\`\ > group=tradeApi\ > version=0.0.1\ > bizType=tradeapi.app.OrderApiService.calculationBurstPrice\ > \`\`\` ````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.OrderApiService.calculationBurstPrice":{"post":{"summary":"计算爆仓价格","deprecated":false,"description":"说明：计算爆仓价格\n\n```\ngroup=tradeApi\nversion=0.0.1\nbizType=tradeapi.app.OrderApiService.calculationBurstPrice\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":"本玩法下应填2","format":"long"},"accountId":{"type":"integer","title":"账户ID","description":"非必填。","format":"long"},"positionId":{"type":"integer","title":"仓位ID","format":"long"},"adjustMargin":{"type":"number","title":"调整保证金","description":"正数为增加保证金金额；负数为减少保证金金额","format":"double"}},"required":["tradeType","adjustMargin","positionId"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码"},"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"},"fail":{"type":"boolean"},"data":{"type":"object","properties":{"evaluateClosePrice":{"type":"string","title":"预计强平价","description":"预计强平价"},"evaluateProfit":{"type":"string","title":"预计盈利","description":"预计盈利"},"evaluateLoss":{"type":"string","title":"预计亏损","description":"预计亏损"},"evaluateNetPnl":{"type":"string","title":"预计净盈亏","description":"预计净盈亏"}},"title":"数据体","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-zhu-cang-he-yue-jiao-yi.md?ask= ``` 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.