用户指南 | 发明者量化

扩展API接口详解

发明者量化交易平台扩展API接口
在https://www.fmz.com/api/v1后直接附加请求的查询参数（以?分隔），以下是使用Python表达的请求参数：


            json
            
            
{
    "version"   : "1.0",
    "access_key": "xxx",
    "method"    : "GetNodeList",
    "args"      : [],
    "nonce"     : 1516292399361,
    "sign"      : "085b63456c93hfb243a757366600f9c2"
}

字段	说明
version	版本号。
access_key	AccessKey，在账户管理页面申请。
method	具体调用的方法。
args	调用method方法的参数列表。
nonce	时间戳，单位为毫秒，允许与标准时间戳前后误差1小时，nonce必须大于上一次访问时的nonce值。
sign	签名。

各参数以字符&分隔，参数名和参数值用符号=连接，完整的请求URL（以method=GetNodeList为例）：


            plaintext
            
            
https://www.fmz.com/api/v1?access_key=xxx&nonce=1516292399361&args=%5B%5D&sign=085b63456c93hfb243a757366600f9c2&version=1.0&method=GetNodeList

注意：请求参数中不包含secret_key参数。

签名方式
请求参数中sign参数的加密方式如下，按照以下格式：


            plaintext
            
            
version + "|" + method + "|" + args + "|" + nonce + "|" + secretKey

拼接字符串后，使用MD5加密算法对字符串进行加密，并转换为十六进制字符串，该值作为参数sign的值。签名部分可参考Python代码扩展API接口「验证方式」：


            python
            
            
# 参数
d = {
    'version': '1.0',
    'access_key': accessKey,
    'method': method,
    'args': json.dumps(list(args)),
    'nonce': int(time.time() * 1000),
}

# 计算sign签名
d['sign'] = md5.md5(('%s|%s|%s|%d|%s' % (d['version'], d['method'], d['args'], d['nonce'], secretKey)).encode('utf-8')).hexdigest()

接口业务错误：

参数不足：


            json
            
            
{
    "code":0,
    "data":{
        "result":null,
        "error":"Params length incorrect"
    }
}

GetNodeList

GetNodeList方法用于获取请求中API KEY对应的发明者量化交易平台账号下的托管者列表。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "all": 1,
            "nodes": [{
                "build": "3.7",
                "city": "...",
                "created": "2024-11-08 09:21:08",
                "date": "2024-11-08 16:37:16",
                "forward": "...",
                "guid": "...",
                "host": "node.fmz.com:9902",
                "id": 123,
                "ip": "...",
                "is_owner": true,
                "loaded": 0,
                "name": "MacBook-Pro-2.local",
                "online": true,
                "os": "darwin/amd64",
                "peer": "...",
                "public": 0,
                "region": "...",
                "tunnel": false,
                "version": "...",
                "wd": 0
            }]
        },
        "error": null
    }
}

返回值字段说明（字面意思明显的字段不再赘述）：

all: 当前账户关联的托管者总数。
nodes: 托管者节点的详细信息列表。
- build: 版本号。
- city: 所在城市。
- is_owner: true表示私有托管者，false表示公共托管者。
- loaded: 负载量，即当前运行的策略实例数量。
- public: 0表示私有托管者，1表示公共托管者。
- region: 地理位置。
- version: 托管者的详细版本信息。
- wd: 离线报警开关，0表示未开启。
  一键部署的托管者包含额外信息，相关字段以ecs_、unit_为前缀，记录了一键部署托管者服务器的相关信息（运营商名称、配置、状态等）、计费周期、价格等信息，此处不再详述。

参数

无参数

GetRobotGroupList

GetRobotGroupList方法用于获取请求中API KEY对应的发明者量化交易平台账号下的实盘分组列表。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "items": [{
                "id": 3417,
                "name": "测试"
            }, {
                "id": 3608,
                "name": "实盘演示"
            }]
        },
        "error": null
    }
}

