升级公告

1. 接入中金所L1实时行情数据，如需使用请联系您的客户经理
2. 流量查询函数返回字段新增【套餐名称】【套餐有效期】字段
3. 其他bug修复

目录

接口配置

接口配置

文件存放位置

在量化接口官网（https://quantapi.eastmoney.com/）下载压缩包EMQuantAPI_MATLAB.zip,下载完成后解压。其中：

• EmQuantMatlab.m是一个Matlab文件，提供了EmQuantAPI的各个接口；
• EmQuantAPI.dll和EmQuantAPI_x64.dll是EmQuantAPI的动态库文件；
• ServerList.json.e是服务器配置列表文件；
• EmQuantAPIActx.ocx与EmQuantAPIActx_x64.ocx分别是32位与64位的ActiveX控件，需与EmQuantAPI.dll、EmQuantAPI_x64.dll和ServerList.json.e置于同一级目录；
• EmQuantAPIActxRegister.exe与EmQuantAPIActxRegister_x64.exe分别是32位与64位的EmQuantAPIActx ActiveX控件的注册工具，用户可以将此程序与本控件置于同一级目录，以管理员身份运行可以注册或卸载本控件，也可以通过regsvr32自行注册本控件；
• LoginActivator.exe是登录激活工具，通过手机号获取验证码，自动生成令牌用以登录。

EMQuantAPI MATLAB接口配置的系统环境要求与方法

系统环境要求

• Windows 系统，支持32位和64位系统；
• MATLAB常用开发工具，建议用户使用MATLAB 2010至MATLAB 2015之间的版本；
• Microsoft Visual C++ 2010 Redistributable Package(可在电脑“程序和功能”中查看是否安装)：

  •下载地址：http://choiceclub.eastmoney.com/#/articleDetail/8769

配置方法

• 本手册分别以64位Windows系统和64位MATLAB为常用开发工具来配置，可参考给出的示例项目。

• 注册安装（注意请关闭Matlab）：

  • 32位 MATLAB请管理员运行EmQuantAPIActxRegister.exe程序进行接口注册；

  • 64位 MATLAB请管理员运行EmQuantAPIActxRegister_x64.exe程序进行接口注册；

• 将EmQuantAPI_Matlab的文件目录添加到Matlab的工作目录（2.5.4.0及之后版本，可忽略此步，安装接口时已经自动添加）

  

• 绑定手机号

  登录Choice量化接口网站主页（https://quantapi.eastmoney.com），点击右上角账户名-个人资料绑定手机号。或者登录Choice金融终端，进入用户中心-资料管理绑定手机号。

• 登录激活（四种方式）

  • 方式一：在start函数中直接输入账号密码进行登录（该方式不生成userinfo登录令牌）

  • 方式二：使用激活工具（适用于有图形界面）

    运行接口激活工具LoginActivator.exe，输入绑定手机号获取验证码，激活成功后生成令牌文件userInfo，用户使用时无需输入用户名和密码，默认从令牌中获取登录权限。一个账号最多支持在十台设备上激活。

    

  • 方式三：上行短信登录验证（适用于无、有图形界面）

    1）手机号绑定API接口账号

    2）主动发送短信内容 "SXDL" 到 9535711 （三网合一，不区分运营商）

    3）完成上行短信发送后，调用登录函数start("LoginMode=SXDL,PhoneNumber=xxxxxxxx")，xxxxxx替换为发送短信的手机号

    4）最后登录成功，并且生成userinfo登录令牌

    5）userinfo生成之后，下次登录无需重复进行短信验证登录

    注意： 1)发送短信会有通讯费用产生；2)不需要userInfo文件 登录成功后会生成一个userInfo文件； 3)发送短信之后没 有回执；4)短信失效时间10分钟。

  • 方式四：人工激活（适用于无、有图形界面）

    1）使用manualactivate函数，将自己的账号、密码、邮箱填进语句中代码并运行如下代码；

    2）联系客户经理或者客服验证并从邮箱中获取登录令牌userInfo。

