策略詳情

介面描述

根據 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

請求範例

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'

回應欄位

欄位	類型	描述
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	策略交易標的綁定資訊

version 主要欄位：

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

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	合約面值，可為空

成功回應範例

{
  "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
    },
    "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": {},
    "performanceSegments": {},
    "riskScope": {},
    "simulation": {},
    "symbols": []
  },
  "requestId": "xxx-xxx-xxx"
}

錯誤碼

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