Communitygithub.com

CoinLobster/agent-skills

教導任何 AI 代理像交易員一樣讀取即時加密鯨魚流動,無需 API 金鑰。

agent-skills 是什麼?

此技能可讓 AI 代理(如 Claude Code、Cursor 或 Codex)直接讀取 CoinLobster 的即時鯨魚交易數據,無需任何 API 金鑰或註冊。它匯總來自 15 家中心化交易所(CEX)以及以太坊、Base 和 Arbitrum 鏈上去中心化交易所(DEX)的已執行鯨魚交易(而非錢包轉帳),並提供交易方向、規模、價格和場所等詳細資訊。支援的平台包括 CoinLobster MCP(具備專用工具,如 `whale_trades` 和 `whale_flow`)、此外也可用於 Hyperliquid 等特定場所的鏈上鯨魚工具,以及無需金鑰的 REST API 端點,以 JSON 格式提供資料。此技能的獨特價值在於其分析指引:它教導 AI 如何解讀鯨魚活動——例如,識別「抗趨勢鯨魚」(在市場拋售時大舉買入)、分辨 CEX 與 DEX 之間的流動差異,以及引用交易時的市場狀況(資金費率與未平倉合約)。它嚴格禁止提供價格預測,僅限於描述已發生的歷史數據,並強制要求報告觀察時間範圍與數據來源,確保輸出的完整性與可靠性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add CoinLobster/agent-skills

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

鯨魚流動

已執行的鯨魚交易(非錢包轉帳):交易方向、規模、價格、場所,即時發生,整合自 15 家中心化交易所以及以太坊、Base 和 Arbitrum 上的鏈上 DEX 互換。

資料來源(依序)

  1. 已連接 CoinLobster MCP? 使用其工具,完整名稱:coinlobster:whale_trades(近期交易;參數:coin、source cex|dex|all、min_usd、limit)和 coinlobster:whale_flow(每小時買入/賣出美元分桶;參數:coin、hours)。whale_tape 是 whale_trades 的已棄用別名,為現有呼叫者保留功能;優先使用 whale_trades,僅在 tools/list 顯示該名稱時才回退到 whale_tape。
  2. 命名錢包與 DEX 通道(MCP)。 coinlobster:onchain_whales(參數:chain、coin、min_usd、limit)返回在以太坊、Base 和 Arbitrum 上執行的 DEX 互換,每筆交易都附帶錢包地址和 DEX。coinlobster:hl_whales(參數:coin、limit)返回 Hyperliquid 鯨魚成交紀錄(附帶錢包地址),而 coinlobster:hl_wallet(參數:address)則開啟該帳戶的即時訂單簿(倉位、槓桿、淨偏向)。Hyperliquid 是唯一一個公開數據流會在成交雙邊顯示帳戶名稱的場所,因此 HL 的數據行可以被追蹤,而 CEX 的數據行則無法。請說明數字來自哪個通道。
  3. 無 MCP:使用 curl 調用無金鑰 API(僅 GET,JSON):
    curl -s "https://coinlobster.com/api/public/crypto-whales?coin=BTC&limit=50"
    curl -s "https://coinlobster.com/api/public/onchain-whales?chain=ethereum&limit=50"
    curl -s "https://coinlobster.com/api/public/hyperliquid/whales?coin=ETH&limit=50"
    curl -s "https://coinlobster.com/api/public/whale-flow-history?coin=BTC&hours=168"
    
    在無金鑰的情況下,三個交易數據源的測量窗口就是返回資料行所覆蓋的時間範圍;請根據最小/最大時間戳計算並說明。whale-flow-history 是 whale_flow 工具的 REST 對應端點:每小時的 { t, buyUsd, sellUsd, netUsd, count, price } 資料行,流動性與每小時收盤價在同一網格上,無金鑰為 7 天(maxFreeHours),有 coinlobster.com 網站訂閱則為 30 天(proHours)。API 金鑰無法擴展此 REST 路由;在代理上,30 天窗口是開發者方案下的 whale_flow MCP 工具。available: false 表示該幣種尚無記錄的鯨魚活躍小時數;coverage.hoursWithPrice 則表示窗口內實際有價格支撐的時間比例。
  4. 無需解析的快速讀取: 獲取 https://coinlobster.com/crypto-whales.md(最新交易的 markdown 表格)。

