Smart Money API
一個專業級的智能API，將衍生品數據、鏈上指標和巨鯨錢包活動匯總為單一信心分數，供您的交易機器人使用。
https://api.smartmoneyapi.com/v1設計原則
四個核心理念塑造了此API的每個端點和每個分數。它們也是其功能範圍的誠實界限——明確了它能做什麼，以及不做什麼。
策略優先，非信號優先。 這不是買/賣信號推送。您提供策略和入場點；API則告訴您周圍的市場結構——衍生品持倉、資金費率、未平倉合約、清算、鏈上資金流動和巨鯨共識——是否與您已計劃的交易一致。
信心評分，非二元預測。 每個回答都帶有分級 confidence （高/中/低）和一個 composite 從-1.0到+1.0的數值。沒有保證，也沒有預言——您得到的是經過校準的市場共識評估及其背後的原因，從而可以根據信心調整倉位大小。
決策支持，非執行建議。 API返回一個確認/減少/跳過的建議和一個倉位乘數，供 您的 邏輯執行。它從不下單，且此處內容不構成財務建議。您仍需自行承擔風險管理、倉位控制和執行責任。
動態指標，非固定保證。 勝率、市場狀態統計和準確率數據均基於滾動樣本計算，並隨市場變化而調整。我們如實公布這些數據，包括表現平庸時。請將每個指標視為當前觀察結果，而非未來承諾。
此API的適用對象
此API專為 加密貨幣機器人、算法和AI代理開發者 設計，這些開發者已擁有來自技術分析策略、機器學習模型、Freqtrade流程、TradingView警報或LLM代理的多空信號，並希望在投入資金前快速獲得 確認/減少/跳過 的預交易決策。
典型流程：您的策略觸發 「做多BTC」 → 您調用 GET /v1/confirm?symbol=BTC&direction=long → 根據 size_mult確認、減少或跳過入場並調整倉位大小。一次調用，單一低延遲JSON回應，無需額外基礎設施。
它 並非 獨立信號生成器、圖表產品或交易場所。若您沒有自己的信號作為閘道，請先查看 績效頁面 了解分數過往表現，再將其接入實盤機器人。
獲取訪問權限
1 — 註冊。 在 註冊頁面 創建免費帳戶（電子郵件/密碼或Google帳號）。免費層級無需信用卡。
2 — 打開儀表板。 您的 儀表板 顯示API密鑰、當前方案和每日配額的實時使用情況。
3 — 複製您的API密鑰。 密鑰前綴為 sm_。將其作為 X-API-Key 請求頭傳遞（參見 身份驗證）。隨時可在 定價頁面 以提高限制並解鎖更多交易對和端點。
規格、SDK與食譜
無論您自行編寫程式碼或交給編碼代理，這裡提供快速整合所需的一切資源。
| 資源 | 功能說明 |
|---|---|
| 食譜 | 常見整合的複製貼上範例——進場前確認、Freqtrade信號過濾、乘數調整倉位、處理402/429錯誤、串接編碼代理等。 |
| OpenAPI規格 | 所有端點的機器可讀OpenAPI定義。可導入Postman/Insomnia、生成客戶端或供LLM使用。位於 github.com/tashiardit/smartmoneyapi-docs. |
| Python客戶端 | 官方Python客戶端庫位於 github.com/tashiardit/smartmoneyapi-python. |
| /llms.txt | LLM友善的API純文字摘要。可提供給Claude、Codex或Cursor使用（參見 編碼代理). |
2分鐘快速入門
步驟1——基礎URL 所有端點均位於：
步驟2——取得API金鑰 免費註冊 （無需信用卡）並從 儀表板複製金鑰。每次請求時需透過 X-API-Key 標頭傳遞。
步驟3——首次呼叫 將以下指令貼至終端機，並將 sm_your_key 替換為儀表板中的金鑰：
預期回應：
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM",
"size_mult": 1.5,
"deriv_score": 0.81,
"onchain_score": 0.68,
"whale_score": 0.73,
"reasons": ["所有交易所資金費率為正", "鯨魚：67%做多共識"]
}
當 confidence 為 HIGH 或 MEDIUM 且 action 為 CONFIRM時，按 size_mult調整倉位規模。此即完整整合流程。詳見 回應欄位 查閱完整欄位說明。
驗證
所有請求需透過 X-API-Key HTTP標頭傳遞API金鑰。
您的API金鑰可於註冊後從 儀表板 取得。請妥善保管金鑰——勿在客戶端程式碼或公開儲存庫暴露。
/v1/ws/ticket 並附上 X-API-Key 標頭，再以返回的票證連接。參見 WebSocket驗證（票證）.Google登入（Firebase驗證）
用戶可透過Firebase驗證使用Google帳號登入。客戶端成功登入後，將Firebase ID令牌兌換為關聯的API會話。系統會自動同步Google身份與API金鑰系統。
請求主體
| 欄位 | 類型 | 說明 |
|---|---|---|
| id_token必填 | 字串 | 客戶端Google登入後取得的Firebase ID令牌 |
範例回應
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}
速率限制
| 方案 | 呼叫/日 | 突發限制 | 數據延遲 |
|---|---|---|---|
| 免費版 | 50 | 2/分鐘 | 60秒 |
| 交易者版 | 1,000 | 20/分鐘 | 即時 |
| 專業版 | 5,000 | 60/分鐘 | 即時 |
| 企業版 | 100,000 | 400/分鐘 | 即時 |
每個回應都包含速率限制標頭： X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
基礎URL
以下所有端點均基於此基礎URL。所有回應均為JSON格式， Content-Type: application/json.
錯誤
錯誤使用標準HTTP狀態碼及一致的JSON主體。請始終根據狀態碼而非回應文本進行分支處理。最常見的三種錯誤：
| 狀態 | 代碼 | 含義與處理方式 |
|---|---|---|
| 401 | unauthorized | 缺少或無效的API金鑰。請檢查 X-API-Key 標頭是否存在且正確。 |
| 402 | payment_required | 該端點或交易對需要比當前金鑰更高級的方案（例如免費金鑰調用WebSocket firehose）。 升級 或退回使用公開端點。 |
| 429 | rate_limit_exceeded | 達到每日或突發限制。請退避並在 X-RateLimit-Reset後重試；請勿頻繁請求。 |
所有錯誤均返回相同結構：
"error": "rate_limit_exceeded",
"message": "每日100次調用限制已達。將於UTC 00:00重置。",
"status": 429
}
完整狀態碼列表（400/403/500/503等）請參閱 錯誤代碼。穩健的集成應將5xx和429視為暫時性錯誤（退避重試），401/402/403視為終端錯誤（需修復金鑰或方案）。
安全最佳實踐
請通過標頭而非URL傳遞金鑰。 始終將 X-API-Key 作為HTTP標頭傳遞。查詢字串中的金鑰（?key=）會被代理、負載均衡器和瀏覽器歷史記錄——傳統的 ?key= auth正因如此不再被WebSocket端點接受。
將金鑰保留在伺服器端。 切勿將API金鑰嵌入客戶端JavaScript、移動應用套件或公共存儲庫。請從環境變量或密鑰管理器加載。若金鑰洩露，請立即輪換。
定期輪換金鑰。 從 儀表板 按計劃重新生成金鑰，若懷疑暴露請立即操作。舊金鑰將在新金鑰簽發時即刻失效。
使用票證連接瀏覽器通訊端。 若需從瀏覽器獲取即時串流，請將金鑰兌換為一次性票證而非直接使用原始金鑰連接——詳見 WebSocket認證（票證）.
與編碼代理/LLM配合使用
正在使用Claude Code、Codex、Cursor或任何LLM編碼代理構建？您可一次性提供代理正確連接此API所需的所有資源。我們發布了兩種機器可讀參考：
| 資源 | URL |
|---|---|
| LLM摘要 | https://smartmoneyapi.com/llms.txt |
| OpenAPI規範 | github.com/tashiardit/smartmoneyapi-docs |
請讓代理讀取 /llms.txt 文件（遵循 llms.txt慣例）獲取簡要概述，再參考OpenAPI規範獲取精確的請求/回應結構。推薦的一行提示：
閱讀 https://smartmoneyapi.com/llms.txt 以及位於
github.com/tashiardit/smartmoneyapi-docs 的 OpenAPI 規格，然後在我的機器人中加入一個交易前
檢查功能，該功能會呼叫 GET /v1/confirm 並跳過所有
非 CONFIRM 動作的入場指令。
查看 Cookbook 獲取一個實際的編碼代理配方。
端點
GET /confirm
核心端點。返回給定交易方向的綜合信心分數和行動建議。在進入任何倉位之前調用此端點。
簡單來說，覆蓋範圍。 /confirm 當前評分 BTC、ETH 和 SOL ——這些代幣擁有足夠的歷史數據來驗證其真實性。衍生品篩選器另外 監控約519個衍生品市場 的資金費率、持倉量及清算數據，而巨鯨追蹤涵蓋600多個錢包。專業版解鎖完整篩選器、導出功能及更廣泛的市場覆蓋範圍； /confirm 隨著每個市場累積可靠的交易記錄，支援的代幣種類會逐步增加。
參數
| 參數名稱 | 類型 | 說明 |
|---|---|---|
| symbol必填 | 字串 | 資產代號。可選值為： BTC, ETH, SOL (Trader+) |
| 方向必填 | 字串 | 交易方向： long 或 short |
| 來源選填 | 字串 | 為您的信號來源標籤（用於分析記錄）。最多 32 個字元。 |
請求範例
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
回應範例
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM_FULL",
"size_mult": 1.5,
deriv_score: 0.81,
onchain_score: 0.68,
whale_score: 0.73,
x_score: 0.0,
factors: {
derivatives: { score: 0.81, weight: 0.40, weighted: 0.324 },
onchain: { score: 0.68, weight: 0.35, weighted: 0.238, source: coinmetrics, available: True },
whale: { score: 0.73, weight: 0.25, staleness_factor: 1.0, weighted: 0.183 }
},
adjustments: { agreement: 0.0, trend: 0.0, news_macro: 0.0 },
weights: { derivatives: 0.40, onchain: 0.35, whale_intel: 0.25 },
coverage: { derivatives: True, whale: True, onchain: True },
reasons: [
所有交易所資金費率均為正值,
LSR偏多：1.42,
鯨魚：67%看漲共識,
MVRV高於1.0 — 鏈上數據看漲
]
}
設計透明，一目瞭然。 每個回應都包含一個 factors 物件，顯示各項 分數 × 權重 = 加權 貢獻值，一個 adjustments 物件用於後置篩選調整， weights 使用的 coverage 映射表。當未設置Glassnode密鑰時，鏈上數據採用 Coin Metrics免費真實數據 (MVRV/交易所資金流動/活躍地址)。這是多因子 共識 評分 — 決策輔助工具， 非勝率保證。.
未追蹤標的誠實標示。 若標的不在衍生品/鯨魚追蹤範圍內，將明確返回 "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" 並附帶 "unsupported":true — 絕不偽造 LOW.
回應欄位
| 欄位 | 類型 | 說明 |
|---|---|---|
| ts | integer | 計算的Unix時間戳 |
| symbol | string | 資產代號 (BTC/ETH/SOL) |
| direction | string | 請求方向 (做多/做空) |
| composite | float | 綜合共識評分 (-1.0極度反向 至 +1.0強力確認)。非勝率指標。 |
| base_composite | float | 應用後置篩選調整前的綜合評分 |
| confidence | string | HIGH / MEDIUM / LOW / VETO / NO_DATA |
| action | string | CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP |
| size_mult | float | 建議持倉規模倍數 (例：0.0 – 1.5) |
| unsupported | bool | true 當標的超出覆蓋範圍時標記 (與NO_DATA配對) |
| deriv_score | float | 衍生品子評分 (-1至1) |
| onchain_score | float | 鏈上子評分 (-1至1) |
| whale_score | float | 鯨魚共識子評分 (-1至1) |
| x_score | float | X/社交情緒子評分 (-1至1)；未使用時為0 |
| factors | object | 分項細目： score × weight = weighted 衍生品/鏈上/鯨魚/x情緒評分 (鏈上包含 source) |
| adjustments | object | 後置篩選帶符號調整項 (共識、趨勢、rsi_1h、新聞宏觀、動量、時段、連續衰減) |
| weights | object | 本次評估實際使用的權重組 |
| coverage | object | {derivatives, whale, onchain} — 哪些項目具備真實數據 |
| reasons | array | 評分的人類可讀解釋說明 |
GET /snapshot
返回指定標的的完整市場快照，包含所有子評分、原始指標及信號值。適用於儀表板與日誌記錄。
GET /onchain
返回原始鏈上指標：MVRV、SOPR、交易所淨流量、實現市值比率及週期位置分類。
GET /v1/derivatives/*
跨交易所衍生品篩選器涵蓋500+種交易對：資金費率熱力圖、未平倉合約排名及多空比信號偵測。前10行公開；完整篩選器需交易員或專業版。端點： /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.
GET /v1/options/*
Deribit提供的BTC與ETH選擇權分析（公開，無需驗證）：買賣權比例、最大痛點及按行權價的未平倉合約。端點： /v1/options/summary, /v1/options/pcr, /v1/options/oi.
GET /v1/etf/*
現貨BTC與ETF每日淨流量及分基金細項（公開）。端點： /v1/etf/flows, /v1/etf/funds.
GET /v1/historical/*
歷史資金費率、未平倉合約、多空比（Binance）及OHLCV（CoinGecko）供回測使用。端點： /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.
GET /v1/dex/*
DexScreener驅動的熱門交易對、代幣搜尋及交易對詳情（公開，無需驗證）。端點： /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.
GET /v1/news/*
新聞情報：政策/地緣政治/加密貨幣新聞按影響分類，外加恐懼與貪婪指數（公開，無需驗證）。端點： /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.
GET /whales
返回巨鯨錢包共識數據：多空分佈、總名義敞口、前10大持倉（僅專業版）及錢包數量。
GET /signals
返回所有監控資產的最新HIGH/MEDIUM信號流。適用於機會掃描。
GET /v1/strategies/*
透明、唯讀的自動交易策略記錄，基於Smart Money信號執行——包括 deriv40 SmartMoney跟單策略（account=9）。所有端點接受 ?account=<id> 查詢參數並返回JSON。無需驗證（公開記錄）。
端點
GET /v1/strategies/stats?account=9— 標題指標：total_trades,win_rate,profit_factor,total_pnl_usdt,account_growth_percent,initial_equity,current_equity,max_drawdown_portfolio,max_drawdown_trade.GET /v1/strategies/equity?account=9— 繪圖用權益曲線：{ initial_equity, curve: [{ time, equity }] }.GET /v1/strategies/trades?account=9&limit=500— 已平倉交易賬簿：陣列（或{trades:[…]}）的symbol,direction,entry_price,exit_price,pnl_usdt,pnl_percent,pnl_percent_net.GET /v1/strategies/active?account=9— 當前持倉：陣列（或{positions:[…]}）的symbol,side/direction,entry_price,unrealized_pnl.GET /v1/strategies/signals— 策略信號類型細分（每類信號的數量/勝率/平均盈虧）。
過往表現不代表未來結果。數據回填於單一約3個月週期加上即時交易，標註處為未扣費前數值。
GET /export
下載歷史信號數據為CSV供回測。參數： symbol, from （unix時間戳）, to （unix時間戳）。
GET /health
系統健康檢查。返回每個數據源的新鮮度及API總體狀態。無需驗證。
"status": "ok",
"uptime_s": 1209600,
"sources": {
"bybit": { "lag_s": 42, "ok": true },
"binance": { "lag_s": 38, "ok": true },
"hyperliquid": { "lag_s": 61, "ok": true },
"onchain": { "lag_s": 290, "ok": true }
}
}
GET /usage
返回當前API使用統計：今日調用次數、月度總量、配額限制及重置時間。
POST /webhooks
註冊一個HTTPS URL以接收實時簽名事件推送，當監控資產觸發信號時。推送攜帶 X-SmartMoney-Event 標頭及HMAC-SHA256簽名於 X-SmartMoney-Signature，並以退避策略重試最多3次。
請求主體
| 欄位 | 類型 | 說明 |
|---|---|---|
| url必填 | 字串 | 接收事件的HTTPS端點（必須以 https://) |
| events必填 | 陣列 | 事件名稱，例如 ["HIGH","MEDIUM","VETO"] 或 ["*"] |
| symbols必填 | 陣列 | 需過濾的交易對，例如 ["BTC","ETH"] 或 ["*"] |
| secret必填 | 字串 | 您的簽名密鑰， ≥ 16字元 （以雜湊值存儲） |
驗證簽名
HMAC密鑰為您註冊密鑰的SHA-256十六進位摘要。用該密鑰計算原始請求主體的HMAC-SHA256值，並（以恆定時間）比對 X-SmartMoney-Signature. See the Webhook 實作指南.
智能分析
GET /analysis
返回AI驅動的市場狀態分類與信號衝突檢測。分析跨信號一致性，識別衍生品、鏈上數據與大戶數據間的背離，並生成帶有前瞻性風險因素及時間範圍建議的自然語言摘要。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol必填 | string | 資產代碼： BTC, ETH，或 SOL |
範例回應
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "晚期週期 — 信號背離",
"summary": "BTC處於牛市後期階段，鏈上強勢與衍生品過度擴張形成衝突。大戶正在減少持倉，而散戶LSR持續攀升。",
"signal_conflicts": [
"大戶評分看跌而鏈上評分看漲",
"資金費率達3個月高點 — 潛在軋空風險"
],
"risk_factors": ["高資金費率", "未平倉合約背離", "大戶減倉"],
"recommendation": "減少多頭倉位，收緊止損。避免在當前價格上方新建多單。",
"time_horizon": "4h–12h"
}
GET /liquidations
返回 兩種互補視圖：(1) 槓桿預測 levels ——對 強平集群 所在位置的估算；以及(2) realized_heatmap ——從公開交易所WebSocket頻道即時聚合的 實際執行 強平強度（價格×時間）熱力圖： Binance, OKX, Bybit, Bitget, BitMEX當數據流包含該代碼時顯示熱力圖（市場極平靜或剛啟動時可能缺失）。
參數
| 參數 | 類型 | 描述 |
|---|---|---|
| 代幣代號選填 | 字串 | 資產代號（預設 BTC）。實際熱力圖涵蓋活躍交易的永續合約代號。 |
範例回應
"symbol": "BTC",
"cascade_risk": "HIGH",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// 真實執行的強制平倉 — 來自5家交易所的即時數據
"realized_heatmap": {
"window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
"clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
}
}
cascade_risk、最近距離，以及實際總計/分邊數據。 專業方案： 完整預測 levels 加上完整 realized_heatmap （矩陣、每價格群集、每交易所計數）。預測估算回答「停損點在哪」；實際熱力圖顯示「實際被強平的部位」。GET /liquidations/heatmap
公開 價格層級強制平倉熱力圖。返回Coinglass風格的價格×時間矩陣，呈現 真實執行 的強制平倉，按每筆平倉成交價格分桶 — 即時聚合來自公開交易所WebSocket數據流： Binance、OKX、Bybit、Bitget、BitMEX。該 clusters 陣列是實用輸出：按平倉名義價值排序的價格區間，每個標記其主導方向。數據依賴即時串流 — 若代號交易極冷清或閘道剛重啟，將返回結構完整但為空的結果，並附上誠實的 note。顯示的層級僅為真實平倉，絕非估算值。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symboloptional | string | 資產代號（預設 BTC). |
| window_minutesoptional | int | 回溯時間窗口（分鐘）（預設 240，限制在5–1440之間）。 |
| price_bucketsoptional | int | 價格區間數量（預設 50，限制在5–100之間）。 |
範例回應
"symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
"price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
"price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
"matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
"clusters": [
{ "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
"short_notional": 720000.0, "count": 37, "dominant_side": "long" }
],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
"generated_at": 1710940200, "public": true
}
totals.count is 0, clusters 為空，且 note 欄位會說明原因。這是已執行清算的記錄—— 非預測資料。如需「止損點位」的預估，請使用需驗證的 /liquidations 端點。GET /liquidations/onchain
已執行 鏈上DeFi借貸清算 直接從我們本地的 BSC + Avalanche全節點 捕捉——獨立於任何交易機器人。涵蓋BSC上的Venus/Cream和Moolah，以及Avalanche上的AAVE V3/V2、Benqi、BankerJoe、Granary和Vinium。Pro等級額外回傳 at_risk 持倉（依賴機器人，可能不存在）。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| chainoptional | string | bsc 或 avax。省略則查詢所有鏈。 |
| limitoptional | integer | 最大行數（預設100，上限500）。依最新優先排序。 |
範例回應
"chain": "bsc", "count": 2,
"liquidations": [
{ "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
"debt_symbol": "DAI", "repay_usd": 426.15,
"collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
],
"summary": {
"window_hours": 24, "enabled": true,
"by_protocol": { "bsc:Venus": { "count": 61, repay_usd_known: 148230.55 } },
節點: { bsc: { 可達: true, 頭區塊: 89173010, 事件總數: 61 } }
}
}
GET /smart-stop
根據當前清算熱力圖、波動率帶和市場結構計算智能止損水平。返回分層止損建議和根據您的入場價格及風險承受能力校準的止盈建議。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol必填 | string | 資產代號： BTC, ETH，或 SOL |
| direction必填 | string | 持倉方向： long 或 short |
| entry_price選填 | float | 您的入場價格。若省略則預設為當前市價。 |
| risk_pct選填 | float | 最大可接受風險（佔帳戶百分比）。預設值： 2.0 |
範例回應
symbol: BTC,
direction: long,
entry_price: 96420,
stops: {
tight: { price: 95100, note: 低於1小時結構。最適合短線交易。 },
recommended: { price: 93800, note: 低於94K美元的主要清算集群。標準波段止損。 },
wide: { price: 91200, note: 低於4小時需求區。持倉交易止損。 }
},
avoid_zones: [
{ low: 94200, high: 94800, reason: 密集清算集群——高滑價風險 }
],
take_profit_suggestions: [
{ tp1: 98500, tp2: 101000, tp3: 104200 }
]
}
recommended 推薦止損。 專業版方案： 所有三層止損， avoid_zones，以及完整止盈建議。GET /funding-arb
即時識別跨交易所資金費率套利機會。返回帶有預估年化收益、最佳交易所配對及捕捉價差所需對沖操作的排名機會。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| min_spread選填 | float | 需包含的最小資金費率價差（小數形式）。預設值： 0.01 |
| symbol選填 | string | 篩選特定資產。省略以掃描所有支援資產。 |
範例回應
ts: 1710940821,
opportunities: [
{
symbol: BTC,
spread: 0.032,
apr: 84.2,
long_exchange: hyperliquid,
short_exchange: bybit,
action: 做多HYPE / 做空BYBIT,
estimated_profit_8h_usd: 26.4
}
]
}
免費公開版本 無需驗證
無需API密鑰的公開端點返回頂部10個機會及跨交易所即時篩選器，適合嵌入或快速查閱。省略單一資產價差歷史及繁重字段，並從120秒快取提供。若在最新時間窗口內無跨交易所資金價差，則返回空 opportunities 陣列並附帶 note ——絕不偽造數據。
opportunities: [
{
symbol: OGN,
spread_pct: 0.297667,
annualized_apr: 325.95,
long_exchange: bybit,
short_exchange: hyperliquid,
estimated_profit_per_10k: 29.77,
risk_notes: 低價差 — 確保手續費不會侵蝕套利利潤。
}
],
scanned_symbols: 222,
ts: 1783268753,
public: True,
limited: True
}
GET /smart-money/flow
一個質量加權的 巨鯨方向性指數 每個交易對獨立評分 -100 （巨鯨資金傾向做空）至 +100 （傾向做多）。數據來自數千個追蹤的Hyperliquid巨鯨錢包 — 每個錢包按其歷史勝率和盈虧加權，並隨時間遞減。這是 持倉方向指數，非買賣信號或價格預測。 貢獻錢包數不足的交易對會標記 thin 並如實評分。即時頁面： smart-money-flow.html.
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol選填 | string | 單一交易對（例如 BTC）。留空則獲取所有追蹤交易對（按|score|排序）。 |
| window_hours選填 | int | 評分時間範圍，限制在 1..168。預設值 24. |
範例回應
symbols: [
{
symbol: SPX,
score: -90.93,
direction: strong_short,
n_wallets: 26,
long_usd: 184200.0, short_usd: 2410000.0,
quality_weighted: True,
sample_quality: rich,
top_contributors: [ { wallet: 0x31ca…974b, direction: short, value_usd: 5338.25, weight: 0.4948 } ]
}
],
window_hours: 24,
quality_weighted: True,
ts: 1783270000,
note: 質量加權巨鯨持倉方向指數（-100..+100）。非價格預測或買賣信號。
}
top_contributors。錢包權重限制在 [0.25,1.0]；盈虧數據為最新持倉快照的未實現估算值。GET /v1/whales/crowding
綜合 巨鯨持倉與擁擠度分析 每個交易對的跨平台數據，整合自 Hyperliquid + GMX v2 + Jupiter Perps。返回總/淨名義金額、方向性偏差、錢包和交易所數量、持倉集中度（前3佔比+HHI）、加權平均槓桿，以及 爆倉距離分桶 （位於估計爆倉價5%和10%內的名義金額，分多空）。此為 情境指標，非方向性信號。 無法推導的欄位標記為 null 並顯示為 — — 例如 lev_wavg/crowding_index 當無持倉帶槓桿時。爆倉距離為獨立保證金估算值（pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), 非 交易所報告的爆倉價格。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| min_notional選填 | float | 納入統計的最低總名義金額（美元）。預設值： 1000000. |
範例請求
範例回應
ok: True, ts: 1783423500, 最小名義金額: 1000000, n_symbols: 92,
symbols: [
{
symbol: BTC,
gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
n_whales: 414, n_venues: 3,
venues: {
hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
},
conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
crowding_index: 0.003
}
],
caveats: [ 清算距離是隔離保證金的估計值，而非交易所報告的。 ]
}
skew 是 net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1)。只有實際存在的交易場所才會出現在 venues。無槓桿的頭寸會被排除在清算區間之外，而非假設其存在。匿名呼叫者會收到按總額排名前10的symbol（帶有 gated: true）；Trader+ 則會收到完整列表。GET /v1/options/gex
交易商 gamma exposure (GEX) 分析用於 BTC & ETH，實時從公開的Deribit期權鏈計算（無需身份驗證）。返回每個執行價的淨交易商GEX（SpotGamma交易商空頭慣例）， gamma翻轉水平 （累積淨GEX跨越零的執行價）， IV期限結構 （按到期日計算的ATM隱含波動率），以及一個前端到期 IV偏斜 （25Δ代理風險反轉）。GEX機制是 positive （交易商長gamma → 波動抑制）或 negative （波動放大）。完全自包含 — 每次呼叫重新計算，無需存儲DB依賴。
參數
| 參數 | 類型 | 描述 |
|---|---|---|
| symbol可選 | 字符串 | BTC 或 ETH 僅。默認： BTC. |
示例請求
示例響應
"symbol": "BTC", "available": true, "spot": 63203.0,
"net_gex": 18240000.0, "regime": "positive",
"gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
"call_gex": 31200000.0, "put_gex": -12960000.0,
"by_strike": [
{ "strike": 60000, "net_gex": -2100000.0 },
{ "strike": 65000, "net_gex": 4800000.0 }
],
"term_structure": [
{ "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
{ "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
],
"skew": {
"expiry": "8JUL26", "dte": 0.76,
"put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
"risk_reversal": 14.35, "bias": "downside_fear"
}
}
available: false 帶有空面板 — 從不偽造GEX。IV偏斜使用固定的±10%執行價代理25Δ（真正的25-delta需要為每個執行價求解delta）；適用於顯示，記錄為近似值。GET /v1/liquidations/simulate
互動 清算連鎖壓力測試給定一個假設的價格變動，返回估計會被清算的槓桿部位、按價格水平/方向/交易所的強制成交量，以及連鎖深度讀數。下跌行情會清算 多頭 其清算價格位於或高於目標價；上漲行情則清算 空頭 其清算價格位於或低於目標價。合併兩種獨立方法：來自追蹤的Hyperliquid大戶的 實際 槓桿/進場價，加上各交易所的統計OI帶集群（從資金費率推斷群眾槓桿）。所有資訊均明確標註 estimated: true ——無法得知單一帳戶保證金、全倉與逐倉、追加保證金或自動減倉。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol選填 | string | 資產代號。預設值： BTC. |
| move_pct選填 | float | 假設價格變動百分比（負值=下跌，正值=上漲）。預設值： -5. |
範例請求
範例回應
"ok": true, "estimated": true, "symbol": "BTC",
"ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
"triggered_notional_usd": 380000000.0,
"cascade_depth": 0.029, "cascade_bucket": "low",
"by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
"by_side": { "long": 380000000.0, "short": 0.0 },
"clusters": [
{ "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
],
"whale_positions_used": 272, "exchanges": 3,
"realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
"methodology": { "disclaimer": "估計值——無法得知單一帳戶保證金、全倉與逐倉、追加保證金或自動減倉。" }
}
ok: true, empty: true 純文字說明，而非虛假數據。 realized_context 是來自實時強制清算流的年輕成長樣本，僅作為背景呈現——從不使預測「實現」。GET /v1/wallet/{addr}/profile
跨平台 錢包檔案 完全基於實時追蹤大戶部位快照構建。對於追蹤的Hyperliquid大戶，返回當前未平倉部位、未實現損益/風險敞口/部位數量的 時間序列，以及OPEN/CLOSE/FLIP 活動時間軸 （通過比對連續快照重建）、解碼的HL排行榜標籤和公開賬簿摘要。實時頁面： wallet-profiler.html.
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| addr必填 | string | 錢包地址（路徑段），例如 /v1/wallet/0x3bcae23e…/profile. |
| days選填 | integer | 序列與時間軸的回溯天數。預設值： 30. |
範例請求
範例回應
"ok": true, "wallet": "0x3bcae23e…", "tracked": true,
"first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
"hyperliquid": {
"label": { "name": "Andre is back", "score": 74,
"window_pnl_usd": 1307000, 勝率百分比: 71, 交易: 42 },
持倉: [
{ 交易所: hyperliquid, 代幣: ETH, 方向: 空頭,
倉位大小: 1200.0, 入場價格: 1800.0, 未實現盈虧: 34800.0,
槓桿: 20.0, 價值（美元）: 2160000.0 }
],
系列: [ { 時間戳: 1783330000, 未實現盈虧: 42000.0, 風險敞口（美元）: 18400000.0, 持倉: 5 } ],
時間線: [ { 時間戳: 1783400000, 事件: 翻轉, 代幣: ETH,
方向: 空頭, 從方向: 多頭, 價值（美元）: 2160000.0 } ],
摘要: {
未平倉持倉: 5, 盈利中: 3, 虧損中: 2, 多頭: 0, 空頭: 5,
總未實現盈虧: -12000.0, 總風險敞口（美元）: 21000000.0, 混合槓桿: 19.9,
時間窗口（天）: 30, 窗口內快照: 474,
已實現盈虧: None, 已實現盈虧備註: 無法推導 — 僅能看到開倉快照，無法看到平倉成交。
}
}
}
pnl 是 HL 自己的未實現市值標記， value_usd 是未平倉名義價值。 每筆交易的已實現盈虧不可用 （我們只能看到開倉快照，無法看到平倉成交），並顯示為 null / —；時間線上的 CLOSE 事件不帶有盈虧聲明。有效但未追蹤的地址會返回 tracked: false 並帶有備註；無效地址會返回 ok: false, error: "invalid_address" （HTTP 400）。HL 排行榜標籤是 HL 自己在發現時的窗口排名，並非由我們計算。GET /flows
返回跨資產的資金流動數據，顯示 BTC、ETH 和 SOL 在多個時間窗口之間的輪動模式。有助於識別在任何時刻哪個資產正在積累資金，哪個資產正在被分配。
示例回應
時間戳: 1710940821,
資金流動: {
BTC: { 1小時: 142000000, 4小時: 380000000, 12小時: -90000000, 24小時: 220000000 },
ETH: { 1小時: -38000000, 4小時: -110000000, 12小時: 55000000, 24小時: -80000000 },
SOL: { 1小時: 12000000, 4小時: 29000000, 12小時: 18000000, 24小時: 44000000 }
},
檢測到的輪動: [
資金在 4 小時窗口內從 ETH 輪動到 BTC,
SOL 在所有窗口內持續積累
]
}
GET /whale-events
返回在指定回顧窗口內檢測到的重要鯨魚持倉變化 — 開倉、平倉和方向翻轉 — 這些變化來自追蹤的錢包和鏈上地址。
參數
| 參數 | 類型 | 描述 |
|---|---|---|
| 代幣可選 | 字串 | 按資產過濾。省略則顯示所有監控資產。 |
| 重要性可選 | 字串 | 按事件重要性過濾： high, medium，或 all。默認： all |
| 小時可選 | 整數 | 回顧窗口（小時）。默認： 24 |
示例回應
代幣: BTC,
摘要: {
翻轉為多頭: 3,
翻轉為空頭: 1,
新開倉: 7,
平倉: 2
},
事件: [
{
"type": "flip_long",
"wallet": "0xWhale...a4f2",
"direction": "long",
"size_usd": 4200000,
"ts": 1710938400
}
]
}
summary 物件。 專業方案： 完整 events 包含錢包識別碼、規模與時間戳記的資料流。GET /regimes/history
返回指定資產的歷史狀態分類資料。用於回測特定狀態類型的歷史表現、各狀態類型的平均持續時間，以及狀態隨時間變化的轉換過程。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol選填 | string | 資產代號。預設： BTC |
| regime選填 | string | 篩選特定狀態類型，例如 late_cycle_divergence。留空則返回所有狀態。 |
| days選填 | integer | 回溯天數。預設： 30。最大值： 365 |
範例回應
"symbol": "BTC",
"current_regime": "late_cycle_divergence",
"regime_summary": {
"late_cycle_divergence": { "occurrences": 4, "avg_duration_h": 38, "avg_return_pct": -2.1 },
"accumulation": { "occurrences": 6, "avg_duration_h": 72, "avg_return_pct": 5.4 },
"breakout": { "occurrences": 3, "avg_duration_h": 18, "avg_return_pct": 9.2 }
},
"transitions": [
{ "from": "accumulation", "to": "breakout", "ts": 1710850000 },
{ "from": "breakout", "to": "late_cycle_divergence", "ts": 1710915000 }
]
}
/analysis 可根據歷史狀態表現資料驗證策略假設。GET /exchange-health
返回所有監控交易所的即時健康狀態，包含各交易所延遲、錯誤率與資料陳舊指標。無需驗證 — 公開存取端點。
範例回應
"overall_status": "ok",
"ts": 1710940821,
"exchanges": {
"bybit": { "status": "ok", "latency_ms": 42, "error_rate_1h": 0.0, "last_data_age_s": 18 },
"binance": { "status": "ok", "latency_ms": 38, "error_rate_1h": 0.0, "last_data_age_s": 22 },
"hyperliquid": { "status": "degraded", "latency_ms": 310, "error_rate_1h": 0.04, "last_data_age_s": 95 },
"okx": { "status": "ok", "latency_ms": 55, "error_rate_1h": 0.0, "last_data_age_s": 30 }
}
}
GET /sentiment
返回基於衍生品情緒、巨鯨活動、波動率與社群訊號計算的即時恐懼與貪婪指數 (0-100)。包含成分細分與24小時歷史資料供趨勢分析。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol選填 | string | 資產代號。預設值： BTC |
範例回應
"symbol": "BTC",
"score": 72,
"label": "貪婪",
"components": {
"波動性": 65,
"動量": 78,
"衍生品": 70,
"巨鯨活動": 75,
"社群": 68
},
"24小時歷史": [
{ "ts": 1710940800, "score": 68, "label": "貪婪" },
{ "ts": 1710937200, "score": 65, "label": "貪婪" }
],
"ts": 1710940821
}
整合方式
GET /tradingview/setup
回傳您個人化的TradingView整合設定：Webhook網址、驗證密鑰，以及可直接連結Smart Money API的Pine Script指標。將Pine Script複製貼到TradingView，即可在任何圖表疊加我們的訊號。
範例回應
"webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
"webhook_secret": "tvs_a1b2c3...",
"pine_scripts": {
"composite_indicator": "// Smart Money Composite v1\n//@version=5\nindicator(...)...",
"whale_activity": "// 巨鯨活動疊加指標 v1\n...",
"funding_dashboard": "// 資金費率+LSR儀表板 v1\n..."
}
}
POST /tradingview/webhook
接收TradingView警報後，透過 /confirm進行驗證並回傳確認。因TradingView無法發送自訂標頭，請在JSON主體中包含您的webhook secret 密鑰進行驗證（此端點不使用X-API-Key）。回應內容將包裹確認資訊並附加頂層 action 標記 CONFIRMED （系統置信度 HIGH/MEDIUM）或 VETOED.
請求主體
"secret": "your_webhook_secret",
"symbol": "BTC",
"direction": "做多",
"timeframe": "1小時",
"strategy": "EMA交叉",
"price": 67500.0
}
必填欄位： secret, symbol, direction (long|short）。選填： source, timeframe, strategy, price.
個人化設定
GET /preferences
回傳您當前的個人化設定，包含預設交易參數、風險偏好、觀察清單及通知偏好。
透過發送包含以下任意欄位的JSON主體來更新偏好設定。未包含的欄位將保留當前值。
偏好設定欄位
| 欄位 | 類型 | 說明 |
|---|---|---|
| default_trade_size_usd | 浮點數 | 凱利公式與智能停損計算的預設部位大小（美元） |
| risk_tolerance | 字串 | conservative, moderate，或 aggressive |
| default_risk_pct | 浮點數 | 每筆交易預設風險佔帳戶百分比。當 /smart-stop 未提供時供 risk_pct 使用 |
| watchlist | 陣列 | 資產代號排序清單，例如 ["BTC","ETH","SOL"] |
| notification_email | 字串 | 接收警報的電子郵件地址 |
| timezone | 字串 | IANA時區字串，例如 America/New_York |
"default_trade_size_usd": 5000,
"risk_tolerance": "中等",
"default_risk_pct": 1.5,
"watchlist": ["BTC", "ETH", "SOL"]
}
GET /watchlist
返回您配置的觀察清單中所有符號的確認狀態快照和關鍵風險指標。提供多資產概覽，無需為每個符號單獨調用。 /confirm 分開為每個符號。
示例回應
"ts": 1710940821,
"watchlist": [
{
"symbol": "BTC",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "accumulation",
"cascade_risk": "LOW"
},
{
"symbol": "ETH",
"confidence": "MEDIUM",
"action": "REDUCE",
"regime": "late_cycle_divergence",
"cascade_risk": "HIGH"
},
{
"symbol": "SOL",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "breakout",
"cascade_risk": "MEDIUM"
}
]
}
實時串流（即時交換）
從我們自己的BSC和Avalanche節點實時檢測≥500美元的DEX交換。提供兩種傳輸方式：免費/瀏覽器客戶端可用的公共伺服器發送事件（SSE）串流，以及付費層級的低延遲WebSocket即時數據流。事件在包含在區塊內的幾秒內廣播。
公共SSE串流（免費）
無需認證。原生 EventSource 支持所有現代瀏覽器。伺服器發送 swap 事件和定期心跳以保持連接活躍。
es.addEventListener("swap", e => {
const swap = JSON.parse(e.data);
console.log(swap.chain, swap.pair, swap.amount_usd);
});
WebSocket即時數據流（付費）
認證（推薦）： 切勿將您的長期有效密鑰放在URL中 — 它會被代理記錄並保存在瀏覽器歷史記錄中。相反，請將您的密鑰POST到 /v1/ws/ticket 使用安全的 X-API-Key 標頭，然後使用返回的一次性 ticket （有效約60秒，使用一次）打開套接字。可以設置標頭的伺服器端客戶端可以直接在握手時傳遞 X-API-Key 。免費層級密鑰會收到一個 402 payment_required 回應。一個 hello 框架在連接時發送，包含您的層級和廣播閾值。
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. 使用一次性票證打開套接字
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
const swap = JSON.parse(e.data);
if (swap.type === "swap") console.log(swap);
};
WebSocket認證（票證）
原因： 切勿將您的API密鑰放在WebSocket URL中 — 查詢字符串會被代理、負載平衡器記錄並保存在瀏覽器歷史記錄中。相反，請通過正常的認證POST將您的密鑰交換為短期有效、一次性使用的 票證 ，然後使用該票證連接。
流程： POST到 /v1/ws/ticket 帶有您的 X-API-Key 標頭 → 接收 { "ticket": "…", "expires_in": 60 }。然後打開 wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. The ticket is 一次性使用 並將於 ~60秒後過期。可以設置請求標頭的伺服器端客戶端可以改為在WebSocket握手時直接傳遞 X-API-Key ，無需使用票證。
為經過驗證的WebSocket握手生成一次性票證。使用 X-API-Key 標頭進行驗證（您的密鑰不會離開請求標頭）。返回的票證可以在 /v1/ws/live-swaps 上兌換一次，過期前有效。
"https://api.smartmoneyapi.com/v1/ws/ticket"
示例回應
"ticket": "wst_9f3c1a8e4b2d…",
"expires_in": 60
}
回應欄位
| 欄位 | 類型 | 描述 |
|---|---|---|
| ticket | string | 一次性令牌，附加為 ?ticket= 在WebSocket URL上。兌換一次後即失效。 |
| expires_in | number | 票證過期前的秒數（約60）。每次嘗試連接時生成新的票證。 |
注意： 傳統的 ?key= 查詢參數驗證 不再接受 在WebSocket端點上，出於安全原因。請使用票證（瀏覽器客戶端）或 X-API-Key 握手標頭（伺服器端客戶端）。
REST快照
返回滾動緩衝區中最後N個廣播的交換。適用於儀表板在流連接打開前的首次繪製。也可用於： /v1/live-swaps/status 廣播者統計。
事件架構
| 欄位 | 類型 | 描述 |
|---|---|---|
| chain | string | bsc 或 avalanche |
| dex | string | 路由器名稱（例如 pancakeswap_v2, traderjoe）或 unknown_dex |
| swapper | string | 執行交換的錢包的完整0x地址 |
| swapper_short | string | 顯示用的縮寫形式（例如 0xb300…028d) |
| swapper_url | string | 鏈上區塊瀏覽器中交換者的直接鏈接 |
| tx_hash | string | 交易哈希 |
| explorer_url | string | BscScan / Snowtrace上交易的直接鏈接 |
| token_in | string | 賣出的代幣符號（例如 USDT) |
| token_out | string | 買入的代幣符號 |
| amount_usd | number | 交換的美元價值（最低：500美元） |
| pair | string | 格式化的交易對標籤（例如 USDT → USDC) |
| block | number | 交換被挖掘的區塊號 |
| timestamp | number | Unix紀元秒 |
| significance | string | low / medium / high / critical 基於美元大小 |
| seq | number | 單調廣播序列號 — 用於間隙檢測 |
POST /alerts/conditions
創建自定義警報規則，當指定指標超過閾值時觸發。根據您的偏好，警報通過webhook、電子郵件或儀表板通知饋送發送。
返回您配置的所有警報條件列表，包括其ID、定義和當前狀態。
根據ID永久刪除警報條件。
返回最近的警報觸發事件，包括時間戳、匹配條件和觸發時的指標值。
創建警報 — 請求主體
| 欄位 | 類型 | 描述 |
|---|---|---|
| name必填 | string | 此警報的人類可讀標籤（最多64個字元） |
| metricrequired | string | 要監控的指標。請參閱下方的可用指標表。 |
| symboloptional | string | 資產上下文。符號範圍指標（如 funding_rate. |
| operatorrequired | string | 比較運算子： gt, lt, eq, crosses_above, crosses_below |
| thresholdrequired | float | 用於與指標比較的數值 |
| deliveryoptional | string | 傳遞管道，例如 telegram （預設）或 webhook |
| cooldown_minutesoptional | integer | 重新觸發的最小間隔分鐘數（預設60） |
有效指標和運算子的即時列表由 GET /v1/alerts/conditions as available_metrics and available_operators.
可用指標
| 指標 | 描述 |
|---|---|
| funding_rate | 符號的當前資金費率（以小數表示） |
| global_lsr | 符號的全球多空比 |
| long_pct | 符號的淨多頭帳戶百分比 |
| top_trader_lsr | 符號的頂級交易者多空比 |
| taker_ratio | 符號的買入/賣出比率 |
| mvrv | 市場價值與實現價值比率（BTC/ETH） |
| sopr | 花費輸出利潤比率（BTC/ETH） |
| exchange_net_flow | 鏈上交易所淨流量信號 |
| accumulation | 鏈上累積信號 |
| whale_long_pct | 追蹤的鯨魚錢包持有符號多頭部位的百分比 |
| whale_n_wallets | 持有符號部位的追蹤鯨魚錢包數量 |
| composite_long | 符號在多方查詢的綜合評分 |
| composite_short | 符號在空方查詢的綜合評分 |
| funding_spread | 符號的跨交易所資金價差 |
"name": "BTC資金費率飆升",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}
GET /kelly
根據歷史信號表現，返回針對給定符號、信心水平和方向的凱利準則部位大小建議。根據實際勝率確定部位大小，以避免過度槓桿。
參數
| 參數 | 類型 | 描述 |
|---|---|---|
| symbolrequired | string | 資產符號： BTC, ETH，或 SOL |
| confidenceoptional | string | 要建模的信號信心水平： HIGH, MEDIUM，或 LOW。預設： HIGH |
| directionoptional | string | 交易方向： long 或 short。預設： long |
| account_sizeoptional | float | 用於計算的帳戶大小（美元） suggested_size_usd。預設： 10000 |
範例回應
"symbol": "BTC",
"confidence": "HIGH",
"direction": "long",
"win_rate": 0.68,
"avg_reward_risk_ratio": 2.1,
"kelly_fraction": 0.36,
"half_kelly": 0.18,
"suggested_size_usd": 1800,
"samples": 142,
"note": "實際交易建議使用半凱利以考慮估計誤差。"
}
GET /performance
返回API發出的歷史信號準確率統計，按信心等級分類。有助於在投入資金前了解信號的可靠性。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| symbol選填 | string | 按資產篩選。留空則返回所有交易對的綜合統計。 |
| days選填 | integer | 回溯天數。預設值： 30 |
範例回應
"symbol": "BTC",
"period_days": 30,
"by_confidence": {
"HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
"MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
}
}
統計與信號
GET /v1/stats
全站真實績效統計數據來源於 smart_money_confirm 獨立調用結果。返回高與中信心等級的勝率、整體準確率、盈利因子及按交易對細分數據。所有數據均為評分窗口期內樣本；請參閱 calibration.html 了解背景資訊與前瞻性保留方法論。
範例回應
"high_winrate": 0.714,
"high_winrate_n": 14,
"medium_winrate": 0.530,
"medium_winrate_n": 34,
"overall_accuracy": 0.613,
"overall_accuracy_n": 48,
"profit_factor": 1.77,
"avg_win_pct": 4.2,
"winrate_horizon": 24小時,
勝率基準: 獨立確認訊號，24小時內已結算結果,
各幣種勝率: {
BTC: { 勝率: 0.68, 訊號數: 22 },
ETH: { 勝率: 0.55, 訊號數: 18 },
SOL: { 勝率: 0.60, 訊號數: 8 }
},
前瞻性保留測試: {
勝率: 0.59,
高勝率區間: 0.70,
高訊號數區間: 10,
與樣本內數據顯著差異: False
}
}
forward_holdout 此數值為評分模型從未接觸過的數據所產生——請觀察其隨時間的變化。詳見 calibration.html 完整方法論及樣本內/前瞻測試分界說明。GET /v1/signals/performance
跨多個結算週期（4小時、12小時、24小時、72小時）的訊號結果追蹤。返回各週期命中率、總訊號數及按類型細分數據。
參數說明
| 參數 | 類型 | 描述 |
|---|---|---|
| days選填 | 整數 | 回溯天數。預設值： 30 |
| signal_type選填 | 字串 | 按類型篩選，例如 smart_money_confirm 或 regime_flip。留空則包含所有類型。 |
| symbol選填 | 字串 | 按幣種篩選，例如 BTC。留空則統計全幣種。 |
範例回應
signal_type: smart_money_confirm,
symbol: BTC,
days: 30,
total_signals: 48,
時間範圍: {
4小時: { 命中率: 0.65, 已結算: 46 },
12小時: { 命中率: 0.61, 已結算: 44 },
24小時: { 命中率: 0.58, 已結算: 40 },
72小時: { 命中率: 0.54, 已結算: 32 }
},
類型細分: {
聰明錢確認: { 次數: 35, 24小時命中率: 0.61 },
機制轉換: { 次數: 13, 24小時命中率: 0.47 }
}
}
GET /v1/signals/recent
所有監控標的近期發布的HIGH和MEDIUM信號推送。每條包含信號類型、信心等級、方向及可用的結算狀態。
範例回應
signals: [
{
id: 1042,
symbol: BTC,
direction: long,
signal_type: smart_money_confirm,
confidence: HIGH,
composite: 0.74,
ts: 1710940821,
resolved: true,
outcome_24h: win
}
],
count: 50
}
GET /v1/signals/{id}/outcome
透過數字ID查詢單一信號的結算結果。返回各時間範圍(4h/12h/24h/72h)的命中/失敗狀態，以及信號發出時與結算時的價格。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| id必填 | integer | 信號ID（路徑參數），例如 /v1/signals/1042/outcome |
範例回應
id: 1042,
symbol: BTC,
direction: long,
confidence: HIGH,
entry_price: 63200.0,
ts: 1710940821,
outcomes: {
4h: { result: win, price: 64100.0, pct: 1.41 },
12h: { result: win, price: 65200.0, pct: 3.16 },
24h: { result: win, price: 65800.0, pct: 4.11 },
72h: { result: pending, price: null, pct: null }
}
}
GET /v1/confirm-winrate
獲取認證用戶API金鑰的確認信號勝率分析。返回各信心等級的獨立呼叫勝率、盈利因子及按標的統計。需提供有效的 X-API-Key 請求頭。
範例請求
"https://api.smartmoneyapi.com/v1/confirm-winrate"
範例回應
high_winrate: 0.714,
high_n: 14,
medium_winrate: 0.530,
medium_n: 34,
overall_accuracy: 0.613,
overall_n: 48,
profit_factor: 1.77,
winrate_horizon: 24h,
by_symbol: {
BTC: { win_rate: 0.68, n: 22 },
ETH: { win_rate: 0.55, n: 18 }
}
}
Shadow Gate
一個不可變的、僅追加的個人決策分類帳。在執行交易決策之前或之後提交；系統會根據Smart Money引擎計算確認分數並追加一個永久行。使用它來建立一個誠實的、帶時間戳的記錄，顯示API信號與您自己的入場點有多吻合——完全獨立於全球勝率池。免費和交易者層級的回應會刪除證據字段；專業版返回完整的細分。免費層級數據適用層級延遲。
提交一個決策。在 Idempotency-Key 請求頭部是冪等的——重新提交相同的密鑰會返回現有行而不會創建重複項。系統會立即呼叫確認引擎並將結果作為不可變的分類帳行追加。
請求主體
| 字段 | 類型 | 描述 |
|---|---|---|
| symbol必填 | 字串 | 資產符號，例如 BTC |
| side必填 | 字串 | 交易方向： long 或 short |
| strategy_id可選 | 字串 | 呼叫者定義的策略標籤（最多64個字符）。按原樣存儲以用於分組和過濾。 |
示例請求
-H "X-API-Key: sm_your_key" \
-H "Idempotency-Key: my-signal-20260701-001" \
-H "Content-Type: application/json" \
-d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
"https://api.smartmoneyapi.com/v1/shadow-gate/decisions"
示例回應
"id": 318,
"symbol": "BTC",
"side": "long",
"strategy_id": "ema_crossover",
"decision": "CONFIRM",
"confidence": "HIGH",
"composite": 0.74,
"size_mult": 1.5,
"ts": 1710940821,
"resolved": false
}
factors / adjustments 證據欄位。專業版則返回完整的確認細項。免費版有等級延遲——該列會立即寫入，但確認分數可能反映快取中最多60秒前的舊資料。列出您自己的shadow-gate決策，依最新優先排序。所有者範圍限定——僅返回由您的API金鑰提交的決策。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
| limit選填 | 整數 | 最大返回行數。預設值： 50，最大值： 200 |
| cursor選填 | 字串 | 來自先前回應的不透明分頁游標，位於 next_cursor 欄位。首次查詢時請省略。 |
範例回應
"decisions": [
{ "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
{ "id": 317, "symbol": "ETH", "side": 空頭, 決策: SKIP, 信心指數: LOW, 綜合指標: -0.12, 倉位倍數: 0.0, 時間戳記: 1710937000, 已結算: True }
],
計數: 2,
下一游標: None
}
依ID取得單一決策，Pro方案包含完整確認證據。Free與Trailer方案的回應將省略 factors 與 adjustments 部分欄位。若決策屬於不同API金鑰則回傳 403 。
範例回應 (Pro方案)
識別碼: 318,
交易對: BTC,
方向: 多頭,
策略ID: ema_crossover,
決策: CONFIRM,
信心指數: HIGH,
綜合指標: 0.74,
倉位倍數: 1.5,
因子: {
衍生品: { 分數: 0.81, 權重: 0.40, 加權值: 0.324 },
鏈上數據: { 分數: 0.68, 權重: 0.35, 加權值: 0.238 },
巨鯨動向: { 分數: 0.73, 權重: 0.25, 加權值: 0.183 }
},
時間戳記: 1710940821,
已結算: False,
交易結果: None
}
手動標記決策結果。平倉後呼叫此API以記錄最終損益至帳本。結算後的資料不可變更。
請求主體
| 欄位 | 類型 | 說明 |
|---|---|---|
| outcome必填 | 字串 | 交易結果： win 或 loss |
| exit_price選填 | 浮點數 | 平倉價格。僅供參考，若提供將用於計算損益百分比。 |
| pnl_pct選填 | 浮點數 | 實現損益佔倉位比例，例如 3.5 或 -1.2 |
範例回應
識別碼: 318,
已結算: True,
交易結果: 盈利,
平倉價格: 65800.0,
pnl_pct: 4.1,
結算時間: 1711027200
}
錯誤代碼
| 狀態 | 代碼 | 說明 |
|---|---|---|
| 400 | invalid_params | 查詢參數缺失或無效 |
| 401 | unauthorized | API金鑰缺失或無效 |
| 403 | plan_restriction | 當前方案無法使用此端點 |
| 429 | rate_limit_exceeded | 觸發每日或瞬時流量限制 |
| 500 | internal_error | 伺服器錯誤 — 請檢查/health端點狀態 |
| 503 | data_stale | 數據源不可用，返回最後已知數據 |
程式碼範例
Python
r = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": "BTC", "direction": "long"},
headers={X-API-Key: sm_your_key}
)
data = r.json()
print(data["confidence"]) # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0
API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"
def confirm_trade(symbol, direction):
resp = requests.get(
f"{BASE_URL}/confirm",
params={"symbol": symbol, "direction": direction},
headers={"X-API-Key": API_KEY},
timeout=5
)
resp.raise_for_status()
return resp.json()
# 在您的交易循環中：
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
print("跳過 — 信心不足")
else:
size = base_size * signal["size_mult"]
place_order(symbol, direction, size)
JavaScript / Node.js
async function confirmTrade(symbol, direction) {
const params = new URLSearchParams({ symbol, direction });
const res = await fetch(
`https://api.smartmoneyapi.com/v1/confirm?${params}`,
{ headers: { 'X-API-Key': API_KEY } }
);
if (!res.ok) throw new Error(`API 錯誤：${res.status}`);
return res..json()();
}
// 使用方式
confirmTrade('BTC', 'long')..then(data => {
console.log(data.confidence, data.size_mult);
});
cURL
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
# 獲取鯨魚數據
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/whales?symbol=BTC"
# 檢查使用情況
curl -X GET \
-H X-API-Key: sm_your_key \
https://api.smartmoneyapi.com/v1/usage
Freqtrade 整合
透過覆寫以下方法，為任何 Freqtrade 策略添加 Smart Money 確認功能 confirm_trade_entry 方法。
from freqtrade.strategy import IStrategy
class SmartMoneyStrategy(IStrategy):
SM_API_KEY = "sm_your_key"
SM_BASE = "https://api.smartmoneyapi.com/v1"
def confirm_trade_entry(self, pair, order_type,
amount, rate, time_in_force,
current_time, entry_tag, **kwargs):
symbol = pair.split("/")[0]
if symbol not in ["BTC", "ETH", "SOL"]:
return True # 跳過不支援的代幣檢查
try:
r = requests.get(
f"{self.SM_BASE}/confirm",
params={"symbol": symbol, "direction": "long"},
headers={"X-API-Key": self.SM_API_KEY},
timeout=3
).json()
return r.get("confidence") in ["HIGH", "MEDIUM"]
except:
return True # API 錯誤時預設放行
CCXT + Smart Money
exchange = ccxt.bybit({
"apiKey": "YOUR_BYBIT_KEY",
"secret": "YOUR_BYBIT_SECRET"
})
SM_KEY = "sm_your_key"
def smart_trade(symbol, side, amount):
# 先檢查確認信號
conf = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": symbol, "direction": side},
headers={"X-API-Key": SM_KEY}
).json()
if conf["confidence"] not in ["HIGH", "MEDIUM"]:
print(f"跳過 {symbol} {side} — 信心不足。")
return None
adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"訂單已下：{adj_amount} {symbol} {side}")
return order