第1页 / 共132页
第2页 / 共132页
第3页 / 共132页
第4页 / 共132页
第5页 / 共132页
第6页 / 共132页
第7页 / 共132页
第8页 / 共132页
综合交易平台TraderAPI接口说明.pdf
交易托管系统
交
易
员
应
用
程
序
接
口
2008 年 8 月
交易托管系统
TradeAPI 接口
1. 文件属性
文件属性
文件名称
文件编号
文件版本号
文件状态
作 者
内容
交易托管系统_ TradeAPI 接口
V0.1
草稿
上海期货信息技术有限公司
文档编写日期
2008-8-25
文档发布日期
2. 文件变更历史清单
文件版本号
修正日期
修正人
备 注
1.1
2008-1-11
托管平台开发组
1、增加银期转账接口
1.1.1
2008-1-29
托管平台开发组
1、 增加查询客户通知功
2、增加接收合约状态接
口
1.2
2008-3-4
托管平台开发组
1.3
2008-5-23
托管平台开发组
能；
1、 增加查询历史结算单
的功能（使用查询结
算单接口）。
2、 增加查询结算确认接
口。
3、 修改资金密码修改接
口。
4、 删除行情接口中查询
深度行情的接口 ，交
易接口中的 深度行情
查询可以使用。
5、 增加行情客户 端开发
示例。
1、 持仓记录中增加 了三
个字段，查询需要做
处理。
2、 持仓明细中增加 了两
个字段查询需要做处
版权所有©上海期货信息技术有限公司 第 1 页，共 132 页
交易托管系统
TradeAPI 接口
理。
3、 根据 OrderRef 撤单的
接口增加了合约代码
字段。
4、 允许客户报套利 单，
套利单的价格可以为
0 或者负数，这在单一
报单是不允许 的，需
要客户端处理。
5 、 转 帐 报 文 头 中增 加
RequestID 字段，需要填
写 ， 内 容 与 API 中 的
RequestID 相同，用于支
持异步交易的处理。
2.1.2a
2008-7-28
托管平台开发组 在 CThostFtdcTraderApi
接口中增加了 16 种方法：
资金账户口令更新请求、
查询最大报单数量、投资
者结算结果确认、请求银
行资金转期货、请求期货
资金转银行、请求查询银
行资金、请求查询银行交
易明细、请求查询资金账
户、请求查询交易编码、
请求查询交易所、请求查
询合约、请求查询行情、
请求查 询投资者结算结
果、请求查询转帐银行、
请求查 询投资 者持仓明
细、请求查询客户、请求
查询签约银行通知。
在 CThostFtdcTraderSpi
接口中增加 了对以上 16
中方法的响应方法。
版权所有©上海期货信息技术有限公司 第 2 页，共 132 页
交易托管系统
TradeAPI 接口
2.1.2a
2008-8-25
托管平台开发组 将
总共新增 32 个方法。
CThostFtdcTransferQry
DetailReqField
的
TradeCode 从 214008 更新
为 204999。
在 CThostFtdcTraderApi
接口中增加了 7 种方法：
请求查询预埋单、请求查
询预埋撤单、请求查询投
资者持仓明细、预埋单录
入请求、预埋撤单录入请
求、请求删除预埋单、请
求删除预埋撤单。
在 CThostFtdcTraderSpi
接口中增加了对以上 7 种
方法的响应方法。
3. 本次修改变更说明
序号
变更内容简述
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
版权所有©上海期货信息技术有限公司 第 3 页，共 132 页
交易托管系统
TradeAPI 接口
12.
13.
版权所有©上海期货信息技术有限公司 第 4 页，共 132 页
交易托管系统
目 录
TradeAPI 接口
2.1.
2.2.
3.1.
3.2.
4.1.
4.2.
6.1.
6.2.
6.3.
6.4.
1. 介绍 ..........................................................................................................................................8
2. 体系结构 ..................................................................................................................................1
通讯模式...................................................................................................................1
数据流.......................................................................................................................2
3. 接口模式 ..................................................................................................................................1
对话流和查询流编程接口.......................................................................................1
私有流编程接口.......................................................................................................2
4. 运行模式 ..................................................................................................................................2
工作线程...................................................................................................................2
本地文件...................................................................................................................3
5. 业务与接口对照.......................................................................................................................4
6. 开发接口 ..................................................................................................................................5
通用规则...................................................................................................................5
托管服务地址设置要求...........................................................................................5
经纪公司代码设置要求...........................................................................................5
CThostFtdcTraderSpi 接口.......................................................................................5
6.4.1.
OnFrontConnected 方法 ..................................................................................6
6.4.2.
OnFrontDisconnected 方法 .............................................................................6
6.4.3.
OnHeartBeatWarning 方法 ...............................................................................6
6.4.4.
OnRspUserLogin 方法......................................................................................7
6.4.5.
OnRspUserLogout 方法...................................................................................8
6.4.6.
OnRspUserPasswordUpdate 方法 ...................................................................9
6.4.7.
OnRspTradingAccountPasswordUpdate 方法................................................10
6.4.8.
OnRspError 方法 ...........................................................................................11
6.4.9.
OnRspOrderInsert 方法 .................................................................................11
6.4.10. OnRspOrderAction 方法 ...............................................................................13
6.4.11. OnRspQueryMaxOrderVolume方法..............................................................15
6.4.12. OnRspSettlementInfoConfirm 方法 ...............................................................16
6.4.13. OnRspTransferBankToFuture方法 ................................................................17
6.4.14. OnRspTransferFutureToBank方法 ................................................................18
6.4.15. OnRspTransferQryBank 方法.........................................................................19
6.4.16. OnRspTransferQryDetail 方法 .......................................................................20
6.4.17. OnRspQryOrder 方法 ....................................................................................22
6.4.18. OnRspQryTrade 方法 ....................................................................................25
6.4.19. OnRspQryInvestor 方法 ................................................................................27
6.4.20. OnRspQryInvestorPosition 方法 ...................................................................28
6.4.21. OnRspQryTradingAccount 方法 ....................................................................30
6.4.22. OnRspQryTradingCode 方法.........................................................................33
6.4.23. OnRspQryExchange 方法...............................................................................34
6.4.24. OnRspQryInstrument 方法 .............................................................................35
6.4.25. OnRspQryDepthMarketData 方法..................................................................38
6.4.26. OnRspQrySettlementInfo 方法.......................................................................42
版权所有©上海期货信息技术有限公司 第 5 页，共 132 页
交易托管系统
TradeAPI 接口
6.5.
6.4.27. OnRspQryTransferBank 方法.........................................................................43
6.4.28. OnRspQryInvestorPositionDetail 方法...........................................................44
6.4.29. OnRspQryNotice 方法....................................................................................46
6.4.30. OnRspQryInstrument 方法 ............................................................................47
6.4.31. OnRtnTrade 方法...........................................................................................49
6.4.32. OnRtnOrder 方法...........................................................................................50
6.4.33. OnErrRtnOrderInsert 方法..............................................................................53
6.4.34. OnErrRtnOrderAction 方法............................................................................55
6.4.35. OnRspQrySettlementInfoConfirm 方法 .........................................................56
6.4.36. OnRspQryContractBank 方法 ........................................................................57
6.4.37. RspQryParkedOrder 方法...............................................................................58
6.4.38. RspQryParkedOrderAction 方法 ....................................................................60
6.4.39. RspQryInvestorPositionCombineDetail 方法.................................................61
6.4.40. RspParkedOrderInsert 方法 ............................................................................63
6.4.41. RspParkedOrderAction 方法 ..........................................................................65
6.4.42. RspRemoveParkedOrder 方法........................................................................66
6.4.43. RspRemoveParkedOrderAction 方法 .............................................................67
CThostFtdcTraderApi 接口 ....................................................................................68
6.5.1.
CreateFtdcTraderApi 方法..............................................................................68
6.5.2.
Release 方法 ..................................................................................................68
6.5.3.
Init 方法 .........................................................................................................69
6.5.4.
Join 方法........................................................................................................69
6.5.5.
GetTradingDay 方法.......................................................................................69
6.5.6.
RegisterSpi 方法 ............................................................................................69
6.5.7.
RegisterFront 方法.........................................................................................70
6.5.8.
SubscribePrivateTopic 方法............................................................................70
6.5.9.
SubscribePublicTopic 方法.............................................................................70
6.5.10. ReqUserLogin 方法 .......................................................................................71
6.5.11. ReqUserLogout 方法 .....................................................................................72
6.5.12. ReqUserPasswordUpdate 方法......................................................................73
6.5.13. ReqTradingAccountPasswordUpdate 方法.....................................................73
6.5.14. ReqOrderInsert 方法......................................................................................74
6.5.15. ReqOrderAction 方法 ....................................................................................76
6.5.16. ReqQueryMaxOrderVolume方法 ..................................................................78
6.5.17. ReqSettlementInfoConfirm 方法 ....................................................................79
6.5.18. ReqTransferBankToFuture方法.....................................................................80
6.5.19. ReqTransferFutureToBank方法.....................................................................81
6.5.20. ReqTransferQryBank 方法 .............................................................................83
6.5.21. ReqTransferQryDetail 方法............................................................................85
6.5.22. ReqQryOrder 方法.........................................................................................86
6.5.23. ReqQryTrade 方法.........................................................................................87
6.5.24. ReqQry Investor 方法....................................................................................88
6.5.25. ReqQryInvestorPosition 方法........................................................................88
6.5.26. ReqQryTradingAccount 方法 .........................................................................89
版权所有©上海期货信息技术有限公司 第 6 页，共 132 页
交易托管系统
TradeAPI 接口
6.5.27. ReqQryTradingCode 方法 ..............................................................................90
6.5.28. ReqQryExchange 方法 ...................................................................................91
6.5.29. ReqQryInstrument 方法..................................................................................92
6.5.30. ReqQryDepthMarketData 方法 ......................................................................92
6.5.31. ReqQrySettlementInfo 方法 ...........................................................................93
6.5.32. ReqQryTransferBank 方法 .............................................................................94
6.5.33. ReqQryInvestorPositionDetail 方法 ...............................................................95
6.5.34. ReqQryNotice 方法 ........................................................................................96
6.5.35. ReqQrySettlementInfoConfirm 方法..............................................................96
6.5.36. ReqQryContractBank 方法.............................................................................97
6.5.37. ReqQryParkedOrder 方法...............................................................................98
6.5.38. ReqQryParkedOrderAction 方法....................................................................99
6.5.39. ReqQryInvestorPositionCombineDetail 方法...............................................100
6.5.40. ReqParkedOrderInsert 方法..........................................................................101
6.5.41. ReqParkedOrderAction 方法 ........................................................................103
6.5.42. ReqRemoveParkedOrder 方法......................................................................105
6.5.43. ReqRemoveParkedOrderAction 方法...........................................................106
7. 开发示例 ..............................................................................................................................107
7.1 交易 API 开发示例 ................................................................................................107
7.2 行情 API 开发示例 ................................................................................................116
版权所有©上海期货信息技术有限公司 第 7 页，共 132 页
相关推荐
2023年江西萍乡中考道德与法治真题及答案.doc
2012年重庆南川中考生物真题及答案.doc
2013年江西师范大学地理学综合及文艺理论基础考研真题.doc
2020年四川甘孜小升初语文真题及答案I卷.doc
2020年注册岩土工程师专业基础考试真题及答案.doc
2023-2024学年福建省厦门市九年级上学期数学月考试题及答案.doc
2021-2022学年辽宁省沈阳市大东区九年级上学期语文期末试题及答案.doc
2022-2023学年北京东城区初三第一学期物理期末试卷及答案.doc
2018上半年江西教师资格初中地理学科知识与教学能力真题及答案.doc
2012年河北国家公务员申论考试真题及答案-省级.doc
2020-2021学年江苏省扬州市江都区邵樊片九年级上学期数学第一次质量检测试题及答案.doc
2022下半年黑龙江教师资格证中学综合素质真题及答案.doc
