Cập nhật Nebula Ultra
Nebula Ultra vừa có một đợt nâng cấp khá lớn: thêm khả năng phòng vệ danh mục bằng hedging VN30F, hỗ trợ giao dịch margin, mở rộng thêm các lớp tài sản (vàng, crypto, trái phiếu), đồng thời dọn dẹp lại một số API rollback cũ không còn phù hợp. Trang này tổng hợp toàn bộ thay đổi để đối tác dễ dàng rà soát và cập nhật hệ thống tích hợp.
1. Các API ngừng hỗ trợ
Nhóm API rollback version dưới đây sẽ không còn được hỗ trợ, đối tác cần ngừng gọi các endpoint này:
| Method | Endpoint |
|---|---|
| POST | /api/personalize/v1/partner/nebula-ultra/profiles/tickers |
| POST | /api/personalize/v1/partner/nebula-ultra/profiles/cash |
| POST | /api/personalize/v1/partner/nebula-ultra/profiles/stop |
| POST | /api/personalize/v1/partner/nebula-ultra/profiles/activate |
| POST | /api/personalize/v1/partner/nebula-ultra/profiles/reinitialize |
| POST | /api/personalize/v1/partner/nebula-ultra/profiles/restore |
| GET | /api/personalize/v1/partner/nebula-ultra/profiles/restores |
2. Các API mới bổ sung
Hedging (chỉ trả dữ liệu khi hedgingEnabled = true)
| Method | Endpoint | Mô tả |
|---|---|---|
| GET | /api/personalize/v1/partner/nebula-ultra/hedge/returns | Lãi/lỗ tích lũy từ hedging |
| GET | /api/personalize/v1/partner/nebula-ultra/hedge/effective | Hiệu quả phòng vệ theo đợt giảm |
| GET | /api/personalize/v1/partner/nebula-ultra/hedge/positions/closed | Vị thế phòng vệ đã đóng |
Margin (chỉ trả dữ liệu khi marginEnabled = true)
| Method | Endpoint | Mô tả |
|---|---|---|
| GET | /api/personalize/v1/partner/nebula-ultra/margin/interest | Dư nợ và lãi margin theo ngày |
| GET | /api/personalize/v1/partner/nebula-ultra/margin/history | Lịch sử lãi margin tích lũy |
Khác
| Method | Endpoint | Mô tả |
|---|---|---|
| POST | /api/personalize/v1/partner/nebula-ultra/run-trade/uat | Gửi yêu cầu nhận khuyến nghị UAT — khuyến nghị chỉ nên dùng cho môi trường dev. |
3. Các API có thay đổi
Lấy vị thế đang mở / đã đóng — thay đổi giá trị tham số mode
Cả hai API dưới đây được thay đổi giá trị tham số mode để chọn phương pháp tính giá vốn: AVCO (giá vốn bình quân) hoặc FIFO.
- GET /profiles/portfolio/positions/open — Chi tiết giao dịch đang nắm giữ
- GET /profiles/portfolio/positions/closed — Giao dịch đã đóng trạng thái
GET /profiles — Thông tin Nebula
- Ngừng hỗ trợ: trường
nextReviewDate. - Loại bỏ khỏi
data.stats.rule:hasCashValid,hasBillingValid,cashAmount,requiredCashAmount,nextPaymentCashAmount,billingAmount,requiredCashAmountChangeProfile. - Bổ sung vào
data.profile:strategyModel,stockUniverse,hedgingEnabled,activateGold,activateCrypto,activateFixedIncome,marginEnabled,marginRate,marginLimitPct. - Bổ sung vào
data.stats:hedgeMetrics,hedgeOrders,marginMetrics.
POST /profiles — Khởi tạo Nebula
Bổ sung các tham số cấu hình mới: strategyModel, stockUniverse, hedgingEnabled, marginEnabled.
POST /profiles/update — Chỉnh sửa thông số
Bổ sung các tham số cấu hình mới: strategyModel, stockUniverse, hedgingEnabled, marginEnabled.
POST /run-trade/batch — Gửi yêu cầu nhận khuyến nghị
Khuyến nghị chỉ nên dùng cho môi trường production. Với môi trường dev/test, chuyển sang dùng API run-trade/uat mới ở mục 2.
4. Các API còn lại
Tất cả các API không được liệt kê ở trên giữ nguyên không thay đổi.