# IOTA Watch 数据来自哪里，多久更新一次？

了解 IOTA Train at Home 官网 API 数据来源、刷新周期、采样时间与旧数据标记，判断设备状态和收益是否及时。

- Canonical: https://iotahome.site/zh/learn/data-sources-and-freshness
- Publisher: IOTA Watch
- Published: 2026-10-01
- Updated: 2026-10-01

IOTA Watch 读取 Macrocosmos 的公开主网 API。设备状态、收益与训练统计分别记录更新时间；某一项刷新成功，不会让其他项目自动变成最新。

## 各页面使用哪些数据源？

- 设备查找：进行中的任务，以及每个任务的矿工名单

- 全网现况：任务列表、网络名额、矿工名单和任务进度

- 收益：分别读取记账总额与收益历史记录

- 训练历史：所选任务与时间范围内的训练指标、吞吐量和累计 token 数

API 基础地址是 [iota-web.api.macrocosmos.ai/mainnet](https://iota-web.api.macrocosmos.ai/mainnet/runs)。这些是公开上报数据，本站无法读取设备本地日志或控制官方训练应用。

## 页面多久更新一次？

页面可见时，设备状态通常每 30 秒检查一次，收益每 2 分钟检查一次；全网矿工名单与进度约每分钟检查一次。服务端对矿工名单与进度缓存 60 秒，网络名额缓存 120 秒，任务列表、收益和历史指标缓存 5 分钟。多次检查可能复用仍有效的缓存结果。

手动刷新有 15 秒冷却，可请求较新的数据，但仍遵守官方限流和重试等待。页面隐藏时暂停后台轮询。

## 拉取时间与采样时间有什么区别？

拉取时间是该数据源最近一次成功读取的时间；采样时间是官方记录训练统计的时间。成功读取也可能返回较旧的采样，不能仅据此判断机器离线。

## 接口失败后会发生什么？

上次成功的数据会保留，并显示警告和原来的拉取时间。缺失数据仍为未知。收益总额与收益记录可能分别失败，因此一个字段可用，不代表所有收益数据都是最新。

设备数据超过 5 分钟没能成功更新，会提示读取中断。详见 [刷新中断说明](https://iotahome.site/zh/learn/what-refresh-interrupted-means)。[全网数据不完整](https://iotahome.site/zh/learn/network-status-explained) 时会注明成功读取了多少份名单。

## 资料来源与本站实现

- [Macrocosmos · Train at Home](https://iota.macrocosmos.ai/)
- [Macrocosmos · TAH user guide](https://docs.macrocosmos.ai/product-and-services/tah/tah-user-guide)
- [IOTA Watch · source code](https://github.com/molimao/iota)