em = EmQuantMatlab () 
errorid = em.manualactivate('username','userpwd', 'email=who@what.com')

• 使用步骤：

  键入代码 em = EmQuantMatlab () 以初始化一个EmQuantMatlab对象，成功后可以通过em对象来调用提供的各个接口（初始化后需先通过start函数登录接口）。

登录函数

xxxxxxxxxx
errorid = start(em, varargin)

登录API账户，成功登录以后，才可调用其他函数获取数据

 参数描述：

输入参数：

varargin 可选参数 见附注1.

输出参数：

errorid 返回错误编码.

范例

xxxxxxxxxx
errorid = em.start( )  or  errorid = em.start('', @mainCallback)

附注1 登录函数可选参数列表：

退出函数

xxxxxxxxxx
stop(em)

退出登录

无参数

范例

xxxxxxxxxx
em.stop()

数据函数

截面函数

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = css(em, incodes, inindicators, varargin)

获取股票，指数，基金，期货等各个证券品种或组合的基本资料，财务，估值等截面数据

 参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=em.css('300059.SZ,600000.SH', 'TOTALSHARE','EndDate=2016/02/17')

附注2 截面函数可选参数列表：

（注：截面函数每分钟请求次数不能超过700次）

序列函数

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=csd(em,incodes,inindicators,instartdate, inenddate, varargin)

获取股票，指数，基金，期货等各个证券品种或组合的序列数据

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]= em.csd('300059.SZ','TOTALSHARE','2016/7/1','2016/7/13')

附注3 序列函数可选参数列表：

（注：序列函数每分钟请求次数不能超过700次）

专题报表

xxxxxxxxxx
[datas,indicators,row,column,errorid] = ctr(em, inctrname, inindicators, varargin) 

提供专题报表数据

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,indicators,row,column,errorid]=em.ctr('StockInfo','','StartDate=2019-07-01,EndDate=2019-07-02')

附注4 专题报表函数可选参数列表：

宏观数据

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = edb(em, inedbids, varargin)

获取宏观指标数据

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]= em.edb('EMM00058124','IsPublishDate=0,IsLatest=0')

附注5 宏观数据函数可选参数列表：

资讯函数

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = cfn(em, incodes, incontent, inmode, varargin)

提供多个证券品种的公告、新闻等历史资讯和多个板块的历史资讯查询

参数描述

输入参数：

输出参数：

varargin 可选参数

返回的indicators字段说明

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = em.cfn('000001.SZ', 'companynews,industrynews', 1, 'starttime=20190721010000,endtime=20190725200000')
[datas,codes,indicators,dates,errorid] = em.cfn('F888005002API', 'sectornews', 2, 'endtime=20190816,count=10')

资讯订阅

xxxxxxxxxx
[serialid, errorid] = cnq(em, incodes, incontent, varargin)

订阅多个证券品种的公告、新闻等资讯和多个板块的资讯

参数描述

输入参数：

输出参数：

范例

xxxxxxxxxx
[serialid, errorid] = em.cnq('000001.SZ', 'companynews,industrynews', '',@cnqCallback)
[serialid, errorid] = em.cnq('S888005002API', 'sectornews', '',@cnqCallback)

板块截面函数

xxxxxxxxxx
[datas,blockcodes,indicators,dates,errorid] = cses(em, incodes, inindicators, varargin)

获取沪深京股票板块的基本资料，财务等截面数据

 参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=em.cses('B_018005001001,B_014010016006002', ...
'SECTOPREAVG,CFOPSAVG,MANAEXPAVG','TradeDate=2020-10-19,DelType=1,IsHistory=0,type=1,ReportDate=2020-06-30,DataAdjustType=1,PREDICTYEAR=2020,StartDate=2019-05-30,EndDate=2020-10-19,Payyear=2019')

附注6 板块截面函数可选参数列表：

（注：板块截面函数不支持多线程）

功能函数

条件选股

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=cps(em,incpscodes,incpsindicators,incpscondtions, varargin)

条件选股函数

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=em.cps('B_001004','LISTDATE,LISTDATE','[LISTDATE] = d(2021-06-16)', 'top=max([LISTDATE],100),sectordate=2021-06-18')

