行情实体结构参考：model.html

品种合约代码信息参考：symbols.html

编码信息查询：checkauth.html *期限信息、连接地址、次数消费编码信息里查询。*支持备用编码(主编码无法使用时候补)

范例代码：Web图表范例

阿里云切换对接只需更改apiurl根部分 "http://***.com" 为 "http://map.konpn.com:10002" ，以及更改appcode。(次数不能互用)

*注意：本站数据适用开发者数据分析和策略测试，无软件提供，接口使用禁止涉及违法业务。

.单个行情查询

查询单个品种合约行情，可以带出当前k线

调用演示

http://map.konpn.com:10002/query/com?symbol=SH600138&withticks=0&withks=0

调用协议

地址：http://map.konpn.com:10002/query/com (兼容旧版本 /localrm/query/com)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填,完整代码如SH600138，请参考品种合约代码信息查询*

参数：withticks,int,选填,是否带出最新交易分笔统计记录(默认0否，1是)

参数：withks,int,选填,是否带出当前k线数据(默认0否，1是输出，2输出更多)

输出：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,M3,M5,M10,M15,M30,H1,H2,H3,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://map.konpn.com:10002/query/comrms?symbols=SH600138,BTC,COMEXGC,USDJPY

股票需要查询50个请用 http://map.konpn.com:10002/query/comrmsvol

调用协议

地址：http://map.konpn.com:10002/query/comrms (兼容旧版本 /localrm/query/comrms)

地址：http://map.konpn.com:10002/query/comrmsvol

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：rout,string,选填,分类代码,comrmsvol必须填，参考(CNST,HKST)沪深,港股

参数：symbols,string,必填,多个完整代码逗号链接如SH600138,BTC,USDCNH

输出：json

结构：{"Code":1,"Msg":"","Obj":obj }

说明：Obj为输出行情实体数组，单个行情实体，行情实体结构参考

范例：{"Code":0,"Msg":"","Obj":[{行情1},{行情2},{行情3}]}

↑回顶部

.行情列表搜索查询

按分页查询品种合约行情，每页最多10个，股票(沪深,港股)可以50

调用演示

http://map.konpn.com:10002/query/comp?rout=GBDC&p=1&ps=10&market=&where=&sort=&sorttype=

股票需要查询50个请用 http://map.konpn.com:10002/query/compvol

调用协议

地址：http://map.konpn.com:10002/query/comp (兼容旧版本 /localrm/query/comp)

地址：http://map.konpn.com:10002/query/compvol

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：rout,string,选填,分类代码,compvol必须填,参考(CNST,USST,HKST,GBFSB,GBCFD,GBFT,CNFT,GBDC,GBIDX,CNCFD)沪深,美股,港股,外汇,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://map.konpn.com:10002/query/ticks?symbol=BTC

调用协议

地址：http://map.konpn.com:10002/query/ticks (兼容旧版本 /localrm/query/ticks)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码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://map.konpn.com:10002/query/comkmv2?symbol=BTC&period=D&pidx=1&psize=100&withlast=0&cnftwithps=0

http://map.konpn.com:10002/query/comkm?symbol=BTC&period=D&pidx=1&psize=100&withlast=0&cnftwithps=0

调用协议

地址：http://map.konpn.com:10002/query/comkmv2 (兼容旧版本 /localrm/query/comkmv2)

地址：http://map.konpn.com:10002/query/comkm(输出json)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填,完整代码如BTC

参数：period,string,必填,周期，支持1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,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://map.konpn.com:10002/query/comkmv2ex?symbol=BTC&period=D&fromtick=0&psize=100

http://map.konpn.com:10002/query/comkmex?symbol=BTC&period=D&fromtick=0&psize=100

调用协议

地址：http://map.konpn.com:10002/query/comkmv2ex (兼容旧版本 /localrm/query/comkmv2ex)

地址：http://map.konpn.com:10002/query/comkmex(输出json)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填,完整代码如BTC

参数：period,string,必填,周期，支持1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,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://map.konpn.com:10002/query/comkm4v2?symbol=BTC&period=D&date=2019-04-01&withlast=0

http://map.konpn.com:10002/query/comkm4?symbol=BTC&period=D&date=2019-04-01&withlast=0

调用协议

地址：http://map.konpn.com:10002/query/comkm4v2 (兼容旧版本 /localrm/query/comkm4v2)

地址：http://map.konpn.com:10002/query/comkm4(输出json)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填,完整代码如BTC

参数：period,string,必填,周期，支持1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,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,3H,4H,D,W,M

调用演示

http://map.konpn.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://map.konpn.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://map.konpn.com:10002/query/comkm2v2 (兼容旧版本 /localrm/query/comkm2v2)

地址：http://map.konpn.com:10002/query/comkm2(输出json)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填,完整代码如BTC

