# IOTA Watch 數據來自哪裡，多久更新一次？

了解 IOTA Train at Home 官網 API 資料來源、刷新週期、採樣時間與舊資料標記，判斷設備狀態和效益是否及時。

- Canonical: https://iotahome.site/zh-TW/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-TW/learn/what-refresh-interrupted-means)。 [全網資料不完整](https://iotahome.site/zh-TW/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)