資料方法說明
SubnetScope 的每個數字都可追溯至公開來源。本頁列出資料來源、計算方式與可能延遲； 每項指標均應顯示來源和最後更新時間，任一資訊缺失時請審慎看待該數值。
| 欄位 | 資料來源 | 更新頻率 | 狀態 |
|---|---|---|---|
| TVL (USD) | DefiLlama /v2/chains 以 defillamaSlug 名稱查詢；DefiLlama 未收錄的網路會顯示無資料與原因。 | 5 分鐘快取 | 即時 |
| 各協議 TVL・分類占比 | DefiLlama /protocols (~7000 entries, 8 MB) 一次取得完整資料流後在伺服器內依鏈篩選。各協議 TVL 加總可能因 DefiLlama 計算規則不同而與鏈級 TVL 略有差異。 | 完整資料流與各鏈篩選皆為 10 分鐘快取 | 即時 |
| 24 小時交易估算・平均出塊時間・24 小時區塊數 | 各鏈 EVM JSON-RPC 取樣 從最新區塊以二分搜尋定位約 24 小時前的區塊，再均勻取樣 8 個區塊。交易估算＝平均每區塊交易數 × 區塊數，並非精確值。 | 5 分鐘快取 | 即時 |
| 每日交易序列（7／14／30 天） | EVM JSON-RPC 延伸取樣估算 以二分搜尋定位每日邊界，再於每日取樣 2 個區塊估算平均交易數。7 天資料每鏈約需 21 次 RPC 呼叫。 | 1 小時快取 | 即時 |
| 24 小時活躍地址・Gas 使用量 | 各鏈瀏覽器或 growthepie（規劃中） 活躍地址無法以少量區塊取樣可靠推算，需要瀏覽器端聚合資料，預計後續提供。 | 規劃為 5 分鐘快取 | M2 |
| 驗證者數量・質押・上線率・權重 | Avalanche P-Chain RPC platform.getCurrentValidators 顯示各驗證者 AVAX 質押、權重、上線率與連線狀態。L1 必須在 subnets.json 補齊 validatorSubnetId；公開 RPC 限流嚴格，正式環境應設定 AVAX_PCHAIN_RPC_URL。 | 10 分鐘快取 | 即時 |
| 質押分布・洛倫茲曲線・吉尼係數 | 由驗證者清單於伺服器內計算 以主網 AVAX 質押或 L1 驗證權重繪製前十名、其他驗證者與洛倫茲曲線，並顯示吉尼係數。 | 沿用驗證者清單的 10 分鐘快取 | 即時 |
| 跨 L1 驗證者 | 依 NodeID 聚合已整理的 L1 識別同時驗證至少兩個已整理 L1 的節點；validatorSubnetId 覆蓋越完整，結果越具代表性。 | 10 分鐘快取 | 即時 |
| 代幣價格・市值・FDV・24 小時與 7 天漲跌 | CoinGecko /coins/markets 依 nativeToken.coingeckoId 查詢；CoinGecko 未收錄時顯示無資料。免費方案每分鐘限 30 次，可設定 COINGECKO_API_KEY 使用 Pro 端點。 | 5 分鐘快取 | 即時 |
| 價格序列（30／90／365 天）・流通與總供應量 | CoinGecko /coins/{id}/market_chart 90 天內使用小時粒度，更長區間使用每日粒度；流通量與總供應量分別由市值÷價格及 FDV÷價格推算。 | 30 天 10 分鐘／90 天 30 分鐘／365 天 60 分鐘快取 | 即時 |
| 比較表（`/compare?ids=…`） | 伺服器端聚合快照 網路選擇編碼於 ?ids=a,b,c，可分享網址並並列比較最多 6 個網路。 | 所有欄位使用同一快照時間 | 即時 |
| Avalanche RWA・協議清單・分類占比 | DefiLlama /protocols filtered to category ∈ {RWA, RWA Lending} 加總 DefiLlama 分類為 RWA 類且部署於 Avalanche 的協議。此值是下限；被歸為收益或流動質押的代幣化資產不會計入。 | 與 DeFi 完整資料流共用 10 分鐘快取 | 即時 |
| RWA 分布資產價值・持有人・30 天轉移量・發行方排行 | rwa.xyz REST API v4 (requires RWA_API_KEY) 這些是 DefiLlama 未提供的 rwa.xyz 指標。未設定 RWA_API_KEY 時顯示缺失原因而非 0；僅使用文件化的 v4 REST API。 | 10 分鐘快取 | 即時 |
L1 資料收錄
L1 識別資訊、RPC 與 CoinGecko ID 維護於packages/subnet-web/data/subnets.json，並透過 PR 審查。新網路會先由以下指令從即時 P-Chain 自動發現： pnpm spike:discover-l1s，再由人工審核並將可信項目合併至 subnets.json。
快取與降級機制
- 頁面讀取聚合快照，不直接呼叫上游；Redis miss 時依序降級至 PostgreSQL 最近資料與中繼資料。
- 上游限流或無法連線時，指標會顯示「無資料」與具體原因，不會捏造數值。
- Avalanche 公開 P-Chain RPC 對每個 IP 嚴格限流，正式環境應設定
AVAX_PCHAIN_RPC_URL使用可靠的專用端點。