团 体 标 准
T/ZQX 0006.1—2025
期货公司柜台系统管理接口标准第 1 部分：出入金接口
Interface standard for futures company mult i-counter systems—
Part1: Fund data
2025 - 09 - 05 发布
2025 - 09 - 05 实施
中 国期 货 业协会 发布
目 次
前 言
本文件按照 GB/T 1.1—2020《标准化工作导则 第一部分 : 标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由中国期货业协会提出并归口。
本文件起草单位：中国期货业协会、中信期货有限公司、海通期货有限公司、国泰君安期货有限公司、上海期货信息技术有限公司、中金所数据有限公司、上海汉霖信息科技有限公司。
本文件主要起草人：杨光、巫伟斐、王曦、艾青、张争妍、余以志、何铁军、万晓鹰、齐向明、张飞、王卫新、徐茜如、周超、龚林、商亚龙。
引 言
为有效提升市场运作效率，打破数据壁垒，为期货公司开展数字化转型创造条件， 自2020年以来，在监管部门指导下，中国期货业协会已推动各期货交易所和信息技术系统服务机构开放了270余个信息技术系统接口。
为贯彻《证券期货业科技发展“十四五 ”规划》，落实监管部门指导意见，促进行业信息技术系统接口标准化建设，提升期货公司业务办理效率，降低人工操作风险，中国期货业协会组织相关单位开展了本标准研制工作。
本文件在期货行业信息技术系统接口开放工作成果的基础上，对柜台系统出入金场景相关接口的数据交换方式、数据接口内容进行了体系化、规范化的梳理与界定，供期货公司及有关技术服务机构参考使用。
期货公司柜台系统管理接口标准 第 1 部分：出入金接口
1 范围
本文件定义了期货公司内部系统间数据交换过程中的数据定义、数据内容和功能接口。
本文件适用于期货公司主次席柜台系统之间、主席柜台系统与其他系统之间的出入金数据交互场景。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注明日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
JR/T0111—2014 证券期货业数据通信协议应用指南
JR/T0151—2016 期货公司柜台系统数据接口规范
JR/T0160—2018 期货市场客户开户数据接口
JR/T0274—2023 证券期货业机构内部接口 账户管理
3 术语和定义
下列术语和定义适用于本文件。
3.1
柜台系统 over the counter system
期货公司柜台系统包括主席系统和次席系统，提供交易、清算、账户与资金、风控等功能。
[来源：JR/T 0151—2016，3.5]
3.2
出入金 withdrawal and deposit
出入金是指交易者通过其在银行开立的期货结算账户与期货公司开立的期货保证金账户之间划拨
资金的行为。其中，入金是指交易者将期货保证金从其期货结算账户划入期货公司期货保证金账户，期货公司增加交易者期货资金账户可用资金的行为;出金是指期货公司减少交易者期货资金账户可用资金，将期货保证金从期货公司期货保证金账户划入交易者期货结算账户的行为。
3.3
银期出入金 bank/futures withdrawal and deposit
银期出入金是指交易者在与期货公司和结算银行签署银期转账使用协议后，通过期货公司与结算银
行共同建立的银期转账系统划拨资金进行出入金的行为。
手工出入金 manual withdrawal and deposit
手工出入金是指交易者通过手机银行、网银、银行柜台转账等方式划款至期货公司期货保证金账户进行出入金的行为。
3.4
资金调拨/资金同步 fund transfer
资金调拨/资金同步是指交易者同时使用多套柜台系统交易时，将其中一套系统中的可用资金调拨/
同步至其他系统的行为。
3.5
通信机制 communication mechanism
通信机制是指期货柜台系统外部接口与外部系统之间进行数据交换的方式。
4 通信机制
4.1 接口与协议
4.1.1 RESTfu l API
RESTful是基于 REST(Representational State Transfer) 的架构风格，通常使用HTTP、HTTPS协议进行数据交换，使用统一的URL来表示资源。RESTful API是无状态的，服务端可以更好地处理并发请求，提高系统的可扩展性，同时可以支持多种数据格式(如JSON、XML等)，实现与各种客户端的兼容。
4.1.2 WebSocket API
WebSocket是一种基于TCP的通信协议，旨在建立客户端与服务端之间的实时双向通信连接，实现实时数据传输。WebSocket允许服务端主动向客户端推送数据，而不需要等待客户端的请求。
4.1.3 C++ API
期货交易、风控柜台等实时系统与其交互系统之间进行实时数据交换和通讯，通常提供基于期货交易数据交换协议(Futures Trading Data Exchange Protocol，FTD协议)的C++ API接口。C++ API通常包含两类接口API和SPI实现对FTD协议的封装，API接口主动发起请求，通过继承SPI接口并重载回调函数来处理柜台系统的响应或回报。此类API应符合JR/T 0111—2014的要求。
期货柜台系统接口与其他系统之间进行数据交换过程中常见的协议与接口方式包括RESTful API、 WebSocket API、C++ API，本标准将主要基于HTTPS协议的RESTful API进行具体说明。
4.2 请求命名规范
采用如下URL格式：
https://server-address [:port]/sub-system/resource/operation
其中，server-address[:port] 服务端地址及端口sub-system 提供服务的子系统，如CTP
resource 被访问的资源，如费率
operation 对资源的操作，如查询
示例：https://10.0.25.2:8443/ctp/commission-rate/query
在下文接口中，/resource/operation段信息以“URL后缀 ”展示在接口首行中。
4.3 字段数据类型
接口字段数据类型规定见表 1。
表 1 接口字段数据类型规定
4.4 交互模式
4.4.1 交互模式分类
客户端的请求有读取类、写入类等交互场景。其中，读取类请求直接在应答中返回读取的数据或出错信息 ，返回时 间相对可预期 ，一般情况下不会超时; 写入类请求在应答中返 回一个唯一编号(processID)，供请求方查询请求结果，返回时间不可预期，存在超时可能性，通信方式可以为异步，便于客户端和服务端系统解耦。对于消息的处理逻辑，messageNo作为消息的唯一标识，通过幂等控制机制，判断是否重发消息。
接口主要有两种交互模式，均由客户端发起：
1)请求-应答(同步)
客户端向服务端发起请求，服务端收到请求后进行处理，并将应答结果返回至客户端。客户端等待服务端的应答后，才可进行后续的工作。
例如：部分数据查询、写入的请求，接口调用方可以能够实时获取处理结果，可以采用同步的方式。
2)请求-应答(异步)
客户端向服务端发起请求，客户端无需等待服务端的应答，仍可继续处理其他事务，服务端收到请求后进行处理，并把应答结果返回给客户端。
例如：大数据量的写入请求，可以通过异步方式实现。由于接口调用方无法立即获取处理结果，会先返回processID给调用方(代表本次业务请求的唯一消息识别码)，调用方可以通过processID跟踪定位进行查询， 以确认本次业务是否处理成功。若失败，将收到失败原因。
通常情况下，上述两种交互模式的字符编码均采用UTF-8。
4.4.2 读取类请求
图 1 通信交互模式_读取类请求
读取类请求见图1，其步骤如下：
1)客户端发请求给服务端
客户端发起HTTPS请求，请求体中包含userID、userPassword、clientName、messageNo属性，以及请求的具体内容(如QryInvestorCommRate)。
示例：
{
"userID": "ctp-0001234",
"userPassword": "0659c7992e268962384eb17fafe88364",
"clientName": "CTP-mini2-#3",
"messageNo": "1",
"QryInvestorCommRate": {
"brokerID": "8888",
"investorRange": "1",
"investor ID": "00000000",
"investorUnitID": "00000000",
"exchangeID": "",
"instrumentID": "" }
}
2)服务端返回应答
读取类的请求，应答都会包含processID、errorNo和error Info，以及查询结果resultList。
示例：
{
"processID": "P00001",
"errorNo": 0,
"error Info": "查询成功",
"resultList": [
{"brokerId": "8888", "investor ID": "00001", "investUnitID:"00001", …},
{"brokerId": "8888", "investor ID": "00002", "investUnitID:"00002", …}, …
{"brokerId": "8888", "investor ID": "01001", "investUnitID:"01001", …} ]
}
4.4.3 写入类请求
图 2 通信交互模式_写入类请求
写入类请求见图2，其步骤如下：
1)客户端发起HTTPS请求，请求体中包含userID、userPassword、clientName、messageNo属性，以及请求的具体内容。这部分与读取请求格式相同。
2)服务端返回ProcessID给客户端用于对上述请求结果的后续查询。
应答中会包含processID(唯一编号)，errorNo(0为正确，非0为错误)，和error Info(结果的文本描述)。
示例：
"processID": "001293892",
"errorNo": 0,
"error Info": "请求被接受"
或
"processID": "",
"errorNo": -1,
"error Info": "操作员用户名或密码错误"
3)客户端按需发起HTTPS结果查询请求，用于查询写入类请求的柜台处理结果。如无需要，可以不做查询。
示例：
https://server-address[:port]/CTP/CurrentStatus/Query
{
"userID": "ctp-0001234",
"userPassword": "0659c7992e268962384eb17fafe88364",
"clientName": "CTP-mini2-#3",
"messageNo": "5",
"processIDs": [
{"processID": "68962384e"},
{"processID": "2341235"},
{"processID": "68962384f"} ]
}
查询条件可以有多个，可以指定processID。服务端会根据userID和clientName进行过滤，只返回该userID/clientName所发请求的结果。
4)服务端将查询结果返回给客户端。
4.4.4 单一/批量发送
各接口中的单一/批量发送标记指明对应消息对象的发送格式为单一发送或批量发送。单一发送的消息体仅允许发送一个消息对象至接收方;批量发送支持多个消息对象以list形式发送至接收方。
4.5 安全要求
4.5.1 传输安全
使用HTTPS协议加密，HTTPS通过SSL/TLS加密保证数据在传输过程中的机密性和完整性，防止数据被窃取、篡改或监听。同时，可以使用证书加强数据传输安全。
4.5.2 登录认证
对外提供的服务使用HTTPS协议，并支持服务端证书以防止中间人攻击。统一配置API的登录账户，并以此对请求方进行身份验证。外部系统客户端发起HTTPS请求，请求体中包含业务入参和公共入参。其中公共入参包含每个接口都设有的userID(操作员ID)、userPassword(登录密码)、messageNo(消息编号)和clientName(客户端名称)。收到请求后，会验证公共入参中的userID和userPassword是否合法。
除用户名与密码的方式，关于安全登录与认证模式也可以使用token的方式，该方式无需在公共入参提供userID、userPassword，可以通过登录请求接口获取token，其余业务接口要在header里填写token发起请求，每次请求可以达到安全验证的目的，但需考虑token方式有效期等因素的影响。
此外，服务端可以考虑增加客户端的IP白名单校验，仅允许白名单中的IP地址通过接口与服务端进行数据交互。
数据加密和数字签名所采用的技术方案由各方协商确定。
4.6 风险控制
4.6.1 审计
记录所有请求的访问账户、访问时间、访问接口、成功与否等信息。
4.6.2 限流
为保障系统资源的合理使用，避免因高频访问导致服务过载，可对来自同一IP地址、同一账户或同一接口的请求实施访问流量限制。管理端可灵活配置相关参数，例如设置同一IP地址每秒的访问次数上限，动态调整限流策略，确保服务的稳定性和可用性。
4.6.3 限制消息大小
对报文内容的大小做出限制，对超出限制的请求予以拒绝。如报文请求超过此限制，需要API调用者分成多个请求。
例如：客户端通过接口发送的消息体长度不得超过4M，超过4M服务端会进行报错并拦截。部分接口会结合消息长度限制给出服务端建议发送条数，超过此建议条数但消息体总大小小于4M的，服务端不会进行报错;超过此条数且消息体总大小超过4M，服务端会进行报错并拦截。
5 接口模式及接口清单
目前业务接口主要分为两种模式：
模式一：该模式请求数据后返回processId，在获取processId之后需要再次调用实时状态同步查询接口，获取接口状态;
模式二：该模式请求后直接返回响应数据，无需再次调用实时状态同步接口获取结果。
出入金场景接口清单及对应接口模型见表2。
表 2 出入金场景接口清单
6 出入金场景接口标准
6.1 手工出入金
业务场景1：期货公司调用柜台系统提供的手工出入金接口，将期货公司自有管理类业务系统涉及的手工出入金操作自动同步到柜台系统，主席柜台系统厂商需要提供该类型接口。
业务场景2：期货公司调用柜台系统提供的出入金接口，可以实现异构系统间资金同步、调拨，次席柜台系统厂商需要提供该类型接口。
接口名称：手工出入金接口(接口标准见表3)
URL后缀：InvestorFundChange/Create
表 3 出入金场景_手工出入金接口
表 3 出入金场景_手工出入金接口(续)
6.2 查询出入金
业务场景：期货公司调用柜台系统提供的查询出入金接口，可以实现异构次席柜台系统出入金结果的查询，次席柜台系统厂商需要提供该类型接口。
接口名称：查询出入金接口(接口标准见表4)
URL后缀：InvestorFundChange/Query
表 4 出入金场景_查询出入金接口
表 4 出入金场景_查询出入金接口(续)
6.3 查询资金
业务场景：期货公司可以通过调用柜台系统提供的查询资金接口，实现对交易者资金的业务查询，可支持查询主席柜台结算结果数据的资金、主席柜台盘中资金、异构柜台盘中资金等。
接口名称：查询资金接口(接口标准见表5)
URL后缀：InvestorFund/Query
表 5 出入金场景_查询资金接口
表 5 出入金场景_查询资金接口(续)
表 5 出入金场景_查询资金接口(续)
6.4 设置当日基础保证金
业务场景：期货公司调用柜台系统接口设置当日交易者基础保证金，管控交易者出金风险。
接口名称：设置当日基础保证金接口(接口标准见表6)
URL后缀：CurrentInvestorBaseMargin/Setting
表 6 出入金场景_设置当日基础保证金接口
6.5 查询当日基础保证金
业务场景：期货公司调用柜台系统接口查询当日交易者基础保证金信息。
接口名称：查询当日基础保证金接口(接口标准见表7)
URL后缀：TodayBaseMargin/Query
表 7 出入金场景_查询当日基础保证金接口
6.6 设置转账限额
业务场景：期货公司调用柜台系统接口设置转账限额，实现自动化管理交易者银期转账个性化需求。
接口名称：设置转账限额接口(接口标准见表8)
URL后缀：Restriction/Create(或者Modify或者Delete)
表 8 出入金场景_设置转账限额接口
6.7 查询转账限额
业务场景：期货公司调用柜台系统接口为交易者提供转账限额查询服务。
接口名称：查询转账限额接口(接口标准见表9)
URL后缀：Restriction/Query
表 9 出入金场景_查询转账限额接口
表 9 出入金场景_查询转账限额接口(续)
6.8 设置当日转账限额
业务场景：期货公司调用柜台系统接口设置当日转账限额，实现自动化管理交易者银期转账个性化需求。
接口名称：设置当日转账限额接口(接口标准见表10)
URL后缀：TodayRestriction/Create(或者Modify或者Delete)
表 10 出入金场景_设置当日转账限额接口
表 10 出入金场景_设置当日转账限额接口(续)
6.9 查询当日转账限额
业务场景：期货公司调用柜台系统接口为交易者提供转账限额查询服务。
接口名称：查询当日转账限额接口(接口标准见表11)
URL后缀：TodayRestriction/Query
表 11 出入金场景_查询当日转账限额接口
6.10 设置当日可提资金比例
业务场景：期货公司调用柜台系统接口设置交易者当日可提资金比例。
接口名称：设置当日可提资金比例接口(接口标准见表12)
URL后缀：CurrInvestorWidrAlm/Create(或者Modify或者Delete)
表 12 出入金场景_设置当日可提资金比例接口
6.11 查询可提资金比例
业务场景：期货公司调用柜台系统接口为交易者提供可提资金比例查询服务。
接口名称：查询可提资金比例接口(接口标准见表13)
URL后缀：CurrInvestorWidrAlm/Query
表 13 出入金场景_查询当日可提资金比例接口
表 13 出入金场景_查询当日可提资金比例接口(续)
6.12 冻结资金新增
业务场景：期货公司调用柜台系统提供的资金同步类接口，将期货公司管理类业务系统涉及的资金冻结操作自动同步到主席柜台系统，提高公司运营效率，降低管理成本和操作风险。在资金划转过程中需要冻结次席柜台系统盘中资金，以控制出金风险。
接口名称：资金冻结新增接口(接口标准见表14)
URL后缀：FundFrozen/Create
表 14 出入金场景_冻结资金新增接口
6.13 查询资金冻结
业务场景：期货公司调用柜台系统查询资金冻结信息。
接口名称：查询资金冻结接口(接口标准见表15)
URL后缀：FundFrozen/Query
表 15 出入金场景_查询资金冻结接口
表 15 出入金场景_查询资金冻结接口(续)
6.14 资金解冻
业务场景：期货公司调用柜台系统接口完成资金解冻。
接口名称：资金解冻接口(接口标准见表16)
URL后缀：FundFrozen/Repeal
表 16 出入金场景_资金解冻接口
7 数据字典
7.1 数据字典参考说明
本文件所用数据字典见表17。
表 17 数据字典参考说明
表 17 数据字典参考说明(续)
表 17 数据字典参考说明(续)
7.2 错误代码数据字典
本文件所用错误代码见表18。
表 18 错误代码数据字典
参 考 文 献
[1] JR/T 0016—2014 期货交易数据交换协议
[2] JR/T 0022—2014 证券交易数据交换协议
[3] JR/T 0046.1—2020 证券期货业与银行间业务数据交换协议 第1部分：三方存管、银期转
结售汇业务
[4] JR/T 0181—2020 期货合约要素
[5] JR/T 0248—2022 证券期货业机构内部接口 证券交易
评论