Http对接协议

不限合约,可查行情和历史。
单个行情查询批量行情查询行情列表搜索查询单品种合约交易明细查询
历史k线-按分页历史k线-从某个时间点取一页历史k线-按时间段历史k线-按时间范围历史k线-获取20个最新k线
全球财经短讯 股票信息数据指标数据查询
输出结构和错误代码K线实体结构参考密钥token的传递方式
行情实体结构参考:model.html
品种合约代码信息参考:symbols.html
编码信息查询:checkauth.html *期限信息,次数信息这里查询。*支持备用编码(主编码无法使用时候补)
范例代码:Web图表范例
阿里云切换对接只需更改apiurl根部分 "http://***.com" 为 "http://xxx.xxx.com:10002" ,以及更改appcode。(次数不能互用)
*注意:只保证接口数据正常输出,不提供软件系统,限个人开发者使用,接口使用禁止涉及违法业务。

.单个行情查询

查询单个品种合约行情,可以带出最新交易明细,可以带出当前k线
调用演示
http://xxx.xxx.com:10002/query/com?symbol=SH600138&withticks=0&withks=0
调用协议
地址:http://xxx.xxx.com:10002/query/com (兼容旧版本 /localrm/query/com)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token" ,( 字符串 "APPCODE" + 空格 + 您的编码 )
参数:symbol,string,必填,完整代码如SH600138,请参考品种合约代码信息查询*
参数:withticks,int,选填,是否带出最新交易明细(默认0否,1是)
参数:withks,int,选填,是否带出当前k线数据(默认0否,1是)
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为输出实体结构,行情实体结构参考
说明:Obj附加字段TS为输出最新5个交易明细字符串,每条分号分隔,每条内逗号分隔字段。如"tick1,price1,vol1,direction1;tick2,price2,vol2,direction2;时间戳3,价格3,量3,方向3"。方向0表示换1表示多-1表示空
说明:Obj附加字段M1,M5,M15,M30,H1,H4为输出当前k线数据,结构为字符串"Tick,O,H,L,V",表示时间戳,开,高,低,量,当前价即为收"
范例:{"Code":0,"Msg":"","Obj":{"TS":"1561417986,6.87330,2,0;1561417987,6.87330,2,0;1561418227,6.87340,1,1;1561418227,6.87340,2,0;1561418227,6.87352,1,1;1561418237,6.87349,1,-1;1561418239,6.87349,1,0;1561418246,6.87347,1,-1;1561418255,6.87346,1,-1;1561418261,6.87344,1,-1;1561418273,6.87341,1,-1;1561418279,6.87339,1,-1;1561418286,6.87360,1,1;1561418287,6.87350,3,-1;1561418347,6.87360,1,1","N":"美元/人民币","M":"","S":"USDCNH","C":"","FS":"USDCNH","P":6.87360,"NV":0,"Time":"\/Date(1561418347000-0000)\/","Tick":1561418347,"B1":6.87360,"B2":0,"B3":0,"B4":0,"B5":0,"B1V":0,"B2V":0,"B3V":0,"B4V":0,"B5V":0,"S1":6.87570,"S2":0,"S3":0,"S4":0,"S5":0,"S1V":0,"S2V":0,"S3V":0,"S4V":0,"S5V":0,"ZT":0,"DT":0,"O":6.87558,"H":6.87558,"L":6.87118,"YC":6.87432,"A":0,"V":369,"OV":0,"IV":0,"SY":0.000,"SJ":0,"HS":0,"ZS":0,"LS":0,"Z":0.00,"Z2":0.00,"VF":0.064,"ZF":-0.010,"JS":0,"YJS":0,"HD":0,"YHD":0,"AVP":0,"A1":""}}
↑回顶部

.批量行情查询

查询多个指定品种合约行情,最多10个,股票(沪深,港股,美股)可以50
调用演示
http://xxx.xxx.com:10002/query/comrms?symbols=SH600138,BTC,COMEXGC,USDJPY
股票需要查询50个请用 http://xxx.xxx.com:10002/query/comrmsvol
调用协议
地址:http://xxx.xxx.com:10002/query/comrms (兼容旧版本 /localrm/query/comrms)
地址:http://xxx.xxx.com:10002/query/comrmsvol
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:rout,string,选填,分类代码,comrmsvol必须填,参考(CNST,CNETF,USST,HKST)沪深,50ETF,美股,港股
参数:symbols,string,必填,多个完整代码逗号链接如SH600138,BTC,USDCNH
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为输出行情实体数组,单个行情实体,行情实体结构参考
范例:{"Code":0,"Msg":"","Obj":[{行情1},{行情2},{行情3}]}
↑回顶部

.行情列表搜索查询

