策略列表
接口描述
分页查询当前可用的策略。接口支持按市场类型和风险标签筛选，并返回策略基础信息、交易标的、业绩摘要及净值趋势。
请求 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 | 请求语言的策略内容暂不可用 |