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

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%. Tất cả trường thời gian đều là Unix timestamp tính bằng giây, trừ trường tháng.

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 đường dẫn chỉ số thường dùng:

Chỉ số	Đường dẫn trường	Mô tả
Sụt giảm tối đa 30 ngày gần nhất	`analytics.metrics.maxDrawdown30d`	Tỷ lệ sụt giảm tối đa trong 30 ngày lịch UTC gần nhất của NAV đang hiển thị
Sụt giảm tối đa 30 ngày của backtest	`performanceSegments.backtest.maxDrawdown30d`	Chỉ có khi trả về hiệu suất theo giai đoạn
Sụt giảm tối đa toàn kỳ	`calculatedMetrics.maxDrawdown`	Tính lại từ NAV hiển thị của toàn kỳ
Chi tiết sụt giảm tối đa toàn kỳ	`analytics.metrics.maxDrawdown`	Gồm tỷ lệ, đỉnh, đáy, thời gian phục hồi và số ngày kéo dài

Trường strategy: id, name, description, riskLabel, marketType, performance, providerStatus, publishStatus, signalStatus, lastSignalSeq, lastSignalTs. riskLabel là low, medium hoặc high; marketType là spot, perpetual hoặc delivery; providerStatus là active, paused hoặc retired; publishStatus là 300 với chiến lược hiện khả dụng. Hai trường tín hiệu cuối có thể null.

Trường performance:

Trường	Kiểu	Mô tả
`navKind`	string	Loại NAV: `backtest`, `live` hoặc `blended`
`fromTs` / `toTs`	long	Unix timestamp bắt đầu / kết thúc thống kê
`totalReturn`	number	Tỷ suất lợi nhuận tích lũy
`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ỳ

Mỗi phần tử tokens gồm vsTokenId, symbol, name, icon; mỗi điểm trong trend.backtest và trend.live gồm ts, nav.

summary bổ sung tokens, maxLeverage, avgLeverage, liveSignalDays, backtestCagr, winRate và trend; tất cả trường số ngoài trend có thể null.

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

Tham chiếu trường chi tiết:

Đối tượng	Trường
`version.costModel`	`feeBps` (phí, bp), `slippageBps` (trượt giá, bp)
`version.selfStats`	`tradeCount`, `winRate`, `avgHoldHours`, `profitFactor`, `maxConsecutiveLosses`, `statsBasis`
`version.selfMetrics`	`cagr`, `sharpe`, `maxDrawdown`, `totalReturn`, `annualReturn`, `basis`
`calculatedMetrics`	`source`, `pointCount`, `totalReturn`, `maxDrawdown`
`analytics`	`metrics`, `curves.7d`, `curves.30d`, `curves.all`, `drawdownCurve`, `monthlyReturns`
`analytics.metrics`	`source`, `asOfTs`, `cagr`, `sharpe`, `maxDrawdown`, `maxDrawdown30d`, `winRate`, `profitFactor`, `sortino`, `strategyTotalReturn`, `benchmarkTotalReturn`, `benchmarkExcessReturn`
Chi tiết `maxDrawdown`	`rate`, `peakTs`, `troughTs`, `recoveryTs`, `durationDays`
`curves.7d` / `curves.30d` / `curves.all`	`range` (`7d`, `30d`, `all`), `fromTs`, `toTs`, `returnCurve` (mỗi điểm gồm `ts`, `returnRate`)
`performanceSegments`	`backtest`; `live.metricFromTs`, `live.metricToTs`, `live.totalReturn`, `live.maxDrawdown`, `live.fee`, `live.funding`, `live.realizedPnl`, `live.unrealizedPnl`, `live.cagr`, `live.sharpe`, `live.closedCycles`, `live.winRate`
`riskScope`	`tokens`, `maxLeverage`, `backtestWindow` (`startTs`, `endTs`, `durationDays`), `historicalWorstFloatingLoss`, `costModel` (`feeBps`, `slippageBps`), `feeBasis`
`simulation`	`status`, `startTs`, `simulationFromTs`, `latestConfirmedTs`, `latestConfirmedNav`, `priceStatus`, `latestProvisionalNav`

Các chỉ số winRate, avgHoldHours, profitFactor, totalReturn, annualReturn, asOfTs, các chỉ số analytics tùy chọn và dữ liệu giá trị NAV mới nhất có thể null. drawdownCurve gồm các điểm ts, drawdownRate; monthlyReturns gồm month, fromTs, toTs, returnRate. simulation.status là INITIALIZING, RECOVERING, RUNNING, DEGRADED hoặc BANKRUPT; priceStatus là FRESH hoặc STALE.

simulation và performanceSegments chỉ được trả về khi chiến lược có dữ liệu live. version, calculatedMetrics, analytics và riskScope được trả về khi tồn tại phiên bản chiến lược hiện tại.

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,
      "trend": {"backtest": [{"ts": 1735689600, "nav": 1.0}], "live": [{"ts": 1751328000, "nav": 1.03}]}
    },
    "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": {"metrics": {"source": "valuescan_mixed_nav", "asOfTs": 1751328000, "cagr": 0.25, "sharpe": 1.42, "maxDrawdown": {"rate": 0.12, "peakTs": 1740787200, "troughTs": 1743379200, "recoveryTs": 1746057600, "durationDays": 61}, "maxDrawdown30d": 0.08, "strategyTotalReturn": 0.31}, "curves": {"7d": {"range": "7d", "fromTs": 1750809600, "toTs": 1751328000, "returnCurve": []}, "30d": {"range": "30d", "fromTs": 1748822400, "toTs": 1751328000, "returnCurve": []}, "all": {"range": "all", "fromTs": 1735689600, "toTs": 1751328000, "returnCurve": []}}, "drawdownCurve": [], "monthlyReturns": []},
    "performanceSegments": {"backtest": {"maxDrawdown30d": 0.09}, "live": {"totalReturn": 0.03, "maxDrawdown": 0.02}},
    "riskScope": {"tokens": [{"vsTokenId": 1, "symbol": "BTC", "name": "Bitcoin"}], "maxLeverage": 3, "backtestWindow": {"startTs": 1735689600, "endTs": 1748736000, "durationDays": 152}, "historicalWorstFloatingLoss": {"rate": 0.12}, "costModel": {"feeBps": 6, "slippageBps": 2}, "feeBasis": "Taker fee"},
    "simulation": {"status": "RUNNING", "startTs": 1748736000, "simulationFromTs": 1748736000, "latestConfirmedTs": 1751328000, "latestConfirmedNav": 1.03, "priceStatus": "FRESH", "latestProvisionalNav": 1.031},
    "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 ​