腳本使用方式
腳本模式技能 — 先閱讀此文件，再透過 bash 程式區塊呼叫：
python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/birdeye")
from exports import birdeye_token_overview, birdeye_token_security, birdeye_wallet_networth
# SOL 概覽
sol = birdeye_token_overview(address="So11111111111111111111111111111111111111112", chain="solana")
print(json.dumps(sol, indent=2))
EOF
exports.py 中可用的函式：birdeye_token_security、
birdeye_token_overview、birdeye_wallet_networth。請直接閱讀 exports.py
以取得確切的簽章。
Birdeye
多鏈數據供應商，提供代幣情報與錢包分析。涵蓋 Solana + EVM 鏈（Ethereum、Arbitrum、Base 等）。專注於 Birdeye 在安全性分析與投資組合追蹤方面的獨特功能。
函式參考（簽章）
所有函式皆位於 exports.py 中。chain 預設為 solana。支援的 EVM
鏈：ethereum、bsc、polygon、arbitrum、optimism、
base、avalanche、zksync、sui。Solana 的代幣 address 為鑄造地址（例如 SOL = So11111111111111111111111111111111111111112）。
| 函式 | 說明 |
|---|---|
birdeye_token_overview(address, chain='solana') | 全面的代幣數據：價格、市值、完全稀釋估值、供應量、持有者、流動性、24 小時交易量、社交連結。回傳 {data: {...}} 包裝。 |
birdeye_token_security(address, chain='solana') | 安全審計：所有權、可鑄造性、可凍結性、前十大持倉集中度、可變更元數據、rug pull 指標。 |
birdeye_wallet_networth(wallet, chain='solana') | 錢包淨資產 + 代幣明細。wallet = 錢包地址。 |
Birdeye 使用駝峰式命名欄位（marketCap、priceChange24h 等）。
所有回傳資料皆以 {data: {...}} 包裝 — 請透過
result.get('data', {}) 提取。
可用工具（3 個）
代幣情報（2 個工具）
- birdeye_token_security：安全性評分與 rug pull 風險分析
- birdeye_token_overview：全面的代幣數據（價格、交易量、市值、流動性）
錢包分析（1 個工具）
- birdeye_wallet_networth：目前錢包淨資產與投資組合明細
何時使用每個工具
「這個代幣安全嗎？」 → birdeye_token_security
安全性評分、rug pull 風險分析、合約漏洞偵測。
「給我這個代幣的完整資訊」 → birdeye_token_overview
一次呼叫即可取得價格、交易量、市值、流動性與價格變化。
「這個錢包值多少？」 → birdeye_wallet_networth
目前投資組合價值與詳細的代幣明細，包含餘額與價值。
多鏈支援
所有工具皆接受 chain 參數：
- Solana：
solana（大多數查詢的預設值） - EVM：
ethereum、arbitrum、base、optimism、polygon、bsc、avalanche、zksync、sui
鏈選擇指南：
- Solana：最活躍的交易，最適合迷因幣
- Ethereum：藍籌代幣、DeFi 協議
- Arbitrum/Base：L2 交易、低手續費 DeFi
- 請使用代幣/錢包原生所在的區塊鏈
解讀指南
安全性評分
| 分數 | 風險等級 | 行動 |
|---|---|---|
| 90-100 | 非常低 | 可安全交易，合約已驗證 |
| 70-89 | 低 | 通常安全，標準風險 |
| 50-69 | 中 | 謹慎行事，檢查問題清單 |
| 30-49 | 高 | 高風險 — 仔細調查問題 |
| 0-29 | 非常高 | 可能是 rug pull 或詐騙 — 避免 |
常見危險信號：
- 鑄造權限未放棄（擁有者可增發代幣）
- 凍結權限已啟用（擁有者可凍結交易）
- 流動性低（< 1 萬美元 = 高 rug 風險）
- 持倉集中（前十大持有者 > 80% 供應量）
- 無社交連結或網站
代幣概覽指標
價格與市值：當前估值與交易價格 交易量：交易活動反映流動性與關注度 流動性：可用於交易的流動性（越高 = 出場越安全） 價格變化 %：1 小時/24 小時/7 天價格變動
流動性解讀：
- < 1 萬美元：非常高風險，容易被操縱
- 1 萬 - 10 萬美元：中等風險，留意大額出場
- 10 萬 - 100 萬美元：中小額交易流動性良好
-
100 萬美元：流動性強，大額交易較安全
錢包淨資產
總美元價值：以當前價格計算的所有代幣持倉總和 代幣明細：個別持倉的餘額與價值 投資組合集中度：錢包分散程度如何？
投資組合健康指標：
- 高度集中（單一代幣 >80%） = 高風險
- 平衡持倉 = 較佳的風險管理
- 大量未實現獲利 = 可能獲利了結
常見工作流程
代幣盡職調查
- birdeye_token_security — 安全性評分與風險檢查
- birdeye_token_overview — 價格、交易量、市值、流動性
危險信號：安全性評分低（<50）+ 流動性低（<1 萬美元） = rug pull 風險
範例：
使用者：「這個代幣安全嗎？ [Solana 地址]」
1. 檢查 birdeye_token_security → 評分 85（低風險）
2. 檢查 birdeye_token_overview → 50 萬美元流動性、200 萬美元交易量
3. 結果：大致安全，流動性適合交易
錢包分析
- birdeye_wallet_networth — 目前投資組合價值與明細
使用案例：
- 追蹤自己的投資組合價值
- 分析鯨魚錢包
- 監控競爭對手持倉
範例：
使用者：「這個錢包裡有什麼？ [地址]」
1. 檢查 birdeye_wallet_networth → 總價值 4.5 萬美元
2. 明細：60% SOL、25% USDC、15% 迷因幣
3. 結果：平衡的 Solana 投資組合，有穩定幣避險
快速代幣檢查
在交易前快速驗證代幣：
birdeye_token_overview → 一次呼叫取得價格、流動性、交易量
若流動性 < 1 萬美元或交易量 < 1000 美元 → 高風險，謹慎行事
工具詳情
birdeye_token_security
參數：
address（必要）：代幣合約地址chain（選用）：區塊鏈（預設：solana）
回傳：
- 安全性評分（0-100）
- 風險等級
- 偵測到的問題清單
- 合約分析結果
範例：
birdeye_token_security(
address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
chain="solana"
)
birdeye_token_overview
參數：
address（必要）：代幣合約地址chain（選用）：區塊鏈（預設：solana）
回傳：
- 代號、名稱
- 當前價格
- 24 小時交易量
- 市值
- 流動性
- 價格變化（1 小時、24 小時、7 天）
範例：
birdeye_token_overview(
address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
chain="solana"
)
birdeye_wallet_networth
參數：
wallet（必要）：錢包地址chain（選用）：區塊鏈（預設：solana）
回傳：
- 總美元價值
- 代幣持倉明細：
- 代幣代號、名稱
- 餘額
- 當前價格
- 美元價值
- 投資組合佔比
範例：
birdeye_wallet_networth(
wallet="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
chain="solana"
)
注意：錢包 API 有速率限制（每秒 5 次請求、每分鐘 75 次請求）。請間隔請求。
鏈專用注意事項
Solana：
- Birdeye 支援最佳的區塊鏈
- 代幣地址為 base58 編碼
- 交易量最大的在 Raydium、Orca 上
- 用於迷因幣分析與投資組合追蹤
Ethereum：
- 藍籌代幣與 DeFi 協議
- 代幣地址為 0x... 格式
- 較高的 gas 費 = 較少微型交易
Arbitrum/Base：
- 手續費較低的 L2 擴容方案
- 成長中的 DeFi 生態系
- 適合 L2 原生專案
與其他技能的整合
與 CoinGecko 互補：
- Birdeye 用於：安全性檢查、Solana 代幣、錢包分析
- CoinGecko 用於：廣泛市場數據、歷史價格、市值排名
不要重複：每個服務都有其獨特優勢。請利用 Birdeye 的特殊數據（安全性、Solana 專注、錢包追蹤）。
備註
- 需要 API 金鑰：設定
BIRDEYE_API_KEY環境變數 - 速率限制：錢包端點限制為每秒 5 次請求、每分鐘 75 次請求
- 多鏈：對於非 Solana 查詢，務必指定
chain參數 - 安全性評分：自動化分析 — 對於高價值交易請手動驗證
- 即時數據：價格與數據頻繁更新，適合活躍交易決策
限制
- 無趨勢代幣：請使用 CoinGecko 取得趨勢/熱門代幣清單
- 無持有者分佈：無法檢查誰持有代幣
- 無交易歷史：無法查看近期交易
- 無聰明錢訊號：請使用其他來源追蹤鯨魚
- 錢包工具有限：僅提供淨資產（無盈虧、持倉細節或轉帳記錄）
請專注於 3 個可用工具：安全性檢查、代幣概覽與錢包估值。