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
| 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": [
{
"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í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 | array (Xem chi tiết) | Danh sách dư nợ và lãi margin theo ngày. |
| Tên Thuộc Tính | Kiểu Dữ Liệu | Mô Tả |
|---|---|---|
| date | string | Ngày (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'). |
| debt | number | Dư nợ margin tại ngày đó (VND). |
| interest | number | Lãi margin phát sinh trong ngày đó (VND). |
| type | string | Loạ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. |