Danh sách chiến lược

Mô tả API

Truy vấn phân trang các chiến lược hiện có. API hỗ trợ lọc theo loại thị trường và nhãn rủi ro, trả về thông tin cơ bản chiến lược, mã giao dịch, tóm tắt hiệu suất và xu hướng NAV.

URL yêu cầu

Phương thức: POST
Đường dẫn: /open/v1/strategy/page

Điểm tín phí

Điểm tín phí mỗi lần gọi: 1

Tham số yêu cầu

Tham số gửi trong body dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
`pageNum`	integer	Không	`1`	Số trang; giá trị tối thiểu là 1
`pageSize`	integer	Không	`20`	Số lượng mỗi trang; phạm vi 1–100
`marketType`	string	Không	-	Loại thị trường; hỗ trợ `spot`, `perpetual`, `delivery`; khớp chính xác
`riskLabel`	string	Không	-	Mức rủi ro; hỗ trợ `low`, `medium`, `high`; khớp chính xác
`language`	string	Không	`zh-CN`	Ngôn ngữ nội dung phản hồi; hỗ trợ `zh-CN`, `zh-TW`, `en-US`, `vi-VN`, `ja-JP`, `ko-KR`; trả về `70005` khi nội dung theo ngôn ngữ yêu cầu tạm thời không khả dụng; trả về `40002` với giá trị không được hỗ trợ

Ví dụ yêu cầu

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"
}'

Trường phản hồi

Tỷ suất lợi nhuận và tỷ lệ sụt giảm trong tài liệu này đều là số thập phân, ví dụ 0.12 tương ứng 12%; ts, fromTs và toTs đều là Unix timestamp tính bằng giây.

data là đối tượng phân trang:

Trường	Kiểu	Mô tả
`records`	array	Danh sách chiến lược của trang hiện tại
`total`	long	Tổng số bản ghi khớp điều kiện
`size`	long	Số lượng mỗi trang
`current`	long	Số trang hiện tại
`pages`	long	Tổng số trang

Các trường chính trong mỗi phần tử của records:

Trường	Kiểu	Mô tả
`id`	long	ID chiến lược ValueScan; dùng khi truy vấn chi tiết chiến lược
`name`	string	Tên chiến lược
`description`	string	Mô tả chiến lược
`riskLabel`	string	Mức rủi ro: `low`, `medium` hoặc `high`
`marketType`	string	Loại thị trường: `spot`, `perpetual` hoặc `delivery`
`performance`	object	Tóm tắt hiệu suất chiến lược
`providerStatus`	string	Trạng thái dữ liệu chiến lược: `active`, `paused` hoặc `retired`
`publishStatus`	integer	Trạng thái khả dụng chiến lược; chiến lược hiện khả dụng là `300`
`signalStatus`	integer	Trạng thái tín hiệu chiến lược
`lastSignalSeq`	long	Số thứ tự tín hiệu mới nhất; có thể null
`lastSignalTs`	long	Unix timestamp giây của tín hiệu mới nhất; có thể null
`tokens`	array	Danh sách mã giao dịch, gồm `vsTokenId`, `symbol`, `name`, `icon`
`maxLeverage`	number	Đòn bẩy tối đa; có thể null
`avgLeverage`	number	Đòn bẩy trung bình; có thể null
`liveSignalDays`	long	Số ngày chạy tín hiệu live; có thể null
`backtestCagr`	number	CAGR backtest; có thể null
`winRate`	number	Tỷ lệ thắng; có thể null
`maxDrawdown30d`	number	Tỷ lệ sụt giảm tối đa trong 30 ngày lịch UTC gần nhất, ví dụ `0.12` tương ứng 12%; null khi dữ liệu NAV không đủ
`trend`	object	Xu hướng NAV, gồm mảng `backtest` và `live`; mỗi điểm gồm `ts`, `nav`

Các trường của performance:

Trường	Kiểu	Mô tả
`navKind`	string	Loại NAV dùng cho hiệu suất: `backtest`, `live` hoặc `blended`
`fromTs`	long	Unix timestamp giây bắt đầu thống kê
`toTs`	long	Unix timestamp giây kết thúc thống kê
`totalReturn`	number	Tỷ suất lợi nhuận tích lũy, ví dụ `0.25` tương ứng 25%
`cagr`	number	Tỷ suất lợi nhuận kép hằng năm
`sharpe`	number	Hệ số Sharpe
`maxDrawdown`	number	Tỷ lệ sụt giảm tối đa toàn kỳ

Các trường trong mỗi phần tử của tokens:

Trường	Kiểu	Mô tả
`vsTokenId`	long	ID token ValueScan
`symbol`	string	Ký hiệu token
`name`	string	Tên token
`icon`	string	URL biểu tượng token

Các trường của mỗi điểm NAV trong trend.backtest và trend.live:

Trường	Kiểu	Mô tả
`ts`	long	Unix timestamp tính bằng giây
`nav`	number	NAV tại thời điểm đó

Ví dụ phản hồi thành công

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"
}

Mã lỗi

Mã lỗi	Mô tả
`40002`	Tham số yêu cầu không hợp lệ
`50001`	Endpoint yêu cầu không tồn tại hoặc hiện không khả dụng
`60001`	Vượt quá giới hạn tần suất gọi
`70001`	Không đủ điểm OpenAPI
`70002`	Quyền truy cập OpenAPI của người dùng hiện tại đã bị vô hiệu
`70005`	Nội dung chiến lược theo ngôn ngữ yêu cầu tạm thời không khả dụng

Danh sách chiến lược ​

Mô tả API ​

URL yêu cầu ​

Điểm tín phí ​

Tham số yêu cầu ​

Ví dụ yêu cầu ​

Trường phản hồi ​

Ví dụ phản hồi thành công ​

Mã lỗi ​