data-corporateActions
Truy vấn danh sách sự kiện quyền của doanh nghiệp (cổ tức, thưởng cổ phiếu, phát hành thêm...) theo mã chứng khoán và khoảng thời gian. Sự kiện đã có ngày giao dịch không hưởng quyền được lọc theo ngày này; sự kiện mới công bố chưa có ngày giao dịch không hưởng quyền được lọc theo ngày thực hiện hoặc ngày công bố tin, khi đó exrightDate và ratio có thể là chuỗi rỗng. Kết quả sắp xếp theo ngày giao dịch không hưởng quyền giảm dần. Scope yêu cầu là data:corporateActions:get.
Authorization
Bearer Nhập JWT token theo định dạng Bearer <token>.
In: header
Header Parameters
Định dạng nội dung request body, sử dụng "application/json".
Thông tin client gửi request.
Ngôn ngữ phản hồi mong muốn. Nếu không có header này, hệ thống sẽ mặc định là en
Query Parameters
Mã chứng khoán cần truy vấn (chỉ gồm chữ cái và chữ số, tối đa 20 ký tự). Không truyền thì trả sự kiện của tất cả các mã.
Ngày bắt đầu theo định dạng `YYYY/MM/DD`. Bắt buộc phải nhỏ hơn hoặc bằng `to`.
Ngày kết thúc theo định dạng `YYYY/MM/DD`. Khoảng cách giữa `from` và `to` không được vượt quá 5 ngày.
Ngôn ngữ của dữ liệu trả về (ví dụ `eventTitle`). Giá trị có thể là `vn` hoặc `en`. Nếu không cung cấp thì hệ thống sẽ sử dụng giá trị mặc định là `vn`.
Chỉ số trang khi phân trang kết quả, bắt đầu từ 1. Nếu không cung cấp thì hệ thống sẽ sử dụng giá trị mặc định là 1.
Số lượng bản ghi trên mỗi trang khi phân trang kết quả. Giá trị có thể là `10`, `20`, `50` hoặc `100`. Nếu không cung cấp thì hệ thống sẽ sử dụng giá trị mặc định là 10.
Response Headers
Giới hạn số request trong chu kỳ.
Số request còn lại trong chu kỳ hiện tại.
Thời điểm reset giới hạn request.
Response Body
application/json
application/json
curl -X GET "https://api.ssi.com.vn/api/v3/data/corporateActions?from=2026%2F10%2F08&to=2026%2F10%2F12" \ -H "Content-Type: application/json"Success
{
"pageSize": 0,
"pageIndex": 0,
"pagesCount": 0,
"itemsCount": 0,
"data": [
{
"symbol": "GDA",
"eventTitle": "string",
"exrightDate": "2026/10/12",
"recordDate": "2026/10/13",
"issueDate": "2026/10/30",
"exchange": "HOSE",
"ratio": "0.9388"
}
]
}Không có dữ liệu phù hợp với điều kiện truy vấn (response không có body).
Yêu cầu không hợp lệ.
{
"code": "400",
"msg": "Invalid request"
}