set_token - 设置token
用户有时只需要提取数据, set_token后就可以直接调用数据函数, 无需编写策略结构。如果token不合法, 访问需要身份验证的函数会抛出异常。
token位置参见终端-系统设置界面-密钥管理(token)
函数原型:
set_token(token)
参数:
参数名 | 类型 | 说明 |
---|---|---|
token | str | 身份标识 |
返回值:
None
示例:
set_token('your token')
history_data = history(symbol='SHSE.000300', frequency='1d', start_time='2010-07-28', end_time='2017-07-30', df=True)
注意:
token输入错误会报错“错误或无效的token”。
log - 日志函数
函数原型:
log(level, msg, source)
参数:
参数名 | 类型 | 说明 |
---|---|---|
level | str | 日志级别 debug , info , warning , error |
msg | str | 信息 |
source | str | 来源 |
返回值:
None
示例:
log(level='info', msg='平安银行信号触发', source='strategy')
注意:
1.log函数仅支持实时模式,输出到终端策略日志处。
2.level输入无效参数不会报错,终端日志无显示。
3.参数类型报NameError错误,缺少参数报TypeError错误。
4.重启终端日志记录会自动清除,需要记录日志到本地的,可以使用Python的logging库
get_strerror - 查询错误码的错误描述信息
函数原型:
get_strerror(error_code)
参数:
参数名 | 类型 | 说明 |
---|---|---|
error_code | int | 错误码 |
全部 错误码详细信息
返回值:
错误原因描述信息字符串
示例:
err = get_strerror(error_code=1010)
print(err)
输出:
b'\xe6\x97\xa0\xe6\xb3\x95\xe8\x8e\xb7\xe5\x8f\x96\xe6\x8e\x98\xe9\x87\x91\xe6\x9c\x8d\xe5\x8a\xa1\xe5\x99\xa8\xe5\x9c\xb0\xe5\x9d\x80\xe5\x88\x97\xe8\xa1\xa8'
注意:
error_code值输入错误无报错,返回值为空。
get_version - 查询api版本
函数原型:
get_version()
返回值:
字符串 当前API版本号
示例:
version = get_version()
print(version)
输出:
3.0.127
set_mfp - 设置留痕信息
函数原型:
set_mfp(mfp)
参数:
参数名 | 类型 | 说明 |
---|---|---|
mfp | str | 留痕信息 |
注意:
根据合规要求,设置相关mfp信息。mfp信息,键值使用key=value的形式拼接。多个键值对之间用竖线(“|”)分隔。
如 “cpu=xxxx|fdsn=yyyyy|…”。
信息项如下:
CPU string // CPU 信息
FDSN string // Hard Disk Serieal Number (compatible old spec)
HD string // Hard Disk
LIP string // Lan IP
IIP string // 互联网IP
IPORT string // 互联网PORT
MAC string // mac 地址
OSV string // Operating System Version
PCN string // Personal Computer Name
PI string // Partition Information,磁盘分区信息
VER string // 客户端版本信息
UUID string // uuid
返回值:
None
示例:
set_mfp(mfp)