Các phiên bản Nebula

API này trả về danh sách các phiên bản Nebula đã được tạo và lưu trữ cho người dùng, cho phép xem lại lịch sử các cấu hình và hiệu suất của chúng.

Lưu ý

Bạn chỉ có thể xem được các phiên bản trong vòng 7 ngày gần nhất.

HTTP request

• URL: /api/personalize/v1/partner/nebula-ultra/profiles/restores
• Method: GET
• Content Type: None
• Response Type: application/json

Tham số header

Header	Mô tả	Kiểu dữ liệu	Bắt buộc
X-Api-Key	Khóa duy nhất.	string	có

Tham Số Truy Vấn (Query Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
externalUserId	string	có	UserId của đối tác.
page	string	không	Trang dữ liệu cần lấy, default: 0.
size	string	không	Số bản ghi của một trang, default: 10.
recvWindow	string	không	Thời gian chấp nhận (ms), default: 5000.
timestamp	string	có	Unix timestamp (milliseconds).
signature	string	có	HMAC-SHA256 signature.

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "total": 2,
  "data": [
    {
      "annualizedReturn": 21.173879,
      "averageLoss": -6.56,
      "averageProfit": 19.82,
      "finalReturn": 201.599362,
      "maximumDrawdown": -19.921924999999998,
      "rewardToRiskRatio": 3.0212,
      "winRate": 63.67,
      "nebulaId": "1766999557-b93c6498",
      "updatedTime": "2025-12-30T08:45:29.000Z",
      "userId": "USER012",
      "portfolioId": "849",
      "isActive": true,
      "tickers": "BVH, CTD, ACB, BVS, CSV, ACV, CTG, BSR, BMP, BID"
    },
    {
      "annualizedReturn": 20.978606,
      "averageLoss": -6.65,
      "averageProfit": 19.45,
      "finalReturn": 198.504696,
      "maximumDrawdown": -20.018055,
      "rewardToRiskRatio": 2.923,
      "winRate": 64.01,
      "nebulaId": "1765947716-52bef3f7",
      "updatedTime": "2025-12-29T16:12:37.000Z",
      "userId": "USER012",
      "portfolioId": "849",
      "isActive": false,
      "tickers": "BVH, CTD, ACB, BVS, CSV, ACV, CTG, BSR, BMP, BID"
    }
  ]
}

Chi Tiết Tham Số Response

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	number	Mã trạng thái HTTP.
message	string	Thông báo kết quả xử lý.
total	number	Tổng số bản ghi.
data	array (Xem chi tiết)	Dữ liệu danh sách các phiên bản Nebula.

Cấu trúc thuộc tính data

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
annualizedReturn	number	Lãi kép (%/năm).
averageLoss	number	Tỷ lệ lỗ bình quân.
averageProfit	number	Tỷ lệ lãi bình quân.
finalReturn	number	Tỷ lệ lợi nhuận.
maximumDrawdown	number	Mức giảm tối đa từ đỉnh.
rewardToRiskRatio	number	Tỷ lệ lợi nhuận/rủi ro.
winRate	number	Tỷ lệ giao dịch có lãi.
nebulaId	string	ID duy nhất của phiên bản Nebula.
updatedTime	string	Thời gian cập nhật lần cuối (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
userId	string	ID người dùng.
isActive	boolean	Trạng thái hoạt động: - true: Phiên bản đang hoạt động - false: Phiên bản cũ.
tickers	string	Danh sách các mã cổ phiếu.