附注7 常见板块代码：

附注8 操作符列表：

附注9 排序表达式和Top表达式使用规则：

宏观指标查询

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = edbquery(em, inedbids, inindicators, varargin)

获取宏观指标ID详情信息

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = em.edbquery('EMM00058124,EMM00087117,EMG00147350','ID,NAME,SOURCE,REGION')

附注10 宏观指标信息查询函数支持字段列表：

资讯板块查询

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = cfnquery(em, varargin)

获取资讯函数和资讯订阅函数支持的板块信息

参数描述

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = em.cfnquery('')

取消资讯订阅

xxxxxxxxxx
errorid = cnqcancel(em, serialid)

取消特定或所有的资讯订阅

参数描述

输入参数：

输出参数：

范例

xxxxxxxxxx
errorid = em.cnqcancel(0)

板块函数

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=sector(em, insectorcode,inenddate, varargin)

获取Choice金融终端指定系统板块证券代码成分列表，目前只支持沪深股票、上交所期权的历史成分查询，其他板块只能获取最新成分

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
 [datas,codes,indicators,dates,errorid] = em.sector('001004','2016-07-25')

附注11 板块函数可选参数列表：

交易日历

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=tradedates(em, instartdate,inenddate, varargin)

获取指定交易市场，指定时间区间的日期序列，不建议使用未来交易日

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=em.tradedates('2016/07/01','2016/07/15')

附注12 交易日函数可选参数列表：

交易日偏移

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = getdate(em, intradedate, offday, varargin)

获取指定市场交易日历推算第N天交易日

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = em.getdate('20160426',-3)

附注13 偏移N天函数可选参数列表：

区间交易日数

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=tradedatesnum(em, instartdate,inenddate, varargin)

获取指定交易市场，指定时间区间的交易日个数

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid]=em.tradedatesnum('2018/07/01','2018/09/15')

获取错误码信息

xxxxxxxxxx
errstr = geterrstring(em, iErrcode, iLang) 

获取错误码相应的错误信息

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
errstr = em.geterrstring(0, 0)

设置代理函数

xxxxxxxxxx
errorid = setproxy(em, type, proxyip, proxyport, verify ,proxyuser, proxypwd)

设置网络代理

参数描述：

输入参数：

输出参数：

人工激活函数

xxxxxxxxxx
errorid = manualactivate(em, uname, password, varargin)

人工激活登录。本函数可独立使用，无需调用start。本函数适用于无界面运行环境（如远程linux）或无法运行LoginActivator程序的情况，激活成功后将通过邮件获得的激活文件"userInfo"放到"ServerList.json.e"同级目录，再调用start登录

参数描述

输入参数：

输出参数：

范例

xxxxxxxxxx
 errorid = em.manualactivate('username','userpwd', 'email=who@what.com')

指标校验函数

xxxxxxxxxx
[datas,indicators,row,column,errorid] = cfc(em, incodes, inindicators, varargin) 

支持校验css/csd/cses函数的代码+指标模式

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,indicators,row,column,errorid] = em.cfc('000001.SZ,000001.SH,600000.SH,000000.TEST','CODE,NAME,TEST','FunType=css')

附注14 指标校验函数可选参数列表：

代码校验函数

xxxxxxxxxx
[datas,indicators,row,column,errorid] = cec(em, incodes, varargin)

支持判断东财代码是否有效，同时提供补齐后缀的功能

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,indicators,row,column,errorid] = em.cec('000001.SZ,000001.SH,600000.SH,000000.TEST','ReturnType=0')
[datas,indicators,row,column,errorid] = em.cec('000001,600000,000000','ReturnType=1,SecuType=1,SecuMarket=0')

附注15 代码校验函数可选参数列表：

日期宏

在日期参数中可直接使用字母替代或者加减法运算获取对应的日期，分为相对日期和绝对日期。

相对日期

可用于日期相对计算。

绝对日期

特殊,可返回指定字母对应的具体日期。

说明