items: 实盘分组信息。
- id: 实盘分组ID。
- name: 实盘分组名称。
  items字段仅记录创建的新分组，「默认」分组不包含在items中。

参数

无参数

GetPlatformList

GetPlatformList方法用于获取请求中API KEY对应的发明者量化交易平台账号下已配置的交易所列表。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "all": 2,
            "platforms": [{
                "category": "加密货币||Crypto",
                "date": "2023-12-07 13:44:52",
                "eid": "Binance",
                "id": 123,
                "label": "币安",
                "logo": "...",
                "name": "币安现货|Binance",
                "stocks": ["BTC_USDT", "LTC_USDT", "ETH_USDT", "ETC_USDT", "BTC_TUSD", "ETH_TUSD", "BNB_TUSD"],
                "website": "..."
            }, {
                "category": "通用协议|Custom Protocol",
                "date": "2020-11-09 11:23:48",
                "eid": "Exchange",
                "id": 123,
                "label": "XX交易所REST协议",
                "logo": "...",
                "name": "通用协议|Custom Protocol",
                "stocks": ["BTC_USDT", "ETH_USDT"],
                "website": ""
            }]
        },
        "error": null
    }
}

all: 已配置的交易所对象总数。
platforms: 交易所相关信息。
- eid: 发明者量化交易平台上的交易所标识符，在某些配置和参数中需要使用eid。

参数

无参数

GetRobotList

GetRobotList方法用于获取请求中API KEY对应的发明者量化交易平台账号下的实盘列表。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "all": 1,
            "concurrent": 0,
            "robots": [{
                "charge_time": 1731654846,
                "date": "2024-11-12 14:05:29",
                "end_time": "2024-11-15 14:56:32",
                "fixed_id": 4509153,
                "id": 591026,
                "is_sandbox": 0,
                "name": "测试",
                "node_guid": "45891bcf3d57f99b08a43dff76ee1ea1",
                "node_id": 4519153,
                "node_public": 0,
                "profit": 0,
                "public": 0,
                "refresh": 1731651257000,
                "start_time": "2024-11-15 14:56:30",
                "status": 3,
                "strategy_id": 411670,
                "strategy_isowner": true,
                "strategy_language": 0,
                "strategy_name": "测试",
                "strategy_public": 0,
                "uid": "105ed6e511cc977921610fdbb7e2a1d6",
                "wd": 0
            }]
        },
        "error": null
    }
}

robots: 实盘信息
- group_id: 实盘分组ID；如果实盘位于默认分组中，则不包含group_id字段。

参数

名称	类型	必填	描述
offset	number	否	分页查询的偏移量设置。
length	number	否	分页查询的数据长度设置。
robotStatus	number	否	指定要查询的实盘状态，参考扩展API接口「实盘状态码」，传入`-1`表示获取全部实盘。
label	string	否	指定要查询的实盘自定义标签，可筛选出包含该标签的所有实盘。
keyWord	string	否	查询关键字。

备注

以Python语言的扩展API接口「验证方式」为例：

print(api('GetRobotList'))：获取全部实盘信息。

print(api('GetRobotList', 'member2'))：打印所有自定义标签为member2的实盘信息。

print(api('GetRobotList', 0, 5, -1, 'member2'))：分页查询，从偏移量0开始，最多返回5个标签为member2的实盘。

CommandRobot

CommandRobot方法用于向请求中API KEY对应的发明者量化交易平台账号下的实盘发送交互命令。接收交互命令的实盘Id由robotId参数指定，交互命令由策略中调用的GetCommand()函数捕获并返回。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":true,
        "error":null
    }
}

result: 交互指令是否发送成功。向未运行的实盘发送指令时，返回数据中的result为false。

参数

名称	类型	必填	描述
robotId	number	是	`robotId`参数用于指定接收交互指令的实盘Id。可以使用`GetRobotList`方法获取账号下实盘的信息，其中包含实盘Id。
cmd	string	是	`cmd`参数是发送给实盘的交互指令。实盘策略中的`GetCommand()`函数会捕获该交互命令，触发策略的交互逻辑。策略代码中的具体交互逻辑实现，请参考发明者量化交易平台API手册中的`GetCommand()`函数说明。