参数：period,string,必填,周期，支持1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,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线数据

排序是从fromtick开始到最新的k线，包含动态柱，最多20条，支持周期1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,W,M

调用演示

http://map.konpn.com:10002/query/comlstkmv2?symbol=BTC&period=D&fromtick=15

http://map.konpn.com:10002/query/comlstkm?symbol=BTC&period=D&fromtick=15

调用协议

地址：http://map.konpn.com:10002/query/comlstkmv2 (兼容旧版本 /localrm/query/comlstkmv2)

地址：http://map.konpn.com:10002/query/comlstkm(输出json)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填,完整代码如BTC

参数：period,string,必填,周期，支持1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,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":量},{}]}

↑回顶部

.品种合约代码查询

模糊查询品种合约代码，每页输出50个

调用演示

http://map.konpn.com:10002/query/symbols?rout=CNST&market=&keywords=&pidx=1&futmain=0

调用协议

地址：http://map.konpn.com:10002/query/symbols

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：rout,string,必填(rout和keywords比填其中之一),分类代码,参考(CNST,USST,HKST,GBFSB,GBCFD,GBFT,CNFT,GBDC,GBIDX)沪深,美股,港股,外汇,CFD,国际期货(指数/商品/外汇),国内期货,全球股指

参数：pidx,int,必填,页码，每页输出50

参数：futmain,int,选填,1只查询主力合约,0否（期货分类适用）

参数：market,string,选填,市场

参数：keywords,string,选填(rout和keywords比填其中之一),模糊关键字，拼音首字母/代码等

输出：json

结构：{"Code":10,"Msg":"","Obj":obj }

说明：Obj为输出数组，每条是一个json

说明：FullSymbol完整代码,Symbol代码,Name中文名,Market市场,LTD最后交易日(国际期货/ETF期权有效),Type类型参考(CNST,GBFSB,GBCFD,GBFT,CNFT,GBDC,GBIDX)股票,外汇,CFD,国际期货(指数/商品/外汇),国内期货,全球股

范例：{"Code":0,"Msg": "","Obj": [{"FullSymbol":"SH600082","Symbol":"600082","Name":"海泰发展","Market":"SH","Type":"CNST","LTD":"20190101"},{},{}]}

↑回顶部

.全球财经短讯

全球财经短讯，每页输出20个，从当前往历史方向排序，只保留最近3天的信息数据

调用演示

http://map.konpn.com:10002/query/qnews?types=1,2,9&pidx=1&ps=10

调用协议

地址：http://map.konpn.com:10002/query/qnews (兼容旧版本 /localrm/query/qnews)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码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},{},{}]}

↑回顶部

.股票信息数据

获取指定股票主要信息数据，包括报价，所属板块，资金流，财务信息等等，限沪深/港股/美股个股，该数据为统计数据10分钟更新一次

调用演示

http://map.konpn.com:10002/query/stinfo?symbol=SH600128

调用协议

地址：http://map.konpn.com:10002/query/stinfo (兼容旧版本 /localrm/query/stinfo)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填，股票代码,限沪深/港股/美股

输出：json

结构：{"Code":10,"Msg":"","Obj":obj }

说明：Obj为输出实体结构，股票信息数据输出字段参考

范例：{"Code":0,"Msg": "","Obj": {"M": "xxxxx","S": "XXXX","P": "1,9"}}

↑回顶部

.指标数据查询

获取指定合约某个周期的某个指标数据，返回最新10个

调用演示

http://map.konpn.com:10002/query/indicator?symbol=SH000001&period=D&indkey=MACD&args={"fastPeriod":"12","slowPeriod":"26","signalPeriod":"9"}

调用协议

地址：http://map.konpn.com:10002/query/indicator (兼容旧版本 /localrm/query/indicator)

协议：GET

认证：必填,设置请求头 "Authorization" = "APPCODE 编码Token" 或 "Authorization" = "编码Token"

参数：symbol,string,必填，合约代码

参数：period,string,必填，周期，支持1M,3M,5M,10M,15M,30M,1H,2H,3H,4H,D,W,M

参数：indkey,string,必填，指标。支持的指标这里查询 http://map.konpn.com:10002/query/indicatorlist

参数：args,string,必填，指标需要的参数，json的urlencode传入。具体参考指标信息 http://map.konpn.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://map.konpn.com:10002/query/com?symbol=EURUSD&token=密钥

↑回顶部

Http对接协议

.单个行情查询

.批量行情查询

.行情列表搜索查询

.单品种合约交易分笔统计记录查询

.历史k线-按分页

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

.历史k线-按时间段

.历史k线-按时间范围

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

.品种合约代码查询

.全球财经短讯

.股票信息数据

.指标数据查询

.输出结构

.K线实体结构参考

.其他 *密钥编码的传递