策略詳情

介面描述

根據 ValueScan 策略 ID 查詢當前可用的策略詳情，包括策略資訊、交易標的、業績指標、風險分析和版本資訊。

請求 URL

方法：GET
路徑：/open/v1/strategy/detail

點數消耗

消耗點數：1

請求參數

參數透過 Query String 傳遞，並應按身份驗證文件的 GET 請求規則參與簽章。

參數名	類型	必需	描述
`strategyId`	long	是	ValueScan 策略 ID，可從策略列表介面的 `id` 欄位取得
`language`	string	否	回傳內容語言；支援 `zh-CN`、`zh-TW`、`en-US`、`vi-VN`、`ja-JP`、`ko-KR`，預設 `zh-CN`；請求語言內容暫不可用時回傳 `70005`；不支援的值回傳 `40002`

請求範例

bash

curl --location 'https://api.valuescan.ai/api/open/v1/strategy/detail?strategyId=1001&language=zh-CN' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx'

回應欄位

本文件中的收益率和回撤率均為小數，例如 0.12 表示 12%；時間欄位均為 Unix 秒時間戳，月份欄位除外。

欄位	類型	描述
`strategy`	object	策略基礎資訊，包含 `id`、`name`、`description`、`riskLabel`、`marketType`、業績和訊號狀態
`summary`	object	策略摘要，包含交易標的、槓桿、運行天數、收益指標和淨值趨勢
`version`	object	當前版本詳情
`calculatedMetrics`	object	平台計算指標，包含 `source`、`pointCount`、`totalReturn`、`maxDrawdown`
`analytics`	object	基於策略淨值資料產生的分析結果
`performanceSegments`	object	分階段業績指標，包含回測階段和運行階段資料
`riskScope`	object	風險範圍，包含交易標的、最大槓桿、回測視窗、歷史最大回撤、成本模型和費率依據
`simulation`	object	策略運行概覽，包含運行狀態、起始時間及最新確認淨值等資訊
`symbols`	array	策略交易標的綁定資訊

常用指標欄位路徑：

指標	欄位路徑	說明
最近 30 日最大回撤	`analytics.metrics.maxDrawdown30d`	當前展示淨值最近 30 個 UTC 自然日的最大回撤率
回測階段最近 30 日最大回撤	`performanceSegments.backtest.maxDrawdown30d`	僅在回傳分階段業績時存在
全期最大回撤率	`calculatedMetrics.maxDrawdown`	基於全期展示淨值重新計算
全期最大回撤明細	`analytics.metrics.maxDrawdown`	包含回撤率、峰值、谷值、恢復時間和持續天數

strategy 欄位：

欄位	類型	描述
`id`	long	ValueScan 策略 ID
`name` / `description`	string	策略名稱／描述
`riskLabel`	string	風險等級：`low`、`medium` 或 `high`
`marketType`	string	市場類型：`spot`、`perpetual` 或 `delivery`
`performance`	object	策略業績摘要
`providerStatus`	string	策略資料狀態：`active`、`paused` 或 `retired`
`publishStatus`	integer	策略可用狀態；目前可用策略為 `300`
`signalStatus`	integer	策略訊號狀態
`lastSignalSeq` / `lastSignalTs`	long	最新訊號序號／Unix 秒時間戳，可為空

performance 欄位：

欄位	類型	描述
`navKind`	string	淨值類型：`backtest`、`live` 或 `blended`
`fromTs` / `toTs`	long	統計起始／截止 Unix 秒時間戳
`totalReturn`	number	累計收益率
`cagr`	number	年化收益率
`sharpe`	number	夏普比率
`maxDrawdown`	number	全期最大回撤率

tokens 每項包含 vsTokenId、symbol、name、icon；trend.backtest 和 trend.live 的每個淨值點包含 ts、nav。

summary 在 strategy 基礎上增加 tokens、maxLeverage、avgLeverage、liveSignalDays、backtestCagr、winRate、trend；除趨勢外的數值欄位可為空。

version 主要欄位：

欄位	類型	描述
`id`	long	當前版本記錄 ID
`version`	string	策略版本號
`marketType`	string	市場類型
`navKind`	string	淨值類型
`feeBasis`	string	費率依據
`maxLeverage`	number	最大槓桿
`avgLeverage`	number	平均槓桿
`failureModes`	string	失效場景說明
`remark`	string	備註
`changelog`	array	版本變更記錄
`ruleSpec`	string	策略規則說明
`costModel`	object	成本模型
`selfStats`	object	策略統計資料
`selfMetrics`	object	策略指標資料

詳細欄位參考：