备注

实盘策略示例（假设该策略实盘正在运行，实盘Id为123）：


            javascript
            
            
function main() {
    while (true) {
        var cmd = GetCommand()
        if (cmd) {
            Log(cmd)
        }
        Sleep(2000)
    }
}

如果使用本章节的Python测试脚本访问发明者量化交易平台的扩展API：api("CommandRobot", 123, "test command")，Id为123的实盘将收到交互指令：test command，并通过Log函数输出打印。

StopRobot

StopRobot方法用于停止请求中API KEY对应的发明者量化交易平台账号下的实盘。停止运行的实盘Id由robotId参数指定。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":2,
        "error":null
    }
}

result: 实盘状态码，2表示停止中。

参数

名称	类型	必填	描述
robotId	number	是	`robotId`参数用于指定要停止的实盘Id。可以通过`GetRobotList`方法获取账号下的实盘信息，其中包含实盘Id。

RestartRobot

RestartRobot方法用于重启请求中API KEY对应的发明者量化交易平台账号下的实盘。重启的实盘ID由robotId参数指定。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":1,
        "error":null
    }
}

result: 实盘状态码，1表示运行中。

参数

名称类型必填描述

robotId

number

是

robotId参数用于指定要重启的实盘ID。可以使用GetRobotList方法获取账号下实盘的信息，其中包含实盘ID。

settings

JSON对象

否

实盘配置参数，settings参数格式如下：


            json
            
            
{
    "appid":"test",
    "args":[],
    "exchanges":[
        {"pair":"SOL_USDT","pid":123},
        {"pair":"ETH_USDT","pid":456}
    ],
    "name":"测试",
    "node":123,
    "period":60,
    "strategy":123
}

appid: 自定义字段
可以定义标签。
args: 策略参数设置
结构为数组，每个元素为一个参数。例如，策略有一个参数Interval，重启策略时希望将Interval设置为500，则args中应包含：["Interval", 500]，即："args": [["Interval", 500]]。
exchanges: 实盘绑定的交易所对象配置
结构为数组，其中每个元素为一个交易所对象配置。
- 可以绑定已在平台配置的交易所对象
  使用pid配置：{"pair":"SOL_USDT","pid":123}；pid可以通过GetPlatformList接口查询，返回数据中的id字段即为交易所pid。
- 可以直接传入配置信息，绑定交易所对象
  使用eid配置：{"eid":"Huobi","label":"test Huobi","meta":{"AccessKey":"123","SecretKey":"123"},"pair":"BCH_BTC"}；传入的API KEY等敏感信息，发明者量化交易平台不会存储，这些数据将直接转发给托管者程序。如果使用此类配置，每次创建或重启实盘时必须配置该信息。
- 可以绑定通用协议交易所对象
  可以传入配置信息：{"eid":"Exchange","label":"test exchange","pair":"BTC_USDT","meta":{"AccessKey":"123","SecretKey":"123","Front":"http://127.0.0.1:6666/test"}}。
  label属性用于为当前通用协议接入的交易所对象设置标签，在策略中可以使用exchange.GetLabel()函数获取。
name: 策略名称
node: 托管者ID
指定在哪个托管者上运行。如果不设置该属性，系统将自动分配运行。
period: 默认K线周期
K线周期参数，60表示60秒。
strategy: 策略ID
可以使用GetStrategyList方法获取。

备注

如果实盘是通过扩展API接口创建的，重启时必须使用扩展API接口RestartRobot进行重启，并且必须传入settings参数。对于在平台页面上创建的实盘，可以通过扩展API接口重启或点击实盘页面上的按钮重启。可以传入settings参数或不传入。如果只传入robotId参数，则按照实盘的当前设置启动运行。

GetRobotDetail

