中國期貨業(yè)協(xié)會發(fā)布期貨公司柜臺系統(tǒng)管理接口標準第1部分：出入金接口Interfacestandardforfuturescompanymulti-countersystems—2025-09-05發(fā)布2025-09-05實施I 12規(guī)范性引用文件 13術語和定義 14通信機制 24.1接口與協(xié)議 24.2請求命名規(guī)范 24.3字段數(shù)據(jù)類型 34.4交互模式 34.5安全要求 64.6風險控制 65接口模式及接口清單 76出入金場景接口標準 76.1手工出入金 76.2查詢出入金 86.3查詢資金 96.4設置當日基礎保證金 6.5查詢當日基礎保證金 6.6設置轉(zhuǎn)賬限額 6.7查詢轉(zhuǎn)賬限額 6.8設置當日轉(zhuǎn)賬限額 6.9查詢當日轉(zhuǎn)賬限額 6.10設置當日可提資金比例 6.11查詢可提資金比例 6.12凍結(jié)資金新增 6.13查詢資金凍結(jié) 6.14資金解凍 7數(shù)據(jù)字典 7.1數(shù)據(jù)字典參考說明 7.2錯誤代碼數(shù)據(jù)字典 參考文獻 22Ⅱ本文件按照GB/T1.1—2020《標準化工作導則第一部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責任。本文件由中國期貨業(yè)協(xié)會提出并歸口。本文件起草單位：中國期貨業(yè)協(xié)會、中信期貨有限公司、海通期貨有限公司、國泰君安期貨有限公司、上海期貨信息技術有限公司、中金所數(shù)據(jù)有限公司、上海漢霖信息科技有限公司。本文件主要起草人：楊光、巫偉斐、王曦、艾青、張爭妍、余以志、何鐵軍、萬曉鷹、齊向明、張飛、王衛(wèi)新、徐茜如、周超、龔林、商亞龍。為有效提升市場運作效率，打破數(shù)據(jù)壁壘，為期貨公司開展數(shù)字化轉(zhuǎn)型創(chuàng)造條件，自2020年以來，在監(jiān)管部門指導下，中國期貨業(yè)協(xié)會已推動各期貨交易所和信息技術系統(tǒng)服務機構(gòu)開放了270余個信息技術系統(tǒng)接口。為貫徹《證券期貨業(yè)科技發(fā)展“十四五”規(guī)劃》,落實監(jiān)管部門指導意見，促進行業(yè)信息技術系統(tǒng)接口標準化建設，提升期貨公司業(yè)務辦理效率，降低人工操作風險，中國期貨業(yè)協(xié)會組織相關單位開展了本標準研制工作。本文件在期貨行業(yè)信息技術系統(tǒng)接口開放工作成果的基礎上，對柜臺系統(tǒng)出入金場景相關接口的數(shù)據(jù)交換方式、數(shù)據(jù)接口內(nèi)容進行了體系化、規(guī)范化的梳理與界定，供期貨公司及有關技術服務機構(gòu)參考1期貨公司柜臺系統(tǒng)管理接口標準第1部分：出入金接口凡是不注明日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。JR/T0160—2018期貨市場客戶開戶數(shù)2手工出入金manualwithdrawalandde手工出入金是指交易者通過手機銀行、網(wǎng)銀、銀行柜臺轉(zhuǎn)賬等方式劃款至期貨公司期貨保證金賬戶進行出入金的行為。資金調(diào)撥/資金同步fundtransfer資金調(diào)撥/資金同步是指交易者同時使用多套柜臺系統(tǒng)交易時，將其中一套系統(tǒng)中的可用資金調(diào)撥/同步至其他系統(tǒng)的行為。通信機制是指期貨柜臺系統(tǒng)外部接口與外部系統(tǒng)之間進行數(shù)據(jù)交換的方式。4通信機制4.1接口與協(xié)議RESTful是基于REST(RepresentationalStateTransfer)的架構(gòu)風格，通常使用HTTP、HTTPS協(xié)議進行數(shù)據(jù)交換，使用統(tǒng)一的URL來表示資源。RESTfulAPI是無狀態(tài)的，服務端可以更好地處理并發(fā)請求，提高系統(tǒng)的可擴展性，同時可以支持多種數(shù)據(jù)格式(如JSON、XML等),實現(xiàn)與各種客戶端的兼容。WebSocket是一種基于TCP的通信協(xié)議，旨在建立客戶端與服務端之間的實時雙向通信連接，實現(xiàn)實時數(shù)據(jù)傳輸。WebSocket允許服務端主動向客戶端推送數(shù)據(jù)，而不需要等待客戶端的請求。期貨交易、風控柜臺等實時系統(tǒng)與其交互系統(tǒng)之間進行實時數(shù)據(jù)交換和通訊，通常提供基于期貨交易數(shù)據(jù)交換協(xié)議(FuturesTradingDataExchangeProtocol,常包含兩類接口API和SPI實現(xiàn)對FTD協(xié)議的封裝，API接口主動發(fā)起請求，通過繼承SPI接口并重載回調(diào)函數(shù)來處理柜臺系統(tǒng)的響應或回報。此類API應符合JR/T0111—2014的要求。期貨柜臺系統(tǒng)接口與其他系統(tǒng)之間進行數(shù)據(jù)交換過程中常見的協(xié)議與接口方式包括RESTfulAPI、WebSocketAPI、C++API,本標準將主要基于HTTPS協(xié)議的RESTfulAPI進行具體說明。4.2請求命名規(guī)范采用如下URL格式：https://server-address[:port]/sub-system/resource/opsub-system提供服務的子系統(tǒng)，如CTPresource被訪問的資源，如費率3接口字段數(shù)據(jù)類型規(guī)定見表1。表1接口字段數(shù)據(jù)類型規(guī)定C字符串。交易者代碼，C12N數(shù)值型。若僅有一個參數(shù)時，如N(X),表示所定義的過X,如N(8),代表傳入整數(shù)長度不能超過8位；若有兩個參數(shù)，如N(X,Y),定義字段最大長度不能超過X,小數(shù)點后精度不能超過Y,如N(8,2),代表傳入數(shù)字長度不能超過8位(不含小數(shù)點),小數(shù)質(zhì)押金額，N(22,6)日期。交易日，20250408錯信息，返回時間相對可預期，一般情況下不會超時；寫入類請求在應答中返回一個唯一編號 1)請求-應答(同步)2)請求-應答(異步)先返回processID給調(diào)用方(代表本次業(yè)務請求的唯一消息識別碼),調(diào)用方可以通過processID跟蹤定44.4.2讀取類請求請求讀取柜臺數(shù)據(jù)(https)返回結(jié)果(https)圖1通信交互模式_讀取類請求讀取類請求見圖1,其步驟如下：1)客戶端發(fā)請求給服務端客戶端發(fā)起HTTPS請求，請求體中包含userID、userPassword、clientName、messageNo屬性，以及請求的具體內(nèi)容(如QryInvestorCommRate)。2)服務端返回應答讀取類的請求，應答都會包含processID、errorNo和errorInfo,以及查詢結(jié)果resultList。{"brokerId":"8888","investorID":"{"brokerId":"8888","investorID":54.4.3寫入類請求圖2通信交互模式_寫入類請求寫入類請求見圖2,其步驟如下：1)客戶端發(fā)起HTTPS請求，請求體中包含userID、userPassword、clientName、messageNo屬性，以及請求的具體內(nèi)容。這部分與讀取請求格式相同。2)服務端返回ProcessID給客戶端用于對上述請求結(jié)果的后續(xù)查詢。應答中會包含processID(唯一編號),errorNo(0為正確，非0為錯誤),和errorInfo(結(jié)果的文本描述)?；?)客戶端按需發(fā)起HTTPS結(jié)果查詢請求，用于查詢寫入類請求的柜臺處理結(jié)果。如無需要，可以不做查詢。https://server-address[:port]/CTP/CurrentStatu6查詢條件可以有多個，可以指定processID。服務端會根據(jù)userID和clien4)服務端將查詢結(jié)果返回給客戶端。各接口中的單一/批量發(fā)送標記指明對應消息對象的發(fā)送格式為單一發(fā)消息體僅允許發(fā)送一個消息對象至接收方；批量發(fā)送支持多個消息對象以list其中公共入?yún)總€接口都設有的userID(操作員ID)、userPassword(登錄密碼)、messageNo(消息編號)和clientName(客戶端名稱)。收到請求后，會驗證公共入?yún)⒅械膗serID和userPassword是否合法。參提供userID、userPassword,可以通過登錄請發(fā)起請求，每次請求可以達到安全驗證的目的，4.6風險控制7模式一：該模式請求數(shù)據(jù)后返回processId,出入金模式一CurrentInvestorBaseMargin/模式一Restriction/Create(或者Modify或者Delete)模式一TodayRestriction/Create(或者Modify或者Delete)模式一設置當日可提資金比例CurrInvestorWidrAlm/Create(或者Modify或者Delete)模式一查詢當日可提資金比例資金凍結(jié)新增模式一資金解凍模式一注：WidrA1m為WithdrawAlgorithm單詞縮寫業(yè)務場景1:期貨公司調(diào)用柜臺系統(tǒng)提供的手工出入金接口，將期貨公司自有管理類業(yè)務系統(tǒng)涉及業(yè)務場景2:期貨公司調(diào)用柜臺系統(tǒng)提供的出入金接口，可以實現(xiàn)異構(gòu)系統(tǒng)間資金同步、調(diào)撥，次接口名稱：手工出入金接口(接口標準見表3)表3出入金場景_手工出入金接口字段名中文名Y交易者代碼Y資金賬號Y8表3出入金場景_手工出入金接口(續(xù))字段名中文名票據(jù)號NY金同步、資金劃轉(zhuǎn)、資金內(nèi)轉(zhuǎn)等類型出入金方向YNN幣種交易編碼N交易者期貨結(jié)算賬戶N經(jīng)紀公司期貨結(jié)算賬戶N消息的唯一標識Y處理狀態(tài)Y處理結(jié)果Y接口名稱：查詢出入金接口(接口標準見表4)表4出入金場景_查詢出入金接口字段名中文名字段類型(長度)Y開始日期Y結(jié)束日期Y交易者代碼N資金賬號YN出入金方向消息的唯一標識Y處理狀態(tài)Y處理結(jié)果Y9表4出入金場景_查詢出入金接口(續(xù))字段名中文名字段類型(長度)交易日YY交易者代碼Y資金賬號Y票據(jù)號NN出入金方向YYNN幣種Y交易編碼ND交易者期貨結(jié)算賬戶N賬戶N接口名稱：查詢資金接口(接口標準見表5)字段名中文名字段類型(長度)Y結(jié)算日期Y交易者代碼Y資金賬號N幣種表5出入金場景_查詢資金接口(續(xù))字段名中文名字段類型(長度)處理狀態(tài)Y處理結(jié)果Y交易日YY資金賬號N幣種N昨日存款額N存款額(逐筆)N昨日存款額(逐筆)NNNN資金凍結(jié)NNNNN昨日質(zhì)押金額N出金金額NNNN昨日貨幣質(zhì)入金額N昨日貨幣質(zhì)出金額N貨幣質(zhì)押保證金占用N證金占用NN市值權(quán)益NNNNNN表5出入金場景_查詢資金接口(續(xù))字段名中文名字段類型(長度)NNNN當日盈虧NNNNNN交易手續(xù)費N交割手續(xù)費N結(jié)算手續(xù)費NNN履約手續(xù)費NNNN交易所交易手續(xù)費N交易所交割手續(xù)費N交易所結(jié)算手續(xù)費N交易所移倉手續(xù)費N交易所執(zhí)行手續(xù)費N交易所履約手續(xù)費NNN期權(quán)權(quán)利金支出NNNN特殊產(chǎn)品期權(quán)權(quán)利N業(yè)務場景：期貨公司調(diào)用柜臺系統(tǒng)接口設置當日交易者基礎保證金，管控交易接口名稱：設置當日基礎保證金接口(接口標準見表6)表6出入金場景_設置當日基礎保證金接口字段名中文名字段類型(長度)YYYN消息的唯一標識YY處理結(jié)果Y接口名稱：查詢當日基礎保證金接口(接口標準見表7)字段名中文名字段類型(長度)Y交易者代碼Y處理狀態(tài)Y處理結(jié)果Y結(jié)算日期YY當日基礎保證金NN交易者代碼N幣種NN操作時間N交易者名稱N6.6設置轉(zhuǎn)賬限額業(yè)務場景：期貨公司調(diào)用柜臺系統(tǒng)接口設置轉(zhuǎn)賬限額，實現(xiàn)自動化管理交易者銀期轉(zhuǎn)賬個性化需求。接口名稱：設置轉(zhuǎn)賬限額接口(接口標準見表8)表8出入金場景_設置轉(zhuǎn)賬限額接口字段名中文名字段類型(長度)Y資金賬號YNNNN銀期轉(zhuǎn)賬方向幣種N消息的唯一標識Y處理狀態(tài)Y處理結(jié)果Y6.7查詢轉(zhuǎn)賬限額業(yè)務場景：期貨公司調(diào)用柜臺系統(tǒng)接口為交易者提供轉(zhuǎn)賬限額查詢服務。接口名稱：查詢轉(zhuǎn)賬限額接口(接口標準見表9)表9出入金場景_查詢轉(zhuǎn)賬限額接口字段名中文名字段類型(長度)資金賬號YY銀期轉(zhuǎn)賬方向N幣種處理狀態(tài)Y處理結(jié)果Y表9出入金場景_查詢轉(zhuǎn)賬限額接口(續(xù))字段名中文名字段類型(長度)資金賬號YY交易者類型NNNNN銀期轉(zhuǎn)賬方向幣種NNN操作時間N交易者名稱N接口名稱：設置當日轉(zhuǎn)賬限額接口(接口標準見表10)字段名中文名字段類型(長度)Y資金賬號YNNNN銀期轉(zhuǎn)賬方向Y幣種YN消息的唯一標識Y表10出入金場景_設置當日轉(zhuǎn)賬限額接口(續(xù))字段名中文名字段類型(長度)處理狀態(tài)Y處理結(jié)果Y6.9查詢當日轉(zhuǎn)賬限額業(yè)務場景：期貨公司調(diào)用柜臺系統(tǒng)接口為交易者提供轉(zhuǎn)賬限額查詢服務。接口名稱：查詢當日轉(zhuǎn)賬限額接口(接口標準見表11)表11出入金場景_查詢當日轉(zhuǎn)賬限額接口字段名中文名字段類型(長度)資金賬號YY銀期轉(zhuǎn)賬方向N幣種處理狀態(tài)Y處理結(jié)果Y結(jié)算日期Y資金賬號YY交易者類型NNNNN銀期轉(zhuǎn)賬方向幣種NNN操作時間N交易者名稱N接口名稱：設置當日可提資金比例接口(接口標準見表12)表12出入金場景_設置當日可提資金比例接口字段名中文名字段類型(長度)Y交易者代碼Y資金賬號Y幣種Y可提資金比例YN消息的唯一標識Y處理狀態(tài)Y處理結(jié)果Y接口名稱：查詢可提資金比例接口(接口標準見表13)表13出入金場景_查詢當日可提資金比例接口字段名中文名字段類型(長度)交易者代碼Y結(jié)算日期YY資金賬號Y幣種處理狀態(tài)Y處理結(jié)果YY交易者代碼Y資金賬號Y表13出入金場景_查詢當日可提資金比例接口(續(xù))字段名中文名字段類型(長度)可提資金比例YY幣種YNN操作時間N交易者范圍交易者名稱N結(jié)算日期N接口名稱：資金凍結(jié)新增接口(接口標準見表14)表14出入金場景_凍結(jié)資金新增接口字段名中文名字段類型(長度)交易日N如果接口調(diào)用時未傳入此字段，則采用服務端系統(tǒng)默認交易日Y交易者代碼Y資金凍結(jié)Y入?yún)⑿∮?Y資金賬號YN幣種消息的唯一標識Y處理狀態(tài)Y處理結(jié)果Y6.13查詢資金凍結(jié)業(yè)務場景：期貨公司調(diào)用柜臺系統(tǒng)查詢資金凍結(jié)信息。接口名稱：查詢資金凍結(jié)接口(接口標準見表15)表15出入金場景_查詢資金凍結(jié)接口字段名中文名字段類型(長度)交易日N交易者代碼YY是否已復核N1-是，0-否幣種N1-已解凍；0-未解凍處理狀態(tài)Y處理結(jié)果Y結(jié)算日期YY交易者范圍交易者代碼Y是否已復核N資金凍結(jié)NN幣種資金賬號NNNN操作時間N復核員代碼N復合日期N復核時間N復核說明N表15出入金場景_查詢資金凍結(jié)接口(續(xù))字段名中文名字段類型(長度)N復核序列號NN原始序列號N接口名稱：資金解凍接口(接口標準見表16)表16出入金場景_資金解凍接口