策略列表
介面描述
分頁查詢當前可用的策略。介面支援按市場類型和風險標籤篩選，並回傳策略基礎資訊、交易標的、業績摘要及淨值趨勢。
請求 URL
- 方法：
POST - 路徑：
/open/v1/strategy/page
點數消耗
- 消耗點數：
1
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
| 參數名 | 類型 | 必需 | 預設值 | 描述 |
|---|---|---|---|---|
pageNum | integer | 否 | 1 | 頁碼，最小值為 1 |
pageSize | integer | 否 | 20 | 每頁數量，範圍 1～100 |
marketType | string | 否 | - | 市場類型；支援 spot、perpetual、delivery，精確匹配 |
riskLabel | string | 否 | - | 風險等級；支援 low、medium、high，精確匹配 |
language | string | 否 | zh-CN | 回傳內容語言；支援 zh-CN、zh-TW、en-US、vi-VN、ja-JP、ko-KR；請求語言內容暫不可用時回傳 70005；不支援的值回傳 40002 |
請求範例
bash
curl --location 'https://api.valuescan.ai/api/open/v1/strategy/page' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--data '{
"pageNum": 1,
"pageSize": 20,
"marketType": "perpetual",
"riskLabel": "medium",
"language": "zh-CN"
}'回應欄位
本文件中的收益率和回撤率均為小數，例如
0.12表示 12%；ts、fromTs、toTs均為 Unix 秒時間戳。
data 為分頁物件：
| 欄位 | 類型 | 描述 |
|---|---|---|
records | array | 當前頁策略列表 |
total | long | 符合條件的總記錄數 |
size | long | 每頁數量 |
current | long | 當前頁碼 |
pages | long | 總頁數 |
records 中每項的主要欄位：
| 欄位 | 類型 | 描述 |
|---|---|---|
id | long | ValueScan 策略 ID，查詢策略詳情時使用 |
name | string | 策略名稱 |
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 | long | 最新訊號序號，可為空 |
lastSignalTs | long | 最新訊號 Unix 秒時間戳，可為空 |
tokens | array | 交易標的列表，包含 vsTokenId、symbol、name、icon |
maxLeverage | number | 最大槓桿，可為空 |
avgLeverage | number | 平均槓桿，可為空 |
liveSignalDays | long | 實盤訊號運行天數，可為空 |
backtestCagr | number | 回測年化收益率，可為空 |
winRate | number | 勝率，可為空 |
maxDrawdown30d | number | 最近 30 個 UTC 自然日內的最大回撤率，例如 0.12 表示 12%；淨值資料不足時為空 |
trend | object | 淨值趨勢，包含 backtest 和 live 陣列；每個點包含 ts、nav |
performance 欄位：
| 欄位 | 類型 | 描述 |
|---|---|---|
navKind | string | 業績所使用的淨值類型：backtest、live 或 blended |
fromTs | long | 統計起始 Unix 秒時間戳 |
toTs | long | 統計截止 Unix 秒時間戳 |
totalReturn | number | 累計收益率，例如 0.25 表示 25% |
cagr | number | 年化收益率 |
sharpe | number | 夏普比率 |
maxDrawdown | number | 全期最大回撤率 |
tokens 中每項的欄位：
| 欄位 | 類型 | 描述 |
|---|---|---|
vsTokenId | long | ValueScan 代幣 ID |
symbol | string | 代幣符號 |
name | string | 代幣名稱 |
icon | string | 代幣圖示 URL |
trend.backtest 和 trend.live 中每個淨值點的欄位：
| 欄位 | 類型 | 描述 |
|---|---|---|
ts | long | Unix 秒時間戳 |
nav | number | 該時點的淨值 |
成功回應範例
json
{
"code": 200,
"message": "success",
"data": {
"records": [
{
"id": 1001,
"name": "BTC Trend Strategy",
"description": "Trend-following strategy for BTC perpetual futures.",
"riskLabel": "medium",
"marketType": "perpetual",
"providerStatus": "active",
"publishStatus": 300,
"signalStatus": 200,
"lastSignalSeq": 128,
"lastSignalTs": 1751328000,
"tokens": [
{
"vsTokenId": 1,
"symbol": "BTC",
"name": "Bitcoin",
"icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png"
}
],
"maxLeverage": 3,
"avgLeverage": 1.5,
"liveSignalDays": 30,
"backtestCagr": 0.25,
"winRate": 0.58,
"maxDrawdown30d": 0.08,
"performance": {
"navKind": "blended",
"fromTs": 1735689600,
"toTs": 1751328000,
"totalReturn": 0.31,
"cagr": 0.25,
"sharpe": 1.42,
"maxDrawdown": 0.12
},
"trend": {
"backtest": [{"ts": 1735689600, "nav": 1.0}],
"live": [{"ts": 1751328000, "nav": 1.03}]
}
}
],
"total": 1,
"size": 20,
"current": 1,
"pages": 1
},
"requestId": "xxx-xxx-xxx"
}錯誤碼
| 錯誤碼 | 描述 |
|---|---|
40002 | 請求參數非法 |
50001 | 請求的介面不存在或當前不可用 |
60001 | 呼叫頻率超過限制 |
70001 | OpenAPI 點數不足 |
70002 | 當前使用者的 OpenAPI 存取已被停用 |
70005 | 請求語言的策略內容暫不可用 |