Sự kiện quyền (Corporate Actions)

API cung cấp danh sách sự kiện quyền (cổ tức tiền mặt, cổ tức cổ phiếu, phát hành...) của danh sách mã trong khoảng ngày giao dịch không hưởng quyền. Khoảng thời gian tính bao gồm cả ngày bắt đầu và ngày kết thúc, sắp xếp giảm dần theo ngày.

HTTP request

• URL: /api/company/v1/partner/corporate-actions
• Method: POST
• 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ó

Yêu Cầu (Request)

Request Mẫu

{
  "tickers": [
    "HPG",
    "VNM"
  ],
  "exDateFrom": "2023-01-01",
  "exDateTo": "2024-12-31"
}

Chi Tiết Tham Số Request Body

Tên Thuộc Tính	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
tickers	array of string	có	Danh sách mã cần lấy dữ liệu
exDateFrom	string	không	Ngày không hưởng quyền từ, định dạng yyyy-MM-dd (bao gồm ngày này)
exDateTo	string	không	Ngày không hưởng quyền đến, định dạng yyyy-MM-dd (bao gồm ngày này)

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "data": [
    {
      "ticker": "VNM",
      "exDate": "2024-08-26",
      "divType": 0,
      "divRate": 2000,
      "cashDivRate": 2000
    },
    {
      "ticker": "HPG",
      "exDate": "2024-05-30",
      "divType": 1,
      "divRate": 10,
      "stockDivRate": 10
    }
  ]
}

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 sự kiện quyền

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ả
ticker	string	Mã cổ phiếu
exDate	string	Ngày giao dịch không hưởng quyền, định dạng yyyy-MM-dd
divType	number	Loại quyền: - 0: cổ tức tiền - 1: cổ tức cổ phiếu - 2: quyền mua
divRate	number	Tỷ lệ quyền
cashDivRate	number	Cổ tức tiền (VND/cổ phiếu), có với loại 0
stockDivRate	number	Cổ tức cổ phiếu (phần trăm), có với loại 1 và 2
offerPrice	number	Giá mua quyền (VND), có với loại 2