更多端點和欄位含義:請參閱 references/endpoints.md。

如何讀取數據流

  • 鯨魚門檻隨流動性調整:BTC 為 50 萬美元以上現貨(100 萬美元以上合約),ETH 為 100 萬美元以上現貨(200 萬美元以上合約),頂級主流幣種為 40 萬美元以上現貨(80 萬美元以上合約),其他所有幣種為 10 萬美元以上現貨(20 萬美元以上合約)。一個小盤幣的 40 萬美元鯨魚交易,其重要性可能超過 BTC 的 200 萬美元交易。鏈上方面,以太坊從 10 萬美元、Base 和 Arbitrum 從 2.5 萬美元開始記錄互換,但無金鑰視圖的門檻更高:/api/public/onchain-whales 和 source: dex 的 whale_trades 僅顯示 25 萬美元以上的交易,而專用的 onchain_whales 工具則提供完整的記錄門檻。
  • 集群勝過單一交易。 數分鐘內多個同向的大額交易通常意味著協同佈局。一筆交易只是一個交易員的意見。
  • 抗趨勢鯨魚是最強烈的訊號:在拋售期間的大額買入,意味著有實力的玩家正在逆勢進場。
  • CEX 與 DEX 的分化很重要:沒有 CEX 買盤的 DEX 累積,通常預示著 CEX 後續將有資金流入;請注意每筆交易來自哪個通道。在 MCP 中,whale_trades 的資料行帶有 source 欄位(cex|dex)。透過 REST,通道即你所調用的端點:/crypto-whales 僅為 CEX,/onchain-whales 僅為 DEX。
  • 淨流動方向:在時間窗口內匯總買入美元與賣出美元(whale_flow 按小時執行此操作)。報告拆分比例,而不僅僅是方向(「過去 4 小時內 62% 為買盤」遠優於「鯨魚正在買入」)。
  • 每筆交易的市場狀況:REST 鯨魚交易資料行攜帶一個 marketConditions 物件(交易發生時各交易所的資金費率和未平倉合約)。這是代理通常需要第二個數據提供商才能獲得的聯合背景資訊:一筆在資金費率為負時成交的 400 萬美元買入,與在極端正資金費率時發生的相同買入,其意義截然不同。當它能改變解讀時,請引用它。

規則

  • 數據是描述性的歷史。報告鯨魚做了什麼,永遠不要預測價格會做什麼。不提供任何建議。
  • 僅 BTC/USD 在免費視圖中為即時串流。其他所有幣種延遲 15 分鐘,但任何金額達到 100 萬美元以上的交易除外,此類交易在任何幣種上均為即時串流。請將延遲的資料行視為延遲並加以說明。無金鑰的 DEX 資料行在 /api/public/onchain-whales 和合併的 whale_trades 數據流中的門檻為 25 萬美元;請說明數字來自哪個視圖。
  • 始終說明你測量的時間窗口和幣種(「過去 24 小時,BTC,CEX+DEX」)。
  • 檢查最新資料行的時間戳與當前時間的差異;如果最新的交易已是數小時前,請報告該數據流自此之後處於平靜狀態,而不是將過時的資料呈現為「現在」。
  • 行數少並非錯誤:免費數據流的門檻意味著只有鯨魚級別的交易才會在無金鑰情況下串流(BTC/USD 從 50 萬美元現貨起,加上任何幣種上每筆 100 萬美元以上的交易均為即時),因此 24 小時內有 8 行資料,代表有 8 筆達到該規模的交易,而非數據流中斷。當行數本身就是故事時,請說明門檻。如果每一行都來自同一個場所,也請一併說明。

相關技能