CryptoToolkit (ct)

五合一鏈上投資工具，整合 Smart Money Tracker、Token Safety Scanner、Cross-Chain DEX Price Scanner、DeFi Yield Scanner、Wallet PnL Analyzer。

---

安裝

pip install requests

# 或安裝成系統指令（之後直接用 ct 而不是 python ct.py）
pip install -e .

---

快速開始

# Skill 1：找聰明錢在買什麼
python ct.py smart-money --chain bsc

# Skill 2：掃描代幣安全性
python ct.py safety --token 0x1234... --chain bsc
python ct.py safety --token CAKE --chain bsc

# Skill 3：查跨鏈價差
python ct.py dex --token USDC
python ct.py dex --scan-alpha

# Skill 4：查 DeFi 收益
python ct.py yield --token USDC
python ct.py yield --scan-stablecoins

# Skill 5：查錢包持倉與盈虧
python ct.py wallet --address 0xAb58... --chain eth
python ct.py wallet --address 0xAb58... --all-chains

# 一條龍：全流程自動跑
python ct.py pipeline --chain bsc

---

Skill 1 — Smart Money Tracker

追蹤聰明錢（大戶、機構）的買入動向，分析加速度與共識度。

# 基本掃描（BSC 鏈，24h 資料）
python ct.py smart-money --chain bsc

# 跨維度共振檢測（同時出現在 smart money + 社群熱度 + trending + meme）
python ct.py smart-money --chain bsc --resonance

# 其他鏈
python ct.py smart-money --chain eth
python ct.py smart-money --chain base

# JSON 輸出
python ct.py smart-money --chain bsc --json

輸出欄位說明：

欄位	說明
24h Inflow	過去 24 小時聰明錢淨流入金額
Traders	買入的獨立智能錢包數量（越多越有共識）
Accel	加速度：ACCEL=流入在加速 / STEADY=持平 / DECEL=在降速
Consensus	共識度：VERY HIGH / HIGH / MEDIUM / LOW / MINIMAL
Signals	--resonance 模式下顯示，代幣同時出現的信號維度

---

Skill 2 — Token Safety Scanner

用 GoPlus Security API 掃描代幣合約，偵測蜜罐、貂皮拉、高稅等風險。

# 用合約地址掃描
python ct.py safety --token 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 --chain bsc

# 用 symbol 掃描（自動查合約地址）
python ct.py safety --token CAKE --chain bsc
python ct.py safety --token USDC --chain eth

# JSON 輸出
python ct.py safety --token CAKE --chain bsc --json

評分說明（0–100，越高越安全）：

評級	分數	說明
SAFE	80–100	無明顯風險
CAUTION	60–79	有輕微風險，需注意
RISKY	40–59	存在明顯風險旗標
DANGER	0–39	高風險，建議迴避

常見 Flags：

• HONEYPOT DETECTED — 買得進賣不出
• Owner can mint unlimited tokens — 可無限增發
• Hidden owner detected — 隱藏合約擁有者
• LP not locked — 流動性未鎖定，可能 rug pull

---

Skill 3 — Cross-Chain DEX Price Scanner

查同一個代幣在不同鏈上的價格差異，找套利機會。

# 查單一代幣跨鏈價差
python ct.py dex --token USDC
python ct.py dex --token CAKE

# 指定要比較的鏈（逗號分隔，使用 chain ID）
python ct.py dex --token USDC --chains 56,1,8453

# 批次掃描 Binance Alpha 代幣清單
python ct.py dex --scan-alpha

# 設定最低價差門檻（預設 0.5%）
python ct.py dex --scan-alpha --min-spread 1.0

# JSON 輸出
python ct.py dex --token USDC --json

可執行套利的條件（兩個都要滿足）：

• 價差 > 0.5%（覆蓋橋接費 + gas）
• 買賣兩側流動性都 > $100K

---

Skill 4 — DeFi Yield Scanner

用 DefiLlama 資料找最佳 DeFi 收益機會。首次執行會下載 ~3MB 資料，之後快取 30 分鐘。

# 查某代幣的最佳收益池
python ct.py yield --token USDC
python ct.py yield --token ETH

# 只看單幣池（排除 LP 組合）
python ct.py yield --token USDC --single-only

# 指定鏈篩選（使用 DefiLlama 的鏈名稱）
python ct.py yield --token USDC --chains Ethereum,Arbitrum

# 掃描主流穩定幣最佳安全收益
python ct.py yield --scan-stablecoins

# 比較同一協議在各鏈的收益
python ct.py yield --token USDC --compare aave-v3

# JSON 輸出
python ct.py yield --token USDC --json

Risk 欄位說明：

風險	條件
LOW	TVL > $500M + 在白名單協議
MEDIUM	TVL > $10M + 在白名單協議
HIGH	其他

白名單協議包含：aave-v3/v2、compound-v3/v2、lido、curve-dex、venus、pancakeswap-amm-v3、yearn-finance、beefy 等主流協議。

---

Skill 5 — Wallet PnL Analyzer

查任何錢包地址的持倉、總價值、24h 漲跌，以及特定代幣的盈虧。

# 查單鏈持倉
python ct.py wallet --address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B --chain eth
python ct.py wallet --address 0xAb58... --chain bsc

# 掃描全部支援的鏈
python ct.py wallet --address 0xAb58... --all-chains

# 計算特定代幣盈虧（需提供你的平均買入價）
python ct.py wallet --address 0xAb58... --chain bsc --token CAKE --cost 2.50

# JSON 輸出
python ct.py wallet --address 0xAb58... --chain eth --json

注意事項：

• PnL 計算不含 gas 費、橋接費、稅金、滑點
• 空投的垃圾幣（dust < $0.01）會自動過濾
• --cost 是你的平均買入成本（美元），需自行提供

---

Pipeline — 一條龍工作流

自動串接所有 skill：找聰明錢買什麼 → 安全掃描 → 查跨鏈價差 → 查收益機會。

# 完整工作流（BSC）
python ct.py pipeline --chain bsc

# 只看前 3 個結果
python ct.py pipeline --chain bsc --top 3

# 從指定代幣開始（跳過 smart money 發現步驟）
python ct.py pipeline --token CAKE

# JSON 輸出
python ct.py pipeline --chain bsc --json

---

支援的鏈

輸入方式	鏈	Chain ID
bsc	BNB Smart Chain	56
eth / ethereum	Ethereum	1
base	Base	8453
arb / arbitrum	Arbitrum	42161
polygon / matic	Polygon	137

鏈名稱不分大小寫，也可以直接用 Chain ID（如 --chain 56）。

---

資料來源

來源	認證	用途
Binance Web3 API	不需要	Smart money、trending、social hype、代幣搜尋、錢包持倉
GoPlus Security API	不需要	代幣合約安全掃描
DefiLlama Yields API	不需要	DeFi 收益池資料

全部免費，不需要 API key。

---

快取

DefiLlama 池子資料（~3MB）快取在 ~/.cryptotoolkit/cache/，TTL 30 分鐘，避免重複下載。

---

工作流整合

Smart Money      Token Safety     DEX Scanner      Yield Scanner    Wallet PnL
找聰明錢      →  確認代幣安全  →  找最便宜的鏈  →  找收益機會    →  追蹤你的結果
在買什麼         再入場              買入             入場後              盈虧

用 ct pipeline 一鍵跑完全流程。

---

免責聲明

本工具僅供資訊參考，不構成投資建議。PnL 計算不含 gas、稅金或滑點。投資前請自行研究（DYOR）。

---

License

MIT