按分页查询品种合约行情,每页最多10个,股票(沪深,港股,美股)可以50
调用演示
http://xxx.xxx.com:10002/query/comp?rout=GBDC&p=1&ps=10&market=&where=&sort=&sorttype=
股票需要查询50个请用 http://xxx.xxx.com:10002/query/compvol
调用协议
地址:http://xxx.xxx.com:10002/query/comp (兼容旧版本 /localrm/query/comp)
地址:http://xxx.xxx.com:10002/query/compvol
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:rout,string,选填,分类代码,compvol必须填,参考(CNST,CNETF,USST,HKST,GBFSB,GBCFD,GBFT,CNFT,GBDC,GBIDX,SPOT)沪深,50ETF,美股,港股,外汇,CFD,欧美海外期货(指数/商品/外汇),国内期货,全球股指,现货
参数:p,int,必填,页码
参数:ps,int,必填,页大小
参数:market,string,选填,市场
参数:where,string,选填,模糊关键字,拼音首字母/代码等,where和rout必须填其中一个
参数:sort,string,选填,排序字段,行情实体结构参考*
参数:sorttype,int,选填,0升序,1降序
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为输出行情实体数组,单个行情实体结构
范例:{"Code":0,"Msg":"","Obj":[{行情1},{行情2},{行情3}]}
↑回顶部

.单品种合约交易明细查询

查询指定品种合约交易明细,最多保留最新50个
调用演示
http://xxx.xxx.com:10002/query/ticks?symbol=BTC
调用协议
地址:http://xxx.xxx.com:10002/query/ticks (兼容旧版本 /localrm/query/ticks)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,完整代码,如BTC
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为输出明细数组,每条明细是一个字符串,字段用逗号分隔。方向0表示换,1多,-1空
范例:{"Code": 0,"Msg": "","Obj": ["时间戳,价格,量,方向","时间戳,价格,量,方向"...]}
↑回顶部

.历史k线-按分页

排序是从当前往历史方向排,第一页是当前处,可包含最新动态k线数据。接口输出的日周期数据最多最近10年,1分钟周期数据最多最近30天,5分钟及小时周期最多最近180天
调用演示
http://xxx.xxx.com:10002/query/comkmv2?symbol=BTC&period=D&pidx=1&psize=100&withlast=0&cnftwithps=0
http://xxx.xxx.com:10002/query/comkm?symbol=BTC&period=D&pidx=1&psize=100&withlast=0&cnftwithps=0
调用协议
地址:http://xxx.xxx.com:10002/query/comkmv2 (兼容旧版本 /localrm/query/comkmv2)
地址:http://xxx.xxx.com:10002/query/comkm(输出json)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,完整代码如BTC
参数:period,string,必填,周期,支持1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
参数:pidx,int,必填,页码
参数:psize,int,必填,页大小,每页最多500个数据
参数:withlast,int,选填,是否带出当前动态k线数据(默认0否,1是),第一页有效
参数:cnftwithps,int,选填,是否带出结算价和持仓量(默认0否,1是),期货合约+日周期 有效
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为字符串,用分号;分隔为k数组,k数据的字段用逗号,分隔
范例:{"Code": 0,"Msg": "","Obj": "秒时间戳Tick1,收1,开1,高1,低1,额1,量1;秒时间戳Tick2,收2,开2,高2,低2,额2,量2;..."},k数据均价可以用 额/量 计算出,当cnftwithps=1有效时为 "秒时间戳Tick1,收1,开1,高1,低1,额1,量1,结算1,持仓1;..."
旧版本(*效率较差)comkm范例:{"Code": 0,"Msg": "","Obj": [{"C":收,"Tick":秒时间戳,"D":日期,"O":开,"H":高,"L":低,"A":额,"V":量},{}]},当cnftwithps=1有效时为 {"C":收,"Tick":秒时间戳,"D":日期,"O":开,"H":高,"L":低,"A":额,"V":量,"P":持仓量,"S":结算价}
↑回顶部

.历史k线-从某个时间点取一页