1. 支持加减法运算，比如 'ED-10D' 代表 从截止日前推 10 天；'SD+5TD' 代表从开始日往后推5个交易日。
2. 运算中，数字代表 N 个周期，只支持整数。
3. 负号’-’代表前推，没有负号或用加号代表后推。
4. 不带SD/ED标识，则默认从最新开始推，比如 '-5D' 从最新往前推5天。

举例：

1. 起始日期为1个周前，截至日期为最新 StartDate= -1W , EndDate= N
2. 报告期为最新 ReportDate = MRQ

流量查询函数

xxxxxxxxxx
[datas,indicators,row,column,errorid] = datastatistics(em, infuncname, inindicators, varargin);

查询函数使用量情况

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,indicators,row,column,errorid] = em.datastatistics('','FUNCENAME,FUNCNAME,SECUTYPE,PERIOD,STARTDATE,ENDDATE,THRESHOLD,USEDDATA,USEDRATIO,AVAILABEDATA','StartDate=2014-9-26,EndDate=2014-10-26')

附注16 函数列表：

附注17 查询字段参数列表：

附注18 日期参数：

组合函数

新建组合

xxxxxxxxxx
errorid = pcreate(em, combincode, combinname, initialfound,varargin)

创建组合

参数描述

输入参数：

输出参数：

范例

xxxxxxxxxx
errorid = em.pcreate('test.PF', '组合测试', 1000000, 'combintype=4', '备注新建组合测试')

附注19 新建组合函数可选参数列表：

组合资金调配

xxxxxxxxxx
errorid = pctransfer(em, combincode, transferdirect, date, opCash, varargin)

提供组合出入金调配

参数描述

输入参数：

输出参数：

范例

xxxxxxxxxx
errorid = em.pctransfer('test.PF', 'IN', '2019-08-09', 10000.0, 'TRANSFERTYPE=1', '追加资金')

附注20 组合资金调配函数可选参数列表：

组合查询

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = pquery(em, varargin)

提供组合账户信息相关数据

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = em.pquery('')

附注21 组合查询函数附加参数明细

附注22 返回数据具体参数明细

批量下单

xxxxxxxxxx
errorid = porder(em, combincode, ordercell, varargin)

组合批量下单

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
ordercell= {'300059.SZ',1000,13.11,'2017-08-14','14:22:18',1,0,0,0;'300059.SZ',500,13.16,'2017-08-14','14:22:20',1,0,0,0;};
errorid = em.porder('test.PF', ordercell, 'autoAddCash=0', '备注买入测试')

附注23：ordercell参数定义列表

附注24 组合交易附加参数options列表

组合报表查询

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = preport(em, incombincode, inindicators, varargin)

查询组合报表信息

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
[datas,codes,indicators,dates,errorid] = em.preport('test.PF','hold','tradedate=2018/01/15')
[datas,codes,indicators,dates,errorid] = em.preport('test.PF','record','startdate=2017/07/12,enddate=2018/01/15')

删除组合

xxxxxxxxxx
errorid = pdelete(em, combincode, varargin)

删除组合

参数描述：

输入参数：

输出参数：

范例

xxxxxxxxxx
errorid = em.pdelete('test.PF')

错误类型

错误类型

常见问题

激活注册

1. Mac下无法使用打开激活工具？

   • 打开桌面终端命令行，安装CommandLine Tools ：xcode-select –install
   • 安装Homebrew：ruby -e "$(curl --insecure -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"，直到看到Installation successful
   • 安装GTK+3.0：brew install gtk+3

2. 有图形界面的Linux点击激活工具无反应？

   • 在命令行使用./LoginActivator
   • 使用chmod命令获取执行权限

3. 错误提示：获取图片验证码失败，稍后再试？

   • 确认是否有外网限制，如有网络限制，需要将Choice服务器添加至网络白名单，联系Choice相关工作人员（400-620-1818）获取白名单地址；
   • 发送serverlist.json.e同级目录下的激活日志ActivatorLog.txt给Choice相关工作人员。

