查询交易所状态 - fetchStatus
交易所状态描述交易所API的最近可用情况。交易所状态信息可能是在交易所 实现类中硬编码的,也可能是从交易所API直接获取的。
可以使用ccxt的统一API中的fetchStatus
方法来查询交易所状态。其返回结果为
以下三者之一:
- 交易所实现类硬编码的信息,例如,如果交易所宕机的话
- 使用交易所对象的ping或fetchTime方法检查交易所API是否存活
- 使用交易所提供的API获取状态信息
fetchStatus
方法原型如下:
fetchStatus(params = {})
方法返回的状态数据结构如下:
{
'status': 'ok', // 'ok', 'shutdown', 'error', 'maintenance'
'updated': undefined, // integer, last updated timestamp in milliseconds if updated via the API
'eta': undefined, // when the maintenance or outage is expected to end
'url': undefined, // a link to a GitHub issue or to an exchange post on the subject
}
说明:
- 'ok'表示交易所API可用
- 'shutdown'表示交易所停机,这时
updated
字段的值就表示停机时间 - 'error'表示API不兼容
- 'maintenance'表示常规维护,
eta
字段的值表示预计恢复时间。