Thông tin Nebula

API này dùng để lấy thông tin chi tiết và trạng thái hiện tại của hồ sơ Nebula của người dùng, bao gồm các chỉ số hiệu suất, cấu hình hồ sơ và thông tin tài khoản liên kết.

HTTP request

• URL: /api/personalize/v1/partner/nebula-ultra/profiles
• 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.
type	string	không	Loại portfolio: - backtest: Hiệu suất quá khứ (default) - paper: Giao dịch giả lập - live: Dành cho bạn
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",
  "data": {
    "stats": {
      "status": "SUSPENDED",
      "nextReviewDate": "2026-02-05T02:48:46.413Z",
      "lastModifiedDate": "2026-02-04T00:00:00.000Z",
      "firstTransactionDate": "2020-04-02T17:00:00.000Z",
      "rule": {
        "hasCashValid": true,
        "hasNavValid": true,
        "hasBillingValid": false,
        "hasIntegrated": false,
        "navValueRequire": 50000000,
        "navValueCurrent": 35400000000,
        "cashAmount": 50000000000000,
        "requiredCashAmount": 170000,
        "nextPaymentCashAmount": 70000,
        "billingAmount": 100000,
        "valid": false
      },
      "metrics": {
        "absProfitLoss": 171592773,
        "annualizedReturn": 27.565624,
        "averageHoldingPeriodAvg": 41.79,
        "averageHoldingPeriodFifo": 61.86,
        "averageLossAvg": -6.53,
        "averageLossFifo": -7.18,
        "averageProfitAvg": 26.27,
        "averageProfitFifo": 23.81,
        "finalAccountValue": 226092773,
        "finalReturn": 314.849073,
        "maximumDrawdown": -27.109225999999996,
        "maximumLoss": -0.01,
        "profitFactorAvg": 3.2601,
        "profitFactorFifo": 3.2014,
        "remainingCash": 104157773,
        "rewardToRiskRatioAvg": 4.0214,
        "rewardToRiskRatioFifo": 3.3188,
        "sharpeRatio": 1.7318,
        "totalLossAvg": -74583241,
        "totalLossFifo": -76611762,
        "totalProfitAvg": 243150485,
        "totalProfitFifo": 245264161,
        "totalTransactions": 596,
        "weightedWinRateAvg": 55.620000000000005,
        "weightedWinRateFifo": 55.92,
        "winRateAvg": 67.9,
        "winRateFifo": 61.31999999999999
      },
      "transactionTickers": [
        "CSV",
        "CTG",
        "BID",
        "BVS"
      ],
      "estimatedActionsNebula": {
        "CSV": {
          "estimatedQuantity": 300,
          "timestamp": "2026-02-04T00:00:00.000Z",
          "updatedTime": "2026-02-04T10:28:10.000Z"
        },
        "CTG": {
          "estimatedQuantity": 0,
          "timestamp": "2026-02-04T00:00:00.000Z",
          "updatedTime": "2026-02-04T10:28:10.000Z"
        },
        "BID": {
          "estimatedQuantity": 0,
          "timestamp": "2026-02-04T00:00:00.000Z",
          "updatedTime": "2026-02-04T10:28:10.000Z"
        },
        "BVS": {
          "estimatedQuantity": 0,
          "timestamp": "2026-02-04T00:00:00.000Z",
          "updatedTime": "2026-02-04T10:28:10.000Z"
        }
      },
      "lastTransactions": [
        {
          "ticker": "CTG",
          "action": "SELL",
          "price": 38227.2,
          "quantity": 700,
          "timestamp": "2026-01-28T00:00:00.000Z"
        }
      ],
      "hasReachedOneYear": true,
      "hasPendingPlan": false
    },
    "profile": {
      "id": 1412,
      "userId": "USER011",
      "isPortfolioSynced": true,
      "nebulaId": "1770088856-238a0ef5",
      "investingExperience": 3,
      "capitalAmount": 35400000000,
      "capitalInitial": 54500000,
      "expectedReturn": 16,
      "acceptableLoss": -10,
      "reviewFrequency": "1M",
      "diversityFactor": 0.8,
      "favoriteTickers": "HPG,MBB",
      "isCustomizeTickers": true,
      "priorityPool": false,
      "optimizationInfos": [],
      "needsReinit": false
    },
    "user": {
      "id": 13,
      "externalUserId": "USER011",
      "userId": 1412,
      "status": "ACTIVE",
      "createdDate": "2025-12-16T03:02:16.917Z"
    }
  }
}

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ý.
data	object (Xem chi tiết)	Dữ liệu về 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ả
stats	object (Xem chi tiết)	Thống kê hiệu suất và trạng thái của danh mục Nebula.
profile	object (Xem chi tiết)	Thông tin cấu hình hồ sơ Nebula của người dùng.
user	object (Xem chi tiết)	Thông tin về người dùng đối tác.

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	string	Trạng thái: - INIT: Chưa có user profile cần tạo profile - RUNNING: Đang khởi tạo dữ liệu, gọi api với type=initialize để check realtime (Xem chi tiết) - PROCESS_EOD: Đang xử lý dữ liệu cuối ngày, gọi api với type=eod để check realtime (Xem chi tiết) - REINIT: Khởi tạo lại - UNSUPPORTED: Nebula không tìm được rổ cổ phiếu phù hợp - SUSPENDED: Tạm dừng Nebula (!hasNavValid or !hasCashValid or !hasBillingValid) - ACTIVE: Hoạt động - ERROR: Lỗi
nextReviewDate	string	Ngày cơ cấu tiếp theo (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
lastModifiedDate	string	Cập nhật cuối phiên (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
firstTransactionDate	string	Ngày giao dịch đầu tiên (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
rule	object (Xem chi tiết)	Dữ liệu các quy tắc và trạng thái xác thực.
metrics	object (Xem chi tiết)	Dữ liệu thống kê chi tiết.
transactionTickers	array of string	Các mã cổ phiếu đã được giao dịch.
estimatedActionsNebula	object (Xem chi tiết)	Kế hoạch giao dịch.
lastTransactions	array (Xem chi tiết)	Các giao dịch gần đây nhất.
hasReachedOneYear	boolean	- true: Ngày hiện tại - firstTransactionDate >= 356 ngày - false: Ngày hiện tại - firstTransactionDate < 365 ngày
hasPendingPlan	boolean	- true: Cảnh báo kế hoạch giao dịch cho danh mục tích hợp sẽ được cập nhật sau 15h chiều. - false : Ẩn cảnh báo

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
hasCashValid	boolean	- true: Đủ tiền duy trì - false: Không đủ tiền duy trì
hasNavValid	boolean	- true: Đủ điều kiện - false: Giá trị danh mục đạt đủ navValueRequire triệu chưa
hasBillingValid	boolean	- true: Đủ điều kiện - false: Có hóa đơn nợ
hasIntegrated	boolean	- true: Đã tích hợp danh mục live với Nebula - false: Chưa tích hợp danh mục live với Nebula
navValueRequire	number	Giá trị NAV tối thiểu.
navValueCurrent	number	Giá trị NAV hiện tại của tài khoản.
navValueDate	string	Thời gian cập nhật giá trị NAV (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
cashAmount	number	Số dư tiền mặt hiện tại của khách hàng.
requiredCashAmount	number	Số tiền yêu cầu dự kiến.
nextPaymentCashAmount	number	Số tiền thanh toán kỳ tiếp theo.
billingAmount	number	Số tiền của hóa đơn nợ (có khi hasBillingValid = false).
valid	boolean	- true: (hasNavValid & hasCashValid & hasBillingValid) - false: (!hasNavValid or !hasCashValid or !hasBillingValid)

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
id	number	ID hồ sơ.
userId	string	ID người dùng.
nebulaId	string	ID của Nebula.
portfolioId	number	ID của danh mục đầu tư liên quan.
investingExperience	number	Số năm kinh nghiệm đầu tư.
capitalAmount	number	Số vốn đầu tư hiện tại.
capitalInitial	number	Số vốn đầu tư ban đầu.
expectedReturn	number	Lợi nhuận kỳ vọng.
acceptableLoss	number	Mức lỗ tối đa có thể chấp nhận (%).
reviewFrequency	string	Thời gian định kỳ cơ cấu lại danh mục.
diversityFactor	number	Độ đa dạng.
favoriteTickers	string	Danh sách các mã cổ phiếu yêu thích.
suggestedTickers	string	Danh sách các mã cổ phiếu gợi ý. Có khi status = UNSUPPORTED.
isCustomizeTickers	boolean	- true: tự chọn cổ phiếu bạn muốn Nebula tính toán cho bạn - false: chọn cổ phiếu từ danh mục đầu tư của bạn
priorityPool	boolean	- true: chỉ sử dụng cổ phiếu trong danh sách mã cổ phiếu yêu thích để giao dịch - false: không sử dụng cổ phiếu trong danh sách mã cổ phiếu yêu thích để giao dịch
optimizationInfos	array of string	Các cảnh báo về kế khoạch giao dịch (VD: ["Nebula có đủ mức độ tin cậy để đầu tư những cổ phiếu trong danh sách tùy chỉnh của bạn. Tuy nhiên, Nebula không đảm bảo rằng danh sách này sẽ mang lại lợi nhuận và giảm thiểu rủi ro tốt nhất cho bạn."] )
needsReinit	boolean	- true : có xảy ra lỗi nên phải khởi tạo lại - false: không cần khởi tạo lại
stoppedDays	number	Số ngày còn lại để khôi phục nebula. Có khi dừng Nebula.
isPortfolioSynced	boolean	- true: đã đồng bộ danh mục - false: chưa đồng bộ danh mục
followMode	string	Chế độ theo dõi tín hiệu: - AUTO: Auto trade - follow 100% - MANUAL: Follow signal - user tự quyết định.
T + 2.5	number	Loại giao dịch
0.35	number	Phí giá dịch mua

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
id	number	ID duy nhất của người dùng trên hệ thống Simplize.
userId	string	User Id người dùng từ hệ thống của Simplize.
externalUserId	string	UserId của đối tác.
status	string	Trạng thái tài khoản: - ACTIVE: Hoạt động - INACTIVE: Không hoạt động
createdDate	string	Thời gian tạo tài khoản (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
absProfitLoss	number	Tổng lợi nhuận.
annualizedReturn	number	Lãi kép (%/năm).
averageHoldingPeriodAvg	number	Thời gian nắm giữ bình quân (phương pháp giá vốn bình quân).
averageHoldingPeriodFifo	number	Thời gian nắm giữ bình quân (phương pháp FIFO).
averageLossAvg	number	Tỷ lệ lỗ bình quân (phương pháp giá vốn bình quân).
averageLossFifo	number	Tỷ lệ lỗ bình quân (phương pháp FIFO).
averageProfitAvg	number	Tỷ lệ lãi bình quân (phương pháp giá vốn bình quân).
averageProfitFifo	number	Tỷ lệ lãi bình quân (phương pháp FIFO).
finalAccountValue	number	Tổng tài sản hiện tại.
finalReturn	number	Tỷ lệ lợi nhuận (%).
maximumDrawdown	number	Mức giảm tối đa từ đỉnh (%).
maximumLoss	number	Mức lỗ tối đa.
profitFactorAvg	number	Chỉ số lợi nhuận (phương pháp giá vốn bình quân).
profitFactorFifo	number	Chỉ số lợi nhuận (phương pháp FIFO).
remainingCash	number	Tiền mặt hiện có.
rewardToRiskRatioAvg	number	Tỷ lệ lợi nhuận/rủi ro (phương pháp giá vốn bình quân).
rewardToRiskRatioFifo	number	Tỷ lệ lợi nhuận/rủi ro (phương pháp FIFO).
sharpeRatio	number	Tỷ lệ Sharpe.
totalLossAvg	number	Tổng lỗ (phương pháp giá vốn bình quân).
totalLossFifo	number	Tổng lỗ (phương pháp FIFO).
totalProfitAvg	number	Tổng lãi (phương pháp giá vốn bình quân).
totalProfitFifo	number	Tổng lãi (phương pháp FIFO).
totalTransactions	number	Tổng số giao dịch đã thực hiện.
weightedWinRateAvg	number	Tỷ lệ thắng có trọng số (phương pháp giá vốn bình quân).
weightedWinRateFifo	number	Tỷ lệ thắng có trọng số (phương pháp FIFO).
winRateAvg	number	Tỷ lệ giao dịch có lãi (phương pháp giá vốn bình quân).
winRateFifo	number	Tỷ lệ giao dịch có lãi(phương pháp FIFO).
finalAccountValue - remainingCash	number	Giá trị cổ phiếu.

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
[TICKER]	object (Xem chi tiết)	Giá trị là một đối tượng chứa thông tin hành động ước tính cho mã đó.

Cấu trúc đối tượng data.stats.estimatedActionsNebula.[TICKER]

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
estimatedQuantity	number	Số lượng cổ phiếu đặt lệnh
timestamp	string	Ngày đưa ra kế hoạch mua bán (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
updatedTime	string	Thời gian kế hoạch được đưa ra (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
ticker	string	Mã cổ phiếu.
action	string	Hành động giao dịch: - BUY: mua - SELL: bán
price	number	Giá thực hiện.
quantity	number	Số lượng.
timestamp	string	Ngày thực hiện (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').