用户指南 | 发明者量化

GetRobotList

获取当前账号的实盘列表，可以按状态、标签、名称、分组、策略筛选；参数都可以省略。

示例

获取全部实盘、按标签筛选，以及按位置或按参数名传参。


    python
    
    
# api() 见「签名验证」页面的Python示例
r = api('GetRobotList')                              # 全部实盘
r = api('GetRobotList', 'member2')                   # 只传一个字符串时视为标签：标签为member2的全部实盘
r = api('GetRobotList', 0, 100, -1, 'member2', '')   # 按位置传参：从第0条开始最多100个标签为member2的实盘
r = api('GetRobotList', appId='member2', length=100) # 按参数名传值，效果同上
for robot in r['data']['result']['robots']:
    print(robot['id'], robot['name'], robot['status'])

返回值

类型	描述
object	成功时`data.result`包含实盘总数`all`和实盘数组`robots`，字段见下方属性表。

参数

名称	类型	必填	描述
offset	number	否	分页偏移，默认为0。
length	number	否	每页数量；小于等于0时返回全部（默认）。
customStatus	number	否	按实盘状态码筛选，见`实盘状态码`；`-1`为全部实盘（默认），`-2`为全部实盘并按启动时间排序。
appId	string	否	按实盘的自定义标签（创建时`settings`中的`appid`）筛选，空字符串表示不筛选。
kw	string	否	按实盘名称模糊匹配的关键字，空字符串表示不筛选。
groupId	number	否	实盘分组：`-1`全部（默认），`0`未分组，大于0为指定分组。
orderBy	string	否	排序字段：`name`、`status`、`node`、`profit`、`date`、`refresh`、`start_time`、`strategy_name`，后面加 `asc`为升序（默认降序）；空字符串为默认排序。
strategyId	number	否	大于0时只返回该策略的实盘，默认为0（不筛选）。

属性

名称	类型	描述
all	number	符合条件的实盘总数。
robots	array	实盘数组。
robots[].id	number	实盘Id。
robots[].status	number	实盘状态码，见`实盘状态码`。
robots[].group_id	number	实盘分组Id；在默认分组中的实盘没有这个字段。

备注

返回示例


            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
    }
}