物件	欄位
`version.costModel`	`feeBps`（手續費，bp）、`slippageBps`（滑點，bp）
`version.selfStats`	`tradeCount`、`winRate`、`avgHoldHours`、`profitFactor`、`maxConsecutiveLosses`、`statsBasis`
`version.selfMetrics`	`cagr`、`sharpe`、`maxDrawdown`、`totalReturn`、`annualReturn`、`basis`
`calculatedMetrics`	`source`、`pointCount`、`totalReturn`、`maxDrawdown`
`analytics`	`metrics`、`curves.7d`、`curves.30d`、`curves.all`、`drawdownCurve`、`monthlyReturns`
`analytics.metrics`	`source`、`asOfTs`、`cagr`、`sharpe`、`maxDrawdown`、`maxDrawdown30d`、`winRate`、`profitFactor`、`sortino`、`strategyTotalReturn`、`benchmarkTotalReturn`、`benchmarkExcessReturn`
`maxDrawdown` 明細	`rate`、`peakTs`、`troughTs`、`recoveryTs`、`durationDays`
`curves.7d`、`curves.30d`、`curves.all`	`range`（`7d`、`30d` 或 `all`）、`fromTs`、`toTs`、`returnCurve`（每點包含 `ts`、`returnRate`）
`performanceSegments`	`backtest`；`live.metricFromTs`、`live.metricToTs`、`live.totalReturn`、`live.maxDrawdown`、`live.fee`、`live.funding`、`live.realizedPnl`、`live.unrealizedPnl`、`live.cagr`、`live.sharpe`、`live.closedCycles`、`live.winRate`
`riskScope`	`tokens`、`maxLeverage`、`backtestWindow`（`startTs`、`endTs`、`durationDays`）、`historicalWorstFloatingLoss`、`costModel`（`feeBps`、`slippageBps`）、`feeBasis`
`simulation`	`status`、`startTs`、`simulationFromTs`、`latestConfirmedTs`、`latestConfirmedNav`、`priceStatus`、`latestProvisionalNav`

drawdownCurve 每個點包含 ts、drawdownRate；monthlyReturns 每項包含 month、fromTs、toTs、returnRate。可選的收益、風險、最新淨值與統計欄位可為空。simulation.status 支援 INITIALIZING、RECOVERING、RUNNING、DEGRADED、BANKRUPT；priceStatus 為 FRESH 或 STALE。

simulation 和 performanceSegments 僅在策略具有運行資料時回傳。version、calculatedMetrics、analytics 和 riskScope 在目前策略版本存在時回傳。

symbols 中每項的欄位：

欄位	類型	描述
`symbol`	string	策略交易對符號
`vsTokenId`	long	ValueScan 代幣 ID
`vsTokenSymbol`	string	ValueScan 代幣符號
`vsTokenName`	string	ValueScan 代幣名稱
`vsTokenIcon`	string	ValueScan 代幣圖示
`exchange`	string	交易所
`marketType`	string	市場類型
`productType`	string	產品類型
`exchangeSymbol`	string	交易所交易對符號
`settleCoin`	string	結算幣種
`contractSize`	number	合約面值，可為空

成功回應範例

json

{
  "code": 200,
  "message": "success",
  "data": {
    "strategy": {
      "id": 1001,
      "name": "BTC Trend Strategy",
      "description": "Trend-following strategy for BTC perpetual futures.",
      "riskLabel": "medium",
      "marketType": "perpetual"
    },
    "summary": {
      "id": 1001,
      "tokens": [{"vsTokenId": 1, "symbol": "BTC", "name": "Bitcoin"}],
      "maxLeverage": 3,
      "backtestCagr": 0.25,
      "trend": {"backtest": [{"ts": 1735689600, "nav": 1.0}], "live": [{"ts": 1751328000, "nav": 1.03}]}
    },
    "version": {
      "id": 2001,
      "version": "1.0.0",
      "marketType": "perpetual",
      "navKind": "backtest",
      "maxLeverage": 3
    },
    "calculatedMetrics": {
      "source": "valuescan_recalculated",
      "pointCount": 365,
      "totalReturn": 0.31,
      "maxDrawdown": 0.12
    },
    "analytics": {"metrics": {"source": "valuescan_mixed_nav", "asOfTs": 1751328000, "cagr": 0.25, "sharpe": 1.42, "maxDrawdown": {"rate": 0.12, "peakTs": 1740787200, "troughTs": 1743379200, "recoveryTs": 1746057600, "durationDays": 61}, "maxDrawdown30d": 0.08, "strategyTotalReturn": 0.31}, "curves": {"7d": {"range": "7d", "fromTs": 1750809600, "toTs": 1751328000, "returnCurve": []}, "30d": {"range": "30d", "fromTs": 1748822400, "toTs": 1751328000, "returnCurve": []}, "all": {"range": "all", "fromTs": 1735689600, "toTs": 1751328000, "returnCurve": []}}, "drawdownCurve": [], "monthlyReturns": []},
    "performanceSegments": {"backtest": {"maxDrawdown30d": 0.09}, "live": {"totalReturn": 0.03, "maxDrawdown": 0.02}},
    "riskScope": {"tokens": [{"vsTokenId": 1, "symbol": "BTC", "name": "Bitcoin"}], "maxLeverage": 3, "backtestWindow": {"startTs": 1735689600, "endTs": 1748736000, "durationDays": 152}, "historicalWorstFloatingLoss": {"rate": 0.12}, "costModel": {"feeBps": 6, "slippageBps": 2}, "feeBasis": "Taker fee"},
    "simulation": {"status": "RUNNING", "startTs": 1748736000, "simulationFromTs": 1748736000, "latestConfirmedTs": 1751328000, "latestConfirmedNav": 1.03, "priceStatus": "FRESH", "latestProvisionalNav": 1.031},
    "symbols": []
  },
  "requestId": "xxx-xxx-xxx"
}

錯誤碼

錯誤碼	描述
`40001`	缺少 `strategyId`
`40002`	`strategyId` 參數非法
`50001`	請求的介面不存在或當前不可用
`60001`	呼叫頻率超過限制
`70001`	OpenAPI 點數不足
`70002`	當前使用者的 OpenAPI 存取已被停用
`70004`	策略不存在或當前不可用
`70005`	請求語言的策略內容暫不可用

策略詳情 ​

介面描述 ​

請求 URL ​

點數消耗 ​

請求參數 ​

請求範例 ​

回應欄位 ​

成功回應範例 ​

錯誤碼 ​