排序是从指定tick往历史方向排,取一页数据,如果tick是当前时间可包含最新动态k线数据。接口输出的日周期数据最多最近10年,1分钟周期数据最多最近30天,5分钟及小时周期最多最近180天
调用演示
http://xxx.xxx.com:10002/query/comkmv2ex?symbol=BTC&period=D&fromtick=0&psize=100
http://xxx.xxx.com:10002/query/comkmex?symbol=BTC&period=D&fromtick=0&psize=100
调用协议
地址:http://xxx.xxx.com:10002/query/comkmv2ex (兼容旧版本 /localrm/query/comkmv2ex)
地址:http://xxx.xxx.com:10002/query/comkmex(输出json)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,完整代码如BTC
参数:period,string,必填,周期,支持1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
参数:fromtick,long,必填,秒时间戳,锚定时间终点,如果填0则锚定当前时间,如果填1则锚定当前时间并带出动态k数据
参数:psize,int,必填,页大小,每页最多500个数据
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为字符串,用分号;分隔为k数组,k数据的字段用逗号,分隔
范例:{"Code": 0,"Msg": "","Obj": "秒时间戳Tick1,收1,开1,高1,低1,额1,量1;秒时间戳Tick2,收2,开2,高2,低2,额2,量2;..."},k数据均价可以用 额/量 计算出
旧版本(*效率较差)comkm范例:{"Code": 0,"Msg": "","Obj": [{"C":收,"Tick":秒时间戳,"D":日期,"O":开,"H":高,"L":低,"A":额,"V":量},{}]}
↑回顶部

.历史k线-按时间段

排序是从开始时间往结束时间方向排。接口输出的日周期数据最多最近10年,1分钟周期数据最多最近30天,5分钟及小时周期最多最近180天
周期是1,5,15分钟则返回date当日的数据。 周期是30分钟或1小时则返回date当日及前2日的数据。 周期是4小时则返回date当日及前9日的数据。 周期是日则返回date当月及前2个月的数据
调用演示
http://xxx.xxx.com:10002/query/comkm4v2?symbol=BTC&period=D&date=2019-04-01&withlast=0
http://xxx.xxx.com:10002/query/comkm4?symbol=BTC&period=D&date=2019-04-01&withlast=0
调用协议
地址:http://xxx.xxx.com:10002/query/comkm4v2 (兼容旧版本 /localrm/query/comkm4v2)
地址:http://xxx.xxx.com:10002/query/comkm4(输出json)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,完整代码如BTC
参数:period,string,必填,周期,支持1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
参数:date,string,必填,指定日期
参数:withlast,int,选填,是否带出当前动态k线数据(默认0否,1是)
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为字符串,用分号;分隔为k数组,k数据的字段用逗号,分隔
范例:{"Code": 0,"Msg": "","Obj": "秒时间戳Tick1,收1,开1,高1,低1,额1,量1;秒时间戳Tick2,收2,开2,高2,低2,额2,量2;..."},k数据均价可以用 额/量 计算出
旧版本(*效率较差)comkm4范例:{"Code": 0,"Msg": "","Obj": [{"C":收,"Tick":秒时间戳,"D":日期,"O":开,"H":高,"L":低,"A":额,"V":量},{}]}
↑回顶部

.历史k线-按时间范围

排序是从开始时间往结束时间方向排。接口输出的日周期数据最多最近10年,1分钟周期数据最多最近30天,5分钟及小时周期最多最近180天
每次最多跨500单位周期,支持周期1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
调用演示
http://xxx.xxx.com:10002/query/comkm2v2?symbol=BTC&period=D&datest=2019-05-01 12:00:00&dateed=2019-05-02 12:00:00&withlast=0
http://xxx.xxx.com:10002/query/comkm2?symbol=BTC&period=D&datest=2019-05-01 12:00:00&dateed=2019-05-02 12:00:00&withlast=0
调用协议
地址:http://xxx.xxx.com:10002/query/comkm2v2 (兼容旧版本 /localrm/query/comkm2v2)
地址:http://xxx.xxx.com:10002/query/comkm2(输出json)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,完整代码如BTC
参数:period,string,必填,周期,支持1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
参数:datest,string,必填,开始时间
参数:dateed,string,必填,结束时间
参数:withlast,int,选填,是否带出当前动态k线数据(默认0否,1是),dateed大于等于当前时间时有效
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为字符串,用分号;分隔为k数组,k数据的字段用逗号,分隔
范例:{"Code": 0,"Msg": "","Obj": "秒时间戳Tick1,收1,开1,高1,低1,额1,量1;秒时间戳Tick2,收2,开2,高2,低2,额2,量2;..."},k数据均价可以用 额/量 计算出
旧版本(*效率较差)comkm2范例:{"Code": 0,"Msg": "","Obj": [{"C":收,"Tick":秒时间戳,"D":日期,"O":开,"H":高,"L":低,"A":额,"V":量},{}]}
↑回顶部

.历史k线-获取最新20个k线数据