GetRobotDetail方法用于获取请求中API KEY对应的发明者量化交易平台账号下的实盘详细信息。所要获取的实盘详细信息由robotId参数指定。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "robot": {
                "charge_time": 1732246539,
                "charged": 5850000,
                "consumed": 5375000000,
                "date": "2018-12-28 14:34:51",
                "favorite": {
                    "added": false,
                    "type": "R"
                },
                "fixed_id": 123,
                "hits": 1,
                "id": 123,
                "is_deleted": 0,
                "is_manager": true,
                "is_sandbox": 0,
                "name": "测试",
                "node_id": 123,
                "pexchanges": {
                    "123": "Futures_OKCoin"
                },
                "phash": {
                    "123": "ca1aca74b9cf7d8624f2af2dac01e36d"
                },
                "plabels": {
                    "123": "OKEX期货 V5"
                },
                "priority": 0,
                "profit": 0,
                "public": 0,
                "refresh": 1732244453000,
                "robot_args": "[]",
                "start_time": "2024-11-22 11:00:48",
                "status": 1,
                "strategy_args": "[]",
                "strategy_exchange_pairs": "[60,[123],[\"ETH_USDT\"]]",
                "strategy_id": 123,
                "strategy_last_modified": "2024-11-21 16:49:25",
                "strategy_name": "测试",
                "strategy_public": "0",
                "uid": "105ed6e51bcc17792a610fdbb7e2a1d6",
                "username": "abc",
                "wd": 0
            }
        },
        "error": null
    }
}

charge_time: 下次扣费时间，即当前扣费后的有效截止时间。
charged: 已消耗的时间。
consumed: 已消耗的金额（0.125 USD = 12500000 / 1e8）。
date: 创建日期。
fixed_id: 实盘运行时分配的托管者ID，如果是自动分配，该值为-1。
is_manager: 是否有权限管理该实盘。
is_sandbox: 是否为模拟盘。
name: 实盘名称。
node_id: 托管者ID。
pexchanges: 实盘配置的交易所对象，123为pid，"Futures_OKCoin"为交易所名称。
plabels: 实盘配置的交易所对象的标签信息。
profit: 实盘收益数据。
public: 实盘是否公开。
refresh: 最近活跃时间。
strategy_exchange_pairs: 配置的交易所对象及其交易对信息。
wd: 是否开启离线报警。

参数

名称	类型	必填	描述
robotId	number	是	`robotId`参数用于指定要获取详细信息的实盘ID。可通过`GetRobotList`方法获取账号下的实盘信息，其中包含实盘ID。

备注

strategy_exchange_pairs属性说明，以下列数据为例：


            plaintext
            
            
"[60,[44314,42960,15445,14703],[\"BTC_USDT\",\"BTC_USDT\",\"ETH_USDT\",\"ETH_USDT\"]]"

其中第一个数据60表示实盘设置的默认K线周期为1分钟，即60秒。

[44314,42960,15445,14703]为实盘配置的交易所对象的pid（按添加顺序排列）。

[\"BTC_USDT\",\"BTC_USDT\",\"ETH_USDT\",\"ETH_USDT\"]为实盘配置的交易所对象设置的交易对（按添加顺序与pid一一对应）。

GetAccount

GetAccount方法用于获取请求中API KEY对应的发明者量化交易平台账号的账户信息。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":{
            "balance":22944702436,
            "concurrent":0,
            "consumed":211092719653,
            "currency":"USD",
            "email":"[email protected]",
            "openai":false,
            "settings":null,
            "sns":{"wechat":true},
            "uid":"105ea6e51bcc177926a10fdbb7e2a1d6",
            "username":"abc"
        },
        "error":null
    }
}

balance: 账户余额
此处的数值采用整数表示以确保精度，实际数值需除以1e8（即10的8次方）进行换算。本例中实际余额为：229.44702436

GetExchangeList

GetExchangeList方法用于获取FMZ量化交易平台支持的交易所列表及其配置信息。

返回值

