Chi tiết chiến lược

Mô tả API

Truy vấn chi tiết chiến lược hiện khả dụng theo ID chiến lược ValueScan, bao gồm thông tin chiến lược, mã giao dịch, chỉ số hiệu suất, phân tích rủi ro và thông tin phiên bản.

URL yêu cầu

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

Đ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ố truyền qua Query String và phải tham gia ký theo quy tắc yêu cầu GET trong tài liệu xác thực.

Tên tham số	Kiểu	Bắt buộc	Mô tả
`strategyId`	long	Có	ID chiến lược ValueScan; lấy từ trường `id` của API danh sách chiến lược
`language`	string	Không	Ngôn ngữ nội dung phản hồi; hỗ trợ `zh-CN`, `zh-TW`, `en-US`, `vi-VN`, `ja-JP`, `ko-KR`; mặc định `zh-CN`; 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/detail?strategyId=1001&language=zh-CN' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx'

Trường phản hồi

Trường	Kiểu	Mô tả
`strategy`	object	Thông tin cơ bản chiến lược, gồm `id`, `name`, `description`, `riskLabel`, `marketType`, hiệu suất và trạng thái tín hiệu
`summary`	object	Tóm tắt chiến lược, gồm mã giao dịch, đòn bẩy, số ngày chạy, chỉ số lợi nhuận và xu hướng NAV
`version`	object	Chi tiết phiên bản hiện tại
`calculatedMetrics`	object	Chỉ số tính toán của nền tảng, gồm `source`, `pointCount`, `totalReturn`, `maxDrawdown`
`analytics`	object	Kết quả phân tích sinh từ dữ liệu NAV chiến lược
`performanceSegments`	object	Chỉ số hiệu suất theo giai đoạn, gồm dữ liệu giai đoạn backtest và live
`riskScope`	object	Phạm vi rủi ro, gồm mã giao dịch, đòn bẩy tối đa, cửa sổ backtest, max drawdown lịch sử, mô hình chi phí và cơ sở phí
`simulation`	object	Tổng quan vận hành chiến lược, gồm trạng thái chạy, thời gian bắt đầu và NAV xác nhận mới nhất
`symbols`	array	Thông tin liên kết mã giao dịch chiến lược

Các trường chính của version:

Trường	Kiểu	Mô tả
`id`	long	ID bản ghi phiên bản hiện tại
`version`	string	Số phiên bản chiến lược
`marketType`	string	Loại thị trường
`navKind`	string	Loại NAV
`feeBasis`	string	Cơ sở phí
`maxLeverage`	number	Đòn bẩy tối đa
`avgLeverage`	number	Đòn bẩy trung bình
`failureModes`	string	Mô tả kịch bản thất bại
`remark`	string	Ghi chú
`changelog`	array/object	Nhật ký thay đổi phiên bản
`ruleSpec`	string	Mô tả quy tắc chiến lược
`costModel`	object	Mô hình chi phí
`selfStats`	object	Dữ liệu thống kê chiến lược
`selfMetrics`	object	Dữ liệu chỉ số chiến lược

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

Trường	Kiểu	Mô tả
`symbol`	string	Ký hiệu cặp giao dịch chiến lược
`vsTokenId`	long	ID token ValueScan
`vsTokenSymbol`	string	Ký hiệu token ValueScan
`vsTokenName`	string	Tên token ValueScan
`vsTokenIcon`	string	Biểu tượng token ValueScan
`exchange`	string	Sàn giao dịch
`marketType`	string	Loại thị trường
`productType`	string	Loại sản phẩm
`exchangeSymbol`	string	Ký hiệu cặp giao dịch trên sàn
`settleCoin`	string	Đồng tiền thanh toán
`contractSize`	number	Quy mô hợp đồng; có thể null

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

json

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

Mã lỗi

Mã lỗi	Mô tả
`40001`	Thiếu `strategyId`
`40002`	Tham số `strategyId` 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
`70004`	Chiến lược không tồn tại hoặc hiện không khả dụng
`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

Chi tiết 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 ​