Hiệu suất đầu tư

API này trả về dữ liệu lịch sử lợi nhuận theo ngày của danh mục đầu tư, bao gồm so sánh với chỉ số VN-Index để đánh giá hiệu suất.

HTTP request

• URL: /api/personalize/v1/partner/portfolio/return-value/${portfolioId}
• Method: GET
• Content Type: application/json
• 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ố Đường Dẫn (Path Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Mô Tả
portfolioId	string	ID của danh mục cần lấy dữ liệu lợi nhuận.

Tham Số Truy Vấn (Query Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
isMax	string	không	Nếu true, trả về toàn bộ lịch sử. Mặc định: false (chỉ trả về 1 năm gần nhất).
externalUserId	string	có	ID người dùng duy nhất từ hệ thống của đối tác.
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": [
    {
      "date": "2024-01-14T00:00:00.000Z",
      "unitReturn": 0,
      "vnIndex": 1154.7,
      "vnIndexReturn": 0,
      "dailyReturn": 0,
      "vnindexDailyReturn": 0
    },
    {
      "date": "2024-01-15T00:00:00.000Z",
      "unitReturn": -1.21,
      "vnIndex": 1154.12,
      "vnIndexReturn": -0.05,
      "dailyReturn": -1.21,
      "vnindexDailyReturn": -0.05
    }
  ]
}

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ả
data	array (Xem chi tiết)	Danh sách dữ liệu lợi nhuận theo ngày

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ả
date	string	Ngày ghi nhận (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
unitReturn	number	Lợi nhuận danh mục lũy kế (%)
vnIndex	number	Giá trị chỉ số VN-Index
vnIndexReturn	number	VNINDEX lũy kế (%)
dailyReturn	number	Biến động lợi nhuận danh mục trong ngày (%)
vnindexDailyReturn	number	Biến động VN-Index trong ngày (%)