isSummary参数为false时，返回的数据：


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "exchanges": [{
                "category": "加密货币||Crypto",
                "eid": "Futures_Binance",
                "id": 74,
                "logo": "/upload/asset/d8d84b23e573e9326b99.svg",
                "meta": "[{\"desc\": \"Access Key\", \"qr\":\"apiKey\",\"required\": true, \"type\": \"string\", \"name\": \"AccessKey\", \"label\": \"Access Key\"}, {\"encrypt\": true, \"qr\":\"secretKey\",\"name\": \"SecretKey\", \"required\": true, \"label\": \"Secret Key\", \"type\": \"password\", \"desc\": \"Secret Key\"}]",
                "name": "币安期货|Futures_Binance",
                "priority": 200,
                "stocks": "BTC_USDT,ETH_USDT,ETH_USD",
                "website": "https://accounts.binance.com/zh-TC/register?ref=45110270"
            }]
        },
        "error": null
    }
}

isSummary参数为true时，返回的数据：


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "exchanges": [{
                "category": "加密货币||Crypto",
                "eid": "Futures_Binance",
                "id": 74,
                "logo": "/upload/asset/d8d84b23e573e9326b99.svg",
                "name": "币安期货|Futures_Binance",
                "priority": 200,
                "website": "https://accounts.binance.com/zh-TC/register?ref=45110270"
            }]
        },
        "error": null
    }
}

meta: 交易所配置元数据。

参数

名称	类型	必填	描述
isSummary	bool	是	`isSummary`参数用于指定返回的数据是否为摘要信息。

DeleteNode

DeleteNode方法用于删除请求中API KEY对应的发明者量化交易平台账号下的托管者节点，删除的托管者节点ID为nid参数指定的托管者ID。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":true,
        "error":null
    }
}

result: 是否成功删除关联的托管者程序。

参数

名称	类型	必填	描述
nid	number	是	`nid`参数用于指定要删除的托管者ID，可通过`GetNodeList`方法获取账号下托管者的信息。

DeleteRobot

DeleteRobot方法用于删除请求中API KEY对应的发明者量化交易平台账号下的实盘。删除的实盘ID为robotId参数指定的实盘ID。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":0,
        "error":null
    }
}

result: 实盘删除操作的反馈结果。
- 0: 正常删除。
- -2: 删除成功，但无法与实盘关联的托管者联系，请手动删除文件 123.db3！

参数

名称	类型	必填	描述
robotId	number	是	`robotId`参数用于指定要删除的实盘ID。可以使用`GetRobotList`方法获取账号下实盘的信息，其中包含实盘ID。
deleteLogs	bool	是	`deleteLogs`参数用于设置是否删除实盘日志。如果传入真值（例如：`true`），则删除实盘日志。

GetStrategyList

GetStrategyList方法用于获取平台策略信息。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "all": 123,
            "strategies": [{
                "category": 9,
                "date": "2024-11-10 20:40:04",
                "description": "",
                "forked": 0,
                "hits": 0,
                "id": 123,
                "is_buy": false,
                "is_owner": false,
                "language": 2,
                "last_modified": "2024-11-11 17:23:52",
                "name": "HedgeGridStrategy",
                "profile": {
                    "avatar": "...",
                    "nickname": "abc",
                    "uid": "4ed225440db1eda23fe05ed10184113e"
                },
                "public": 0,
                "tags": "",
                "uid": "4ed225440db1eda23fe05ed10184113e",
                "username": "abc"
            }]
        },
        "error": null
    }
}

all: 符合筛选条件的策略总数。
strategies: 查询返回的策略详细信息。

参数

