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

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

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
trend	object	Xu hướng NAV, gồm mảng backtest và live; mỗi điểm gồm ts, nav

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

{
  "code": 200,
  "message": "success",
  "data": {
    "records": [
      {
        "id": 1001,
        "name": "BTC Trend Strategy",
        "description": "Trend-following strategy for BTC perpetual futures.",
        "riskLabel": "medium",
        "marketType": "perpetual",
        "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,
        "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