4. 错误提示：发送激活码失败？

   • 重启激活工具
   • 查看serverlist.json.e同级目录下的激活日志ActivatorLog.txt错误提示，直接联系下Choice相关工作人员（400-620-1818）

5. 无图形界面怎么激活？

   • 运行人工激活函数manualactive或者询问客服人员获取人工激活脚本

6. 如何使人工激活函数进行激活？

   • 以64位为例。取消\x64\EmQuantAPITestExe文件夹中main.cpp中的注释，并将自己的账号密码邮箱填进语句中，代码如下。

   ​x
   //EQLOGININFO logInfo;
   ​
   //memset(&logInfo, 0, sizeof(EQLOGININFO));
   ​
   //strncpy(logInfo.userName, "xxxx", strlen("xxxx"));
   ​
   //strncpy(logInfo.password,"xxxxx", strlen("xxxxx"));
   ​
   //errid = emmanualactivate(&logInfo, "email=who@what.com",write2Log);
   

   • 在makefile文件夹中使用make命令编译生成新的emquantapitest文件。
   • 运行bin目录下的emquantapitest。如果观察到

   [Em_Info][2019-06-18 16:22:54]:manual activate begin. [Em_Info][2019-06-18 16:22:54]:manual activate success, please contact with your service manager to get token file.

   即可联系客户经理完成人工激活的剩余步骤。

7. Linux或者mac报错Errno13 Permission denied

   • 运行注册文件权限不足，需要切换到root

8. 报错丢失MSVCP100.dll或者WinError126或者WinError 193

   • 根据python安装的版本，对应安装 Microsoft Visual C++ 2010可再发行组件包
   • 下载链接：http://choiceclub.eastmoney.com/#/articleDetail/8769

登录函数

1. 如何使用上行短信登录

   • 手机号绑定API接口账号
   • 主动发送短信内容 "SXDL" 到 9535711 （三网合一，不区分运营商）
   • 完成上行短信发送后，调用登录函数start("LoginMode=SXDL,PhoneNumber=xxxxxxxx")，xxxxxx替换为发送短信的手机号
   • 最后登录成功，并且生成userinfo登录令牌
   • userinfo生成之后，下次登录无需重复进行短信验证登录

   注意: 1)发送短信会有通讯费用产生

   2)不需要userInfo文件 登录成功后会生成一个userInfo文件

   3)发送短信之后没有回执

   4)短信失效时间10分钟

2. 报错login count up to limit

   • 确认下是否在多台电脑或者多进程使用，因为账号不能同时在多个IP地址上登录，并且不支持多进程。可以在start参数中加强制登录参数ForceLogin=1。正式账号可联系客户经理开通多点登录服务。

3. 报错EQERR_USERINFO_EXPIRED

   • 一般是修改密码导致的，一旦修改密码，需要重新激活。

4. 报错EQERR_DIFFRENT_DEVICE

   • 激活时设备和当前设备不一致。如果是由于设备更换，需要重新激活。确认设备号是否变化可通过查看userinfo同级目录下的登录日志文件logininfo.log中devicenumber最近的登录中是否变化。同一设备上只需要首次使用的时候激活。激活文件有效期一年。

5. 报错userInfo不存在或不可用

   • 需要先运行激活程序生成userInfo文件

序列函数

1. 报错The number of WaitHandles must be less than or equal to 64

   • 指标单次传入不能超过64个

2. 报错em_csd无权限？

   • 登录接口官网https://quantapi.eastmoney.com/Flow 点击流量查询或者找客户经理帮查询下，看下是否是csd对应品种流量已用完。

3. 市场类型没有想要的市场怎么办？

   • 可以选择自然日 market=0，再自行过滤。

截面函数

各个函数中的ReportDate要传什么？

• ReportDate报告日期为每个季度的最后一个自然日，一季报(0331)，中报(0630)，三季报(0930)，年报(1231)，需要对应年度的可以在日期前加上年份，例如2017年三季报为20170930（ReportDate=20170930，支持YYYYMMDD,YYYY-MM-DD,YYYY/MM/DD），和实际的定期报告公告披露日无关。