用户指南 | 发明者量化

GetRobotLogs

GetRobotLogs方法用于获取请求中API KEY对应的FMZ量化交易平台账号下的实盘日志信息。要获取日志信息的实盘ID由robotId参数指定。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "chart": "",
            "chartTime": 0,
            "logs": [{
                "Total": 20,
                "Max": 20,
                "Min": 1,
                "Arr": []
            }, {
                "Total": 0,
                "Max": 0,
                "Min": 0,
                "Arr": []
            }, {
                "Total": 0,
                "Max": 0,
                "Min": 0,
                "Arr": []
            }],
            "node_id": 123,
            "online": true,
            "refresh": 1732201544000,
            "status": 4,
            "summary": "...",
            "updateTime": 1732201532636,
            "wd": 0
        },
        "error": null
    }
}

logs: 日志信息；查询出的若干条日志数据存储在Arr字段中。
logs中第一个数据结构为实盘数据库中策略日志表的日志记录。
logs中第二个数据结构为实盘数据库中收益日志表的日志记录。
logs中第三个数据结构为实盘数据库中图表日志表的日志记录。
summary: 实盘状态栏数据。

参数

名称	类型	必填	描述
robotId	number	是	`robotId`参数用于指定要获取日志信息的实盘ID。可以使用`GetRobotList`方法获取账号下的实盘信息，其中包含实盘ID。
logMinId	number	是	`logMinId`参数用于指定日志记录的最小ID。
logMaxId	number	是	`logMaxId`参数用于指定日志记录的最大ID。
logOffset	number	是	`logOffset`参数用于设置偏移量。在由`logMinId`和`logMaxId`确定的范围内，根据`logOffset`跳过指定数量的记录，从而确定数据获取的起始位置。
logLimit	number	是	`logLimit`参数用于设置从起始位置开始要获取的数据记录条数。
profitMinId	number	是	`profitMinId`参数用于设置收益日志的最小ID。
profitMaxId	number	是	`profitMaxId`参数用于设置收益日志的最大ID。
profitOffset	number	是	`profitOffset`参数用于设置偏移量，即跳过指定数量的记录作为起始位置。
profitLimit	number	是	`profitLimit`参数用于设置从起始位置开始要获取的数据记录条数。
chartMinId	number	是	`chartMinId`参数用于设置图表数据记录的最小ID。
chartMaxId	number	是	`chartMaxId`参数用于设置图表数据记录的最大ID。
chartOffset	number	是	`chartOffset`参数用于设置偏移量。
chartLimit	number	是	`chartLimit`参数用于设置要获取的记录条数。
chartUpdateBaseId	number	是	`chartUpdateBaseId`参数用于设置查询更新记录的基准ID。
chartUpdateDate	number	是	`chartUpdateDate`参数用于设置数据记录的更新时间戳，系统将筛选出大于此时间戳的记录。
summaryLimit	number	是	`summaryLimit`参数用于设置要查询的状态栏数据字节数。该参数为整型，用于查询实盘的状态栏数据。设置为0表示不查询状态栏信息；设置为非0值表示要查询的状态栏信息字节数（此接口不限制数据量，可以指定一个较大的summaryLimit参数来获取所有状态栏信息）。状态栏数据存储在返回数据的`summary`字段中。

备注

数据库中的策略日志表
返回数据中logs的属性值（数组结构）的第一个元素中（日志数据）Arr属性值描述如下：
```
            plaintext
            
            
"Arr": [
    [3977, 3, "Futures_OKCoin", "", 0, 0, "Sell(688.9, 2): 20016", 1526954372591, "", ""],
    [3976, 5, "", "", 0, 0, "OKCoin:this_week 仓位过多, 多: 2", 1526954372410, "", ""]
],
```
id logType eid orderId price amount extra date contractType direction
3977 3 "Futures_OKCoin" "" 0 0 "Sell(688.9, 2): 20016" 1526954372591 "" ""
3976 5 "" "" 0 0 "OKCoin:this_week 仓位过多, 多: 2" 1526954372410 "" ""

extra为打印日志的附加信息。

logType值对应的日志类型描述如下：

logType: 0 1 2 3 4 5 6
logType意义: BUY SALE RETRACT ERROR PROFIT MESSAGE RESTART
中文意义买入订单日志卖出订单日志撤单错误收益消息重启

id	logType	eid	orderId	price	amount	extra	date	contractType	direction
3977	3	"Futures_OKCoin"	""	0	0	"Sell(688.9, 2): 20016"	1526954372591	""	""
3976	5	""	""	0	0	"OKCoin:this_week 仓位过多, 多: 2"	1526954372410	""	""

logType:	0	1	2	3	4	5	6
logType意义:	BUY	SALE	RETRACT	ERROR	PROFIT	MESSAGE	RESTART
中文意义	买入订单日志	卖出订单日志	撤单	错误	收益	消息	重启

数据库中的收益图表日志表
该图表日志表数据与策略日志表中的收益日志保持一致。


            plaintext
            
            
"Arr": [
    [202, 2515.44, 1575896700315],
    [201, 1415.44, 1575896341568]
]

以其中一条日志数据为例：


            plaintext
            
            
[202, 2515.44, 1575896700315]

202为日志ID，2515.44为收益数值，1575896700315为时间戳。

数据库中的图表日志表


            plaintext
            
            
"Arr": [
    [23637, 0, "{\"close\":648,\"high\":650.5,\"low\":647,\"open\":650,\"x\":1575960300000}"],
    [23636, 5, "{\"x\":1575960300000,\"y\":3.0735}"]
]

以其中一条日志数据为例：


            plaintext
            
            
[23637, 0, "{\"close\":648,\"high\":650.5,\"low\":647,\"open\":650,\"x\":1575960300000}"],

23637为日志ID，0为图表数据系列索引，最后的数据"{\"close\":648,\"high\":650.5,\"low\":647,\"open\":650,\"x\":1575960300000}"为日志数据，该条数据为图表上的K线数据。