24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/api/signal/backtest/:coin
GET可用

信號回測結果

信號回測結果（僅 BTC / ETH）

GET/api/signal/backtest/:coin

請求

查詢參數

名稱型別必填預設值可用值說明
coin pathstring必填—BTC, ETH幣種；其他值回傳 400。 範例: BTC

標示為「path」的參數屬於 URL 的一部分。

請求範例

curl -s "https://www.coinboss.com/api/signal/backtest/BTC"

回應欄位

欄位表由真實回應產生，因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素，{*} 代表以動態名稱（例如幣種或交易所）為鍵的物件。

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
coinstring—幣種代號，大寫（例如 BTC）。
backtest_basisstring—回測統計數據所依據的幣種（`ETH`）。
basis_note_codestring—所請求的幣種即為回測幣種時為 `basis_native`；以 ETH 的統計數據呈現其他幣種時為 `basis_borrowed`。
basisstring—合約價格減現貨價格，或基差區塊。
note_codestring—固定代碼 `eth_only_basis`：此回應中的每項統計數據皆來自 ETHUSDT 的歷史資料。
dailyobject—每日數值。
daily.datasetobject—每日統計數據所依據之日 K 線歷史的規模與日期範圍（完整歷史與近期時間視窗）。
daily.dataset.bars_fullnumbercount完整歷史中的日 K 線根數。
daily.dataset.range_fullstring—完整歷史的起訖日期，以文字表示。
daily.dataset.bars_recentnumbercount近期時間視窗中的日 K 線根數。
daily.dataset.range_recentstring—近期時間視窗的起訖日期，以文字表示。
daily.dataset.srcstring—來源。
daily.baselineobject—在任一天買入並持有 30 天的參考結果，分別針對完整歷史與近期時間視窗。
daily.baseline.fullobject—完整解析度的資料。
daily.baseline.full.nnumber—計入的項目數。
daily.baseline.full.hold30_winratenumber%完整歷史中所有 30 天持有期以獲利收場的比例。
daily.baseline.full.hold30_pfnumberratio完整歷史中所有 30 天持有期的獲利因子：獲利總和 ÷ 虧損總和的絕對值。
daily.baseline.recentobject—最近的項目。
daily.baseline.recent.nnumber—計入的項目數。
daily.baseline.recent.hold30_winratenumber%近期時間視窗中所有 30 天持有期以獲利收場的比例。
daily.baseline.recent.hold30_pfnumberratio近期時間視窗中所有 30 天持有期的獲利因子：獲利總和 ÷ 虧損總和的絕對值。
daily.timingobject—買入持有的報酬率與簡單趨勢過濾規則的比較，分別針對完整歷史與近期時間視窗。
daily.timing.fullobject—完整解析度的資料。
daily.timing.full.buy_hold_pctnumber%完整歷史的買入持有報酬率，自第 210 根 K 線起計算。
daily.timing.full.above_ema200_pctnumber%完整歷史中僅在收盤價高於 200 日 EMA 的日子持有的報酬率。
daily.timing.full.below_ema200_pctnumber%完整歷史中僅在收盤價低於 200 日 EMA 的日子持有的報酬率。
daily.timing.full.ema20_gt_ema50_pctnumber%完整歷史中僅在 20 日 EMA 高於 50 日 EMA 期間持有的報酬率。
daily.timing.full.days_abovestring—「收盤價高於 EMA200」規則在完整歷史中的文字 `days held/total days`（持有天數/總天數）。
daily.timing.full.days_faststring—「EMA20 高於 EMA50」規則在完整歷史中的文字 `days held/total days`（持有天數/總天數）。
daily.timing.recentobject—最近的項目。
daily.timing.recent.buy_hold_pctnumber%近期時間視窗的買入持有報酬率。
daily.timing.recent.above_ema200_pctnumber%近期時間視窗中僅在收盤價高於 200 日 EMA 的日子持有的報酬率。
daily.timing.recent.below_ema200_pctnumber%近期時間視窗中僅在收盤價低於 200 日 EMA 的日子持有的報酬率。
daily.timing.recent.ema20_gt_ema50_pctnumber%近期時間視窗中僅在 20 日 EMA 高於 50 日 EMA 期間持有的報酬率。
daily.timing.recent.days_abovestring—「收盤價高於 EMA200」規則在近期時間視窗中的文字 `days held/total days`（持有天數/總天數）。
daily.timing.recent.days_faststring—「EMA20 高於 EMA50」規則在近期時間視窗中的文字 `days held/total days`（持有天數/總天數）。
daily.signalsobject—信號項目。 動態鍵: bull_regime,bear_regime,multi_long,fast_filter,pullback_add,streak5_up
daily.signals.{*}object—信號項目。
daily.signals.{*}.holdstring—對應表的鍵所指信號在回測中採用的持有規則，例如 `30d`、`7d`，或以 ATR 倍數表示的停利／停損規則。
daily.signals.{*}.fullobject—完整解析度的資料。
daily.signals.{*}.full.nnumber—計入的項目數。
daily.signals.{*}.full.winratenumber|null—勝率。
daily.signals.{*}.full.pfnumber|null—獲利因子。
daily.signals.{*}.recentobject—最近的項目。
daily.signals.{*}.recent.nnumber—計入的項目數。
daily.signals.{*}.recent.winratenumber|null—勝率。
daily.signals.{*}.recent.pfnumber|null—獲利因子。
daily.signals.{*}.srcstring—來源。
daily.signals.{*}.full.total_pctnumber%佔總額的比例。 可能不存在
daily.signals.{*}.full.mdd_pctnumber%最大回撤。 可能不存在
daily.signals.{*}.recent.total_pctnumber%佔總額的比例。 可能不存在
daily.signals.{*}.recent.mdd_pctnumber%最大回撤。 可能不存在
m15object—以 15 分鐘 ETHUSDT K 線進行的回測：出場條件以 ATR(14) 倍數表示，已計入來回交易成本。
m15.datasetobject—所用 15 分鐘 K 線歷史的規模、日期範圍與完整度。
m15.dataset.barsnumber—K 線。
m15.dataset.rangestring—請求的時間視窗。
m15.dataset.completenessstring—文字，說明 15 分鐘歷史中實際存在的 K 線數相對於預期的 K 線數。
m15.dataset.srcstring—來源。
m15.signalsobject—信號項目。 動態鍵: knife_25,knife_30,cum8_4,cum16_6
m15.signals.{*}object—信號項目。
m15.signals.{*}.signalsnumber—信號項目。
m15.signals.{*}.nnumber—計入的項目數。
m15.signals.{*}.winratenumber—勝率。
m15.signals.{*}.pfnumber—獲利因子。
m15.signals.{*}.total_pctnumber%佔總額的比例。
m15.signals.{*}.mdd_pctnumber%最大回撤。
m15.signals.{*}.tpnumberx對應表的鍵所指信號採用的停利距離，以 ATR(14) 的倍數表示。
m15.signals.{*}.slnumberx對應表的鍵所指信號採用的停損距離，以 ATR(14) 的倍數表示。
m15.signals.{*}.srcstring—來源。
m15.threshold_scanarray—依觸發買入的單根 K 線跌幅大小分列的回測結果。
m15.threshold_scan[]object—單一跌幅門檻的結果。
m15.threshold_scan[].thnumber%觸發進場的單根 K 線價格漲跌幅（負值）。
m15.threshold_scan[].signalsnumber—信號項目。
m15.threshold_scan[].nnumber—計入的項目數。
m15.threshold_scan[].winratenumber—勝率。
m15.threshold_scan[].pfnumber—獲利因子。
m15.threshold_scan[].total_pctnumber%佔總額的比例。
m15.filter_testarray—−2.0 % 急跌進場各加上一項額外過濾條件（RSI、成交量、EMA200）的結果。
m15.filter_test[]object—單一過濾條件版本的結果。
m15.filter_test[].codestring—代碼。
m15.filter_test[].nnumber—計入的項目數。
m15.filter_test[].winratenumber—勝率。
m15.filter_test[].pfnumber—獲利因子。
m15.filter_test[].total_pctnumber%佔總額的比例。
m15.confirm_testarray—依進場時機分列的結果：立即進場，或等待一至兩根確認 K 線後進場。
m15.confirm_test[]object—單一進場時機版本的結果。
m15.confirm_test[].codestring—代碼。
m15.confirm_test[].nnumber—計入的項目數。
m15.confirm_test[].winratenumber—勝率。
m15.confirm_test[].pfnumber—獲利因子。
m15.confirm_test[].total_pctnumber%佔總額的比例。
m15.cost_testarray—在不同來回交易成本假設下的結果。
m15.cost_test[]object—單一成本假設的結果。
m15.cost_test[].cost_pctnumber%本次執行所假設的來回交易成本，以名義價值的百分比表示。
m15.cost_test[].pfnumber—獲利因子。
m15.cost_test[].total_pctnumber%佔總額的比例。
m15.hour_testarray—−1.5 % 急跌進場依 UTC 時段分列的結果。
m15.hour_test[]object—單一 UTC 時段的結果。
m15.hour_test[].codestring—代碼。
m15.hour_test[].nnumber—計入的項目數。
m15.hour_test[].winratenumber—勝率。
m15.hour_test[].pfnumber—獲利因子。
m15.hour_test[].total_pctnumber%佔總額的比例。
m15.short_sidearray—鏡像交易的結果：在單根 K 線急漲後做空。
m15.short_side[]object—單一急漲門檻的結果。
m15.short_side[].codestring—代碼。
m15.short_side[].nnumber—計入的項目數。
m15.short_side[].winratenumber—勝率。
m15.short_side[].pfnumber—獲利因子。
m15.short_side[].total_pctnumber%佔總額的比例。
weekdayarray—星期幾。
weekday[]object—星期幾。
weekday[].dnumber—日曆日期（UTC）。
weekday[].up_ratenumber—收盤上漲的期間佔比。
weekday[].mean_pctnumber%完整歷史中該星期幾（`d` 1 = 週一 … 7 = 週日）的平均每日價格漲跌幅。
montharray—日曆月。
month[]object—日曆月。
month[].mnumber—日曆月份數字，1–12。
month[].up_ratenumber—收盤上漲的期間佔比。
month[].median_pctnumber%完整歷史各年份中該日曆月份累計價格漲跌幅的中位數。