名称	类型	必填	描述
offset	number	是	`offset`参数用于设置查询的偏移量。
length	number	是	`length`参数用于设置查询返回的数据条数。
strategyType	number	是	`strategyType`参数用于设置要查询的策略类型。 `strategyType`参数设置为`0`：查询所有策略。 `strategyType`参数设置为`1`：查询已公开的策略。 `strategyType`参数设置为`2`：查询待审核的策略。
category	number	是	`category`参数用于设置要查询的策略类别。 `category`参数设置为`-1`：查询所有策略。 `category`参数设置为`0`：查询通用策略。
needArgs	number	是	`needArgs`参数用于设置查询的策略是否需要参数。 `needArgs`参数设置为`0`：查询所有策略。
language	number	是	`language`参数用于设置要查询的策略编程语言。 `language`参数设置为`0`：JavaScript语言。 `language`参数设置为`1`：Python语言。 `language`参数设置为`2`：C++语言。 `language`参数设置为`3`：可视化策略。 `language`参数设置为`4`：My语言。 `language`参数设置为`5`：PINE语言。
kw	string	是	`kw`参数用于设置查询策略的关键字。设置为空字符串表示不使用关键字筛选。

NewRobot

NewRobot方法用于创建请求中API KEY对应的发明者量化交易平台账号下的实盘。

返回值


            json
            
            
{
    "code":0,
    "data":{
        "result":591988,
        "error":null
    }
}

result: 创建成功，返回实盘ID。

参数

名称类型必填描述

settings

JSON对象

是

实盘配置参数，settings参数格式如下：


            json
            
            
{
    "appid":"test",
    "args":[],
    "exchanges":[
        {"pair":"SOL_USDT","pid":123}
    ],
    "group":123,
    "name":"test",
    "node":123,
    "period":60,
    "strategy":123
}

group: 指定实盘分组。
args: 策略参数，如果策略没有参数则为空数组。
exchanges: 交易所对象配置，可参考RestartRobot接口。

备注

settings参数中eid配置的"meta":{"AccessKey": "123", "SecretKey": "123"}等敏感信息，发明者量化交易平台不会存储。这些数据将直接转发给托管者程序，因此每次创建或重启实盘时必须配置此信息。

如果创建使用通用协议交易所对象的实盘，在配置settings参数时，exchanges属性可使用如下设置：


            json
            
            
{
    "eid": "Exchange",
    "label": "test",
    "pair": "ETH_BTC",
    "meta": {
        "AccessKey": "123",
        "SecretKey": "123",
        "Front": "http://127.0.0.1:6666/test"
    }
}

label属性用于为当前通用协议接入的交易所对象设置标签，在策略中可使用exchange.GetLabel()函数获取。

PluginRun

PluginRun方法用于调用发明者量化交易平台的调试工具功能；仅支持JavaScript语言。

返回值


            json
            
            
{
    "code": 0,
    "data": {
        "result": "{\"logs\":[{\"PlatformId\":\"\",\"OrderId\":\"0\",\"LogType\":5,\"Price\":0,\"Amount\":0,\"Extra\":\"Hello FMZ\",\"Currency\":\"\",\"Instrument\":\"\",\"Direction\":\"\",\"Time\":1732267473108}],\"result\":\"\"}",
        "error": null
    }
}

result: 调试工具成功执行传入的JavaScript代码后返回的测试结果数据。

参数

名称类型必填描述

settings

JSON对象

是

调试工具中的设置参数，settings配置中包含测试代码，位于source属性中。settings参数格式如下：


            json
            
            
{
    "exchanges":[{"pair":"SOL_USDT","pid":123}],
    "node":123,
    "period":60,
    "source":"function main() {Log(\"Hello FMZ\")}"
}

source: 需要调试的代码。
node: 托管者ID，可指定在哪个托管者上运行实盘。若该值为-1，则表示自动分配。
exchanges: 交易所对象配置，可参考RestartRobot接口。

备注

{"eid": "OKEX", "pair": "ETH_BTC", "meta" :{"AccessKey": "123", "SecretKey": "123"}}
{"eid": "Huobi", "pair": "BCH_BTC", "meta" :{"AccessKey": "123", "SecretKey": "123"}}

对于settings中的exchanges属性，调用PluginRun方法时只需设置一个（在调试工具页面使用时也仅支持一个交易所对象）。在settings中设置2个交易所对象不会引发报错，但在代码中访问第二个交易所对象时将会报错。

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线数据。