Chuyển tới nội dung chính

Dư nợ và lãi margin theo ngày

API này trả về diễn biến dư nợ margin và lãi phát sinh theo từng ngày, kèm mốc sự kiện margin call.

HTTP request

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

Tham số header

HeaderMô tảKiểu dữ liệuBắt buộc
X-Api-KeyKhóa duy nhất.string

Tham Số Truy Vấn (Query Parameters)

Tên Tham SốKiểu Dữ LiệuBắt buộcMô Tả
externalUserIdstringUserId của đối tác.
typestringkhôngLoại portfolio:
- backtest: Hiệu suất quá khứ (default)
- paper: Giao dịch giả lập
- live: Dành cho bạn
recvWindowstringkhôngThời gian chấp nhận (ms), default: 5000.
timestampstringUnix timestamp (milliseconds).
signaturestringHMAC-SHA256 signature.

Phản Hồi (Response)

Response Mẫu

{
"status": 200,
"message": "Success",
"data": [
{
"date": "2026-04-01T00:00:00.000Z",
"debt": 850000000,
"interest": 186301,
"type": "MARGIN_CALL"
},
{
"date": "2026-04-02T00:00:00.000Z",
"debt": 820000000,
"interest": 179726
},
{
"date": "2026-04-03T00:00:00.000Z",
"debt": 795000000,
"interest": 174246
}
]
}

Chi Tiết Tham Số Response

Tên Thuộc TínhKiểu Dữ LiệuMô Tả
statusnumberMã trạng thái HTTP.
messagestringThông báo kết quả xử lý.
dataarray (Xem chi tiết)Danh sách dư nợ và lãi margin theo ngày.

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

Quay lại
Tên Thuộc TínhKiểu Dữ LiệuMô Tả
datestringNgày (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
debtnumberDư nợ margin tại ngày đó (VND).
interestnumberLãi margin phát sinh trong ngày đó (VND).
typestringLoại sự kiện margin tại ngày đó (null nếu không có sự kiện):
- MARGIN_CALL: Ngày xảy ra margin call.

CREDENTIALS

* Timestamp và Signature sẽ được tự động tạo khi gọi API

RESPONSE200

{
"status": 200,
"message": "Success",
"data": [
{
"date": "2026-04-01T00:00:00.000Z",
"debt": 850000000,
"interest": 186301,
"type": "MARGIN_CALL"
},
{
"date": "2026-04-02T00:00:00.000Z",
"debt": 820000000,
"interest": 179726
},
{
"date": "2026-04-03T00:00:00.000Z",
"debt": 795000000,
"interest": 174246
}
]
}