输入/搜索内容
入门
平台基础
编写策略
开发工具
回测系统
进阶专题
数据与研究
扩展API接口
AI接入
创建ApiKey
验证方式
扩展API接口详解
GetAccount
GetNodeList
DeleteNode
GetExchangeList
GetPlatformList
GetStrategyList
GetRobotGroupList
GetRobotList
GetRobotDetail
GetRobotLogs
NewRobot
RestartRobot
StopRobot
CommandRobot
DeleteRobot
PluginRun
pub
扩展API接口返回码
实盘状态码

启动(重启)当前账号下的一个实盘,可以同时用新的配置替换原配置;启动会扣费。

示例

按实盘当前的配置启动实盘123。

python
# api() 见「签名验证」页面的Python示例 r = api('RestartRobot', 123) print(r['data']['result']) # 输出:0(准备中,启动流程已执行完)

返回值

类型描述

number

data.result:正常情况下为0(准备中),表示启动流程已执行完;启动是否成功要用GetRobotDetail查询。其它返回值见备注。

参数

名称类型必填描述

robotId

number

是

实盘Id,可以用GetRobotList查询。

settings

object

否

新的实盘配置,传入时整份覆盖原配置再启动,见备注;字段见扩展API接口详解中的「实盘配置(settings)」。

备注

在平台页面创建、使用已添加交易所账户(pid)的实盘,可以只传robotId,按实盘当前的配置启动。用eid方式直接传入交易所配置的实盘(通常由扩展API接口创建),平台没有保存密钥,每次重启都必须传入settings。

传入settings时,先用它整份覆盖实盘的配置(名称、参数、交易所、K线周期、托管者),再启动;不能更换策略。没有写的字段不会保留原值:name变为空字符串,args变为[](参数全部恢复默认值),没写exchanges会删除实盘的全部交易所配置,period变为60秒,node变为自动分配;只有group不写或为0时保留原分组。所以传入settings时必须写出完整配置,建议先用GetRobotDetail取得当前配置再修改。

实盘处于准备中、运行中或停止中时传入settings,返回code为6的错误(robot is running);不传settings时不会重新启动,直接返回当前的状态码(0、1、2)。

返回负数表示启动失败,含义见实盘状态码中的「启动失败的返回值」。启动后实盘是运行中,还是因编译出错等进入「策略有错误」,要用GetRobotDetail查询。