排序是从fromticks开始到最新的k线,包含动态柱,最多20条,支持周期1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
调用演示
http://xxx.xxx.com:10002/query/comlstkmv2?symbol=BTC&period=D&fromtick=15
http://xxx.xxx.com:10002/query/comlstkm?symbol=BTC&period=D&fromtick=15
调用协议
地址:http://xxx.xxx.com:10002/query/comlstkmv2 (兼容旧版本 /localrm/query/comlstkmv2)
地址:http://xxx.xxx.com:10002/query/comlstkm(输出json)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,完整代码如BTC
参数:period,string,必填,周期,支持1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
参数:fromtick,long,必填,开始时间戳
输出:json
结构:{"Code":1,"Msg":"","Obj":obj }
说明:Obj为字符串,用分号;分隔为k数组,k数据的字段用逗号,分隔
范例:{"Code": 0,"Msg": "","Obj": "秒时间戳Tick1,收1,开1,高1,低1,额1,量1;秒时间戳Tick2,收2,开2,高2,低2,额2,量2;..."}
旧版本(*效率较差)comlstkm范例:{"Code": 0,"Msg": "","Obj": [{"C":收,"Tick":秒时间戳,"D":日期,"O":开,"H":高,"L":低,"A":额,"V":量},{}]}
↑回顶部

.全球财经短讯

全球财经短讯,每页输出20个,从当前往历史方向排序,只保留最近3天的信息数据
调用演示
http://xxx.xxx.com:10002/query/qnews?types=1,2,9&pidx=1&ps=10
调用协议
地址:http://xxx.xxx.com:10002/query/qnews (兼容旧版本 /localrm/query/qnews)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:types,string,选填,分类,逗号分割(1宏观/2行业/3公司/4数据/5市场/6观点/7央行/8其他/9全球/10A股)
参数:pidx,int,必填,页码
参数:ps,int,必填,页大小
输出:json
结构:{"Code":10,"Msg":"","Obj":obj }
说明:Obj为输出数组,每条是一个json
说明:C详细内容,T发布时间,TG分类(1宏观/2行业/3公司/4数据/5市场/6观点/7央行/8其他/9全球/10A股),ID编号
范例:{"Code":0,"Msg": "","Obj": [{"C": "xxxxx","T": "2018-10-12 12:00:20","TG": "1,9","ID": 148293394},{},{}]}
↑回顶部

.股票信息数据

获取指定股票主要信息数据,包括报价,所属板块,资金流,财务信息等等,限沪深/港股/美股
调用演示
http://xxx.xxx.com:10002/query/stinfo?symbol=SH600128
调用协议
地址:http://xxx.xxx.com:10002/query/stinfo (兼容旧版本 /localrm/query/stinfo)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,股票代码,限沪深/港股/美股
输出:json
结构:{"Code":10,"Msg":"","Obj":obj }
说明:Obj为输出实体结构,实体结构参考
范例:{"Code":0,"Msg": "","Obj": {"M": "xxxxx","S": "XXXX","P": "1,9"}}
↑回顶部

.指标数据查询

获取指定合约某个周期的某个指标数据,返回最新10个
调用演示
http://xxx.xxx.com:10002/query/indicator?symbol=SH000001&period=D&indkey=MACD&args={"fastPeriod":"12","slowPeriod":"26","signalPeriod":"9"}
调用协议
地址:http://xxx.xxx.com:10002/query/indicator (兼容旧版本 /localrm/query/indicator)
协议:GET
认证:必填,设置请求头 "Authorization" = "APPCODE 编码Token"
参数:symbol,string,必填,合约代码
参数:period,string,必填,周期,支持1M,3M,5M,10M,15M,30M,1H,2H,4H,D,W,M。部分品种无W,M
参数:indkey,string,必填,指标。支持的指标这里查询 http://xxx.xxx.com:10002/query/indicatorlist
参数:args,string,必填,指标需要的参数,json的urlencode传入。具体参考指标信息 http://xxx.xxx.com:10002/query/indicatorget?indkey=macd/*指标*/ 输出的数据
输出:json
结构:输出为各指标的数据,并不统一格式
↑回顶部

.输出结构

结构
{"Code":1,"Msg":"","Obj":任意类型 }
说明
Code >= 0,调用成功,Obj是json数组或对象,是否有数据要看输出;如果Obj是数组,则Code代表结果总条数
Code <0 表示调用失败,并输出错误信息 Msg 失败提示
Code=-100 ~ -199,参数错误
Code=-200 ~ -299,内部错误
Code=-300 ~ ,内部错误
Code=-900 ~ ,异常
↑回顶部

.K线实体结构参考

C:--收盘价
Tick:--标准时间戳
O:--开盘价
H:--最高
L:--最低
A:--交易额
V:--交易量
D:--日期时间
P:--持仓量(CN期货+日周期 有效)
S:--结算价(CN期货+日周期 有效)
↑回顶部

.其他

编码token也可以通过get参数传递,get设置的token优先httpheader设置的token
比如在浏览器里直接测试 http://xxx.xxx.com:10002/query/com?symbol=EURUSD&token=密钥
↑回顶部