DeFiLlama 協議監控工具
監控 DeFi 協議的 TVL 下跌、資金輪動、安全性風險與市場機會。
使用時機
- 使用者想要監控或追蹤特定協議（例如：「監控 Aave」、「如果 Uniswap 下跌就提醒我」）
- 使用者要求安全稽核、風險檢查或完整簡報
- 使用者想要輪動警報或市場情緒更新（資金流分析）
- 使用者想檢查協議是否曾被駭（投資組合安全性）
請勿用於一次性查詢，例如「Aave 的 TVL 是多少？」—— 請直接回答此類問題。
可用指令
所有指令均從技能根目錄執行。加上 --json 可取得結構化輸出。
| 指令 | 用途 | 輸出訊號 |
|---|---|---|
python3 scripts/watchdog.py | 檢查 TVL 下跌 | ALERT: 或 HEARTBEAT_OK |
python3 scripts/capital_flow.py | 資金輪動與市場情緒 | ROTATION:、SENTIMENT: 或 HEARTBEAT_OK |
python3 scripts/bridge_monitor.py | 跨鏈橋交易量暴增 | BRIDGE_SURGE: 或 HEARTBEAT_OK |
python3 scripts/metrics_guard.py | 投資組合 vs 近期駭客事件 | EMERGENCY: 或 HEARTBEAT_OK |
python3 scripts/true_growth.py | 聰明錢（TVL 跌但資金流入增） | BULLISH_DIVERGENCE: 或 HEARTBEAT_OK |
python3 scripts/unlocks_monitor.py | 代幣解鎖風險 | DUMP_RISK: 或 HEARTBEAT_OK |
python3 scripts/revenue_guard.py | 營收/手續費成長 | VALUE: 或 HEARTBEAT_OK |
python3 scripts/full_briefing.py | 執行所有檢查 | 所有訊號合併 |
如何回應
當使用者要求檢查時
- 執行對應的腳本
- 解析輸出訊號：
HEARTBEAT_OK= 一切正常ALERT:= TVL 下跌超過閾值EMERGENCY:= 投資組合中的協議曾被駭ROTATION:= 資金在不同的鏈之間移動SENTIMENT:= 風險偏好/趨避訊號BRIDGE_SURGE:= 跨鏈橋交易量暴增（熱門鏈）BULLISH_DIVERGENCE:= TVL 下跌但資金流入增加DUMP_RISK:= 大量解鎖即將到來VALUE:= 營收成長速度超過價格
- 綜合結果成 2-5 句話，說明發生什麼事及其重要性
警報回覆模式
當偵測到風險訊號時：
- 先點出關鍵發現（TVL 下跌、駭客攻擊、資金輪動）
- 加入其他訊號的脈絡：
- 如果是
ALERT:→ 執行capital_flow.py檢查是輪動還是協議本身問題 - 如果有投資組合 → 執行
metrics_guard.py檢查駭客風險 - 視情況執行其他檢查（解鎖、資金流入、營收）以獲得更深入的資訊
- 如果是
- 給出明確的行動建議（使用者應該怎麼做？）
綜合範例
不好：「警報：AAVE V3 TVL 下跌 12.3%。輪動：以太坊上的穩定幣供應減少 1.5%。」
好：「Aave V3 TVL 在最近期間下跌了 12.3%。這似乎與整體資金輪動有關——以太坊上的穩定幣供應正在減少，而 Solana 正在成長。這並非協議特定的風險，但應留意資金是否持續外流。」
常見使用者需求
「如果 [協議] 下跌超過 X%，請提醒我」
- 確認
config.json中的watch_list（使用 DefiLlama 的 slug）和threshold設定正確 - 說明監控工具會依照排程執行，當超過閾值時會觸發警報
「執行安全稽核」/「完整簡報」/「風險檢查」
- 執行
python3 scripts/full_briefing.py - 將所有輸出訊號整合成一個敘述
「有資金輪動嗎？」/「市場情緒更新？」
- 執行
python3 scripts/capital_flow.py - 回報
ROTATION:和SENTIMENT:訊號，若無則說「無顯著變動」
「我的協議有被駭的嗎？」
- 執行
python3 scripts/metrics_guard.py - 需要
assets/portfolio.json（DefiLlama 協議 ID） - 若發現
EMERGENCY:請立即回報
「現在手動檢查」
- 執行
python3 scripts/watchdog.py - 回報結果或確認「全部在閾值內」
設定
檔案： 技能根目錄下的 config.json
主要設定：
watch_list：DefiLlama 協議 slug 陣列（例如["aave-v3", "uniswap", "lido"]）threshold：觸發警報的小數閾值（例如0.10= 下跌 10%）risk_level："high"（5%）、"standard"（10%）、"low"（15%）- 功能開關：
capital_flow.enabled、metrics_guard.enabled、bridge.enabled等
投資組合追蹤： 建立 assets/portfolio.json，填入 DefiLlama 協議 ID，用於駭客與解鎖警報。
進階功能： 部分功能（資金流入、解鎖）需要在環境變數中設定 DEFILLAMA_PRO_API_KEY。大部分功能不需要 API 金鑰即可使用。
重要說明
- 協議 slug 必須與 DefiLlama 完全一致（請至 defillama.com/protocols 確認）
- 腳本會將狀態儲存在
assets/目錄下（TVL 歷史、跨鏈橋資料等） - 所有腳本會以結束碼 0 退出，並將輸出印到 stdout——請解析訊號行
- 延遲時間：警報會在 DefiLlama 更新後（約 5-15 分鐘）加上下一個檢查週期後送達
- 不需要 API 金鑰即可使用：TVL、資金流動、駭客事件、跨鏈橋、營收
- 需要 Pro API 金鑰的功能：資金流入（true_growth）、解鎖（unlocks_monitor）
輸出風格
- 保持簡潔： 2-5 句話的摘要
- 直接切入重點： 「Aave 下跌 12%」，而不是「系統偵測到……」
- 提供脈絡： 說明這是資金輪動、駭客風險還是協議本身的問題
- 沒事就不提： 除非使用者要求狀態，否則不要回報
HEARTBEAT_OK - 優雅處理錯誤： 如果腳本執行失敗，請告知使用者手動執行