產生於 2026-11-11 23:01 UTC，依據 1 筆真實回應。

回應範例

/api/signal/backtest/BTC · 真實回應，擷取於 2026-11-13 04:03:35 UTC。 較長的陣列與對應表已截短顯示：month 原有 12 個項目; weekday 原有 7 個項目; m15.signals 原有 4 個項目; daily.signals 原有 12 個項目; m15.cost_test 原有 5 個項目; m15.hour_test 原有 3 個項目。

  • {
    • "success": true,
    • "coin": "BTC",
    • "backtest_basis": "ETH",
    • "basis_note_code": "basis_borrowed",
    • "basis": "ETHUSDT",
    • "note_code": "eth_only_basis",
    • "daily": {
      • "dataset": { … 5 },
      • "baseline": { … 2 },
      • "timing": { … 2 },
      • "signals": { … 2 }
      },
    • "m15": {
      • "dataset": { … 4 },
      • "signals": { … 2 },
      • "threshold_scan": [ … 2 ],
      • "filter_test": [ … 2 ],
      • "confirm_test": [ … 2 ],
      • "cost_test": [ … 2 ],
      • "hour_test": [ … 2 ],
      • "short_side": [ … 1 ]
      },
    • "weekday": [
      • { … 3 },
      • { … 3 }
      ],
    • "month": [
      • { … 3 },
      • { … 3 }
      ]
    }

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
60m
邊緣微快取
10s
時間視窗
固定：日 K 線 2017-08-17 至 2026-07-30，15 分鐘 K 線 2023-01 至 2026-07
資料來源
交易所 ETHUSDT K 線離線回測的靜態摘要；不會重新計算。
交易所覆蓋範圍
僅有 ETH 回測；BTC 回傳相同的 ETH 回測數字。
單位
win rate in percent, profit factor, sample counts
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

可用檢查於 2026-11-13 04:03:35 UTCHTTP 2002 ms結構描述相符

近 30 天可用率

409 次檢查中有 100% 通過

錯誤

所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →

錯誤碼HTTP意義處理方式
INVALID_PARAM400缺少必填參數，或某個值不被接受。已知時，`param` 會指出是哪個參數。請勿原樣重試；請修正請求。
UNAUTHORIZED401已送出 `CB-API-KEY` 標頭，但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。請勿原樣重試。
FORBIDDEN403此路由不屬於公開 API（內部或僅限帳戶使用）。請勿重試。
NOT_FOUND404未知的路由，或所請求的幣種／交易所／基金不存在。請勿重試；請對照目錄檢查路徑與識別碼。
RATE_LIMITED429請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。等待 `Retry-After` 指定的時間後，再以退避策略重試。
INTERNAL500非預期的伺服器錯誤。訊息刻意保持籠統；回報時請附上 `request_id`。幾秒後重試一次；若問題持續，請附上請求 ID 回報。
UPSTREAM_FAILED503此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。以退避策略重試；並查看狀態頁面。
UNAVAILABLE501 / 503資料集暫時尚未就緒（快取預熱中），或此端點目前尚無合法的公開來源。稍後重試；目錄會標示出設計上即無法使用的端點。
REQUEST_FAILED200部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`，而不只是 HTTP 狀態碼。視訊息而定；請當作失敗的請求處理。

試用

GET/api/signal/backtest/:coin可用
參數

string — Coin; other values return 400.

請求 URLhttps://www.coinboss.com/api/signal/backtest/BTC
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。