> ## Documentation Index
> Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lịch sử sự kiện quyền



## OpenAPI

````yaml /vi/openapi/dnse.openapi.yaml get /accounts/{accountNo}/corporate-action-history
openapi: 3.0.0
info:
  title: DNSE OpenAPI (2026-09-25)
  version: 2.0.0
  description: DNSE OpenAPI spec
servers:
  - url: https://openapi.dnse.com.vn
    description: Production
  - url: https://sb-openapi.dnse.com.vn
    description: Sanbox
security: []
tags:
  - name: trading
    description: Xác thực và các hoạt động đặt lệnh.
    x-group: Giao dịch
  - name: account
    description: Tài khoản, số dư, khoản vay, lệnh và vị thế.
    x-group: Tài khoản
  - name: market
    description: Thông tin mã chứng khoán, báo giá, OHLC và giao dịch.
    x-group: Dữ liệu thị trường
paths:
  /accounts/{accountNo}/corporate-action-history:
    get:
      tags:
        - account
      summary: Lịch sử sự kiện quyền
      operationId: account_getCorporateActionHistory
      parameters:
        - $ref: '#/components/parameters/XApiKey'
        - $ref: '#/components/parameters/XAuxDate'
        - $ref: '#/components/parameters/XSignature'
        - name: accountNo
          in: path
          required: true
          schema:
            type: string
        - name: symbol
          in: query
          schema:
            type: string
          description: Mã chứng khoán
          example: MSB
        - name: caType
          in: query
          schema:
            type: string
          example: cashDividend
          description: |-
            Phân loại sự kiện quyền 
            - cashDividend: Sự kiện quyền trả cổ tức bằng tiền
            - stockDividend: Sự kiện quyền trả cổ tức cổ phiếu
            - stockBonus: Sự kiện quyền trả cổ phiếu thưởng 
            - rightsOffering: Sự kiện quyền mua cổ phiếu phát hành thêm
        - name: caStatus
          in: query
          schema:
            $ref: '#/components/schemas/CorporateActionStatus'
          example: pending
          description: |-
            Trạng thái xử lý sự kiện quyền 
            - pending: Quyền đang chờ xử lý hoặc đang được thực hiện
            - completed: Quyền đã được xử lý hoàn tất
            - canceled: Quyền đã hủy thành công
        - name: pageIndex
          in: query
          schema:
            type: integer
            format: int32
          description: Trang hiện tại
          example: 0
        - name: pageSize
          in: query
          schema:
            type: integer
            format: int32
          description: Số lượng bản ghi trên mỗi trang
          example: 30
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CorporateActionHistoryResponse'
              example:
                accountNo: '0001179019'
                data:
                  cashDividend:
                    - id: 617210
                      symbol: MSB
                      caStatus: pending
                      recordDate: '2026-04-24'
                      processDate: '2026-05-13'
                      holdingQuantity: 600
                      dividendValue: 500
                      grossAmount: 300000
                      taxAmount: 15000
                      netAmount: 285000
                  stockDividend:
                    - id: 618949
                      symbol: OIL
                      caStatus: pending
                      recordDate: '2026-04-29'
                      processDate: '2026-05-14'
                      holdingQuantity: 3211
                      ratio: 5/3
                      receivedQuantity: 1926
                  stockBonus:
                    - id: 617276
                      symbol: MSB
                      caStatus: completed
                      recordDate: '2026-04-24'
                      processDate: '2026-05-13'
                      holdingQuantity: 600
                      ratio: 15/6
                      receivedQuantity: 240
                  rightsOffering:
                    - id: 623428
                      symbol: OIL
                      caStatus: pending
                      recordDate: '2026-04-29'
                      processDate: '2026-05-14'
                      holdingQuantity: 5137
                      ratio: 3/1
                      rightPrice: 11000
                      rightsQuantity: 1712
                      registeredQuantity: 170
                      startDateTransfer: '2026-05-04'
                      endDateTransfer: '2026-05-13'
                      startDateSubscription: '2026-05-04'
                      endDateSubscription: '2026-05-13'
                pagination:
                  pageIndex: 0
                  pageSize: 100
                  totalRecords: 100
        '400':
          $ref: '#/components/responses/BadRequest'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    XApiKey:
      name: X-Api-Key
      in: header
      required: true
      description: >-
        API key được cấp khi đăng ký dịch vụ DNSE OpenAPI.

        Ví dụ:
        `b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=`
      schema:
        type: string
    XAuxDate:
      name: X-Aux-Date
      in: header
      required: true
      description: |-
        Thời gian thực hiện request, dùng trong cơ chế ký request của DNSE.
        Ví dụ: `Sat, 01 May 2026 14:24:23 +0000`
      schema:
        type: string
    XSignature:
      name: X-Signature
      in: header
      required: true
      description: >-
        Chữ ký xác thực request được tạo từ API key secret và X-Aux-Date.

        Ví dụ: `Signature
        keyId="b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=",algorithm="hmac-sha256",headers="(request-target)
        x-aux-date",signature="rfbVXHDUi%2B%2FsOkLXle7O17Qm%2F05cbISSR%2BDcFrBHfqQ%3D",nonce="4add8c3264e4492b9f8ecde0cf26b523"`
      schema:
        type: string
  schemas:
    CorporateActionStatus:
      type: string
      description: |-
        Trạng thái xử lý sự kiện quyền.

        - `pending`: Đang chờ xử lý hoặc đang được thực hiện
        - `completed`: Đã xử lý hoàn tất
        - `canceled`: Đã hủy thành công
      enum:
        - pending
        - completed
        - canceled
      x-enum-descriptions:
        - Đang chờ xử lý hoặc đang được thực hiện
        - Đã xử lý hoàn tất
        - Đã hủy thành công
      x-enum-varnames:
        - PENDING
        - COMPLETED
        - CANCELED
      example: pending
    CorporateActionHistoryResponse:
      type: object
      properties:
        accountNo:
          type: string
          example: '0001179019'
          description: Số tiểu khoản
        data:
          type: object
          additionalProperties:
            type: array
            items:
              type: object
              additionalProperties: true
          description: >-
            Danh sách quyền chứng khoán của tiểu khoản, được phân loại theo từng
            loại quyền
          properties:
            cashDividend:
              type: array
              description: Danh sách quyền trả cổ tức bằng tiền
              items:
                $ref: '#/components/schemas/CashDividend'
            stockDividend:
              type: array
              description: Danh sách quyền trả cổ tức bằng cổ phiếu
              items:
                $ref: '#/components/schemas/StockDividend'
            stockBonus:
              type: array
              description: Danh sách quyền trả cổ phiếu thưởng
              items:
                $ref: '#/components/schemas/StockBonus'
            rightsOffering:
              type: array
              description: Danh sách quyền mua cổ phiếu phát hành thêm
              items:
                $ref: '#/components/schemas/RightsOffering'
        pagination:
          $ref: '#/components/schemas/Pagination'
    CashDividend:
      type: object
      properties:
        id:
          type: integer
          example: 617210
          description: ID sự kiện quyền
          format: int32
        symbol:
          type: string
          example: MSB
          description: Mã chứng khoán
        caStatus:
          allOf:
            - $ref: '#/components/schemas/CorporateActionStatus'
          example: pending
          description: |-
            Trạng thái xử lý sự kiện quyền
            - pending: Quyền đang chờ xử lý hoặc đang được thực hiện
            - completed: Quyền đã được xử lý hoàn tất
            - canceled: Quyền đã hủy thành công
        recordDate:
          type: string
          example: '2026-04-24'
          description: Ngày đăng ký cuối cùng sự kiện quyền
        processDate:
          type: string
          example: '2026-05-13'
          description: Ngày thanh toán dự kiến
        holdingQuantity:
          type: integer
          example: 600
          description: Số lượng chứng khoán sở hữu tại ngày chốt quyền
          format: int32
        dividendValue:
          type: integer
          example: 500
          description: Giá trị cổ tức trên mỗi cổ phiếu
          format: int32
        grossAmount:
          type: integer
          example: 300000
          description: Tổng giá trị tiền cổ tức trước thuế
          format: int32
        taxAmount:
          type: integer
          example: 15000
          description: Số tiền thuế bị khấu trừ
          format: int32
        netAmount:
          type: integer
          example: 285000
          description: Số tiền thực nhận sau thuế
          format: int32
    StockDividend:
      type: object
      properties:
        id:
          type: integer
          example: 618949
          description: ID sự kiện quyền
          format: int32
        symbol:
          type: string
          example: OIL
          description: Mã chứng khoán
        caStatus:
          allOf:
            - $ref: '#/components/schemas/CorporateActionStatus'
          example: pending
          description: |-
            Trạng thái xử lý sự kiện quyền
            - pending: Quyền đang chờ xử lý hoặc đang được thực hiện
            - completed: Quyền đã được xử lý hoàn tất
            - canceled: Quyền đã hủy thành công
        recordDate:
          type: string
          example: '2026-04-29'
          description: Ngày đăng ký cuối cùng sự kiện quyền
        processDate:
          type: string
          example: '2026-05-14'
          description: Ngày phân phối cổ phiếu cổ tức dự kiến
        holdingQuantity:
          type: integer
          example: 3211
          description: Số lượng chứng khoán sở hữu tại ngày chốt quyền
          format: int32
        ratio:
          type: string
          example: 5/3
          description: Tỷ lệ thực hiện quyền nhận cổ tức bằng cổ phiếu
        receivedQuantity:
          type: integer
          example: 1926
          description: Số lượng cổ phiếu cổ tức được nhận
          format: int32
    StockBonus:
      type: object
      properties:
        id:
          type: integer
          example: 617276
          description: ID sự kiện quyền
          format: int32
        symbol:
          type: string
          example: MSB
          description: Mã chứng khoán
        caStatus:
          allOf:
            - $ref: '#/components/schemas/CorporateActionStatus'
          example: completed
          description: |-
            Trạng thái xử lý sự kiện quyền
            - pending: Quyền đang chờ xử lý hoặc đang được thực hiện
            - completed: Quyền đã được xử lý hoàn tất
            - canceled: Quyền đã hủy thành công
        recordDate:
          type: string
          example: '2026-04-24'
          description: Ngày đăng ký cuối cùng sự kiện quyền
        processDate:
          type: string
          example: '2026-05-13'
          description: Ngày phân phối cổ phiếu thưởng dự kiến
        holdingQuantity:
          type: integer
          example: 600
          description: Số lượng chứng khoán sở hữu tại ngày chốt quyền
          format: int32
        ratio:
          type: string
          example: 15/6
          description: Tỷ lệ thực hiện quyền nhận cổ phiếu thưởng
        receivedQuantity:
          type: integer
          example: 240
          description: Số lượng cổ phiếu thưởng khách hàng được nhận
          format: int32
    RightsOffering:
      type: object
      properties:
        id:
          type: integer
          example: 623428
          description: ID sự kiện quyền
          format: int32
        symbol:
          type: string
          example: OIL
          description: Mã chứng khoán
        caStatus:
          allOf:
            - $ref: '#/components/schemas/CorporateActionStatus'
          example: pending
          description: |-
            Trạng thái xử lý sự kiện quyền
            - pending: Quyền đang chờ xử lý hoặc đang được thực hiện
            - completed: Quyền đã được xử lý hoàn tất
            - canceled: Quyền đã hủy thành công
        recordDate:
          type: string
          example: '2026-04-29'
          description: Ngày đăng ký cuối cùng sự kiện quyền để xác định quyền mua
        processDate:
          type: string
          example: '2026-05-14'
          description: Ngày phân phối cổ phiếu quyền mua dự kiến
        holdingQuantity:
          type: integer
          example: 5137
          description: Số lượng chứng khoán sở hữu tại ngày chốt quyền
          format: int32
        ratio:
          type: string
          example: 3/1
          description: Tỷ lệ thực hiện quyền mua cổ phiếu
        rightPrice:
          type: integer
          example: 11000
          description: Giá đăng ký mua cổ phiếu phát hành thêm
          format: int32
        rightsQuantity:
          type: integer
          example: 1712
          description: Số lượng quyền mua được phân bổ trên tài khoản
          format: int32
        registeredQuantity:
          type: integer
          example: 170
          description: Số lượng cổ phiếu phát hành thêm đã đăng ký mua
          format: int32
        startDateTransfer:
          type: string
          example: '2026-05-04'
          description: Ngày bắt đầu được phép chuyển nhượng quyền mua
        endDateTransfer:
          type: string
          example: '2026-05-13'
          description: Ngày kết thúc chuyển nhượng quyền mua
        startDateSubscription:
          type: string
          example: '2026-05-04'
          description: Ngày bắt đầu đăng ký thực hiện quyền mua
        endDateSubscription:
          type: string
          example: '2026-05-13'
          description: Ngày kết thúc đăng ký thực hiện quyền mua
    Pagination:
      type: object
      description: Thông tin phân trang dữ liệu
      properties:
        pageIndex:
          type: integer
          example: 0
          description: Trang hiện tại
          format: int32
        pageSize:
          type: integer
          example: 100
          description: Số lượng bản ghi trên mỗi trang
          format: int32
        totalRecords:
          type: integer
          example: 100
          description: Tổng số bản ghi
          format: int32
    ErrorBody:
      type: object
      required:
        - status
        - code
        - message
      properties:
        status:
          type: integer
          format: int32
          description: Mã HTTP.
          example: 400
        code:
          type: string
          description: Mã lỗi DNSE.
          example: OA-003
        message:
          type: string
          description: Thông điệp lỗi.
          example: Thông tin nhập không hợp lệ
  responses:
    BadRequest:
      description: Yêu cầu không hợp lệ.
      headers:
        Content-Length:
          $ref: '#/components/headers/ContentLength'
        Date:
          $ref: '#/components/headers/Date'
        Vary:
          $ref: '#/components/headers/Vary'
        X-Ratelimit-Limit:
          $ref: '#/components/headers/XRateLimitLimit'
        X-Ratelimit-Remaining:
          $ref: '#/components/headers/XRateLimitRemaining'
        X-Ratelimit-Reset:
          $ref: '#/components/headers/XRateLimitReset'
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        X-Tyk-Api-Expires:
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            status: 400
            code: OA-003
            message: Thông tin nhập không hợp lệ
    InternalError:
      description: Lỗi hệ thống.
      headers:
        Content-Length:
          $ref: '#/components/headers/ContentLength'
        Date:
          $ref: '#/components/headers/Date'
        Vary:
          $ref: '#/components/headers/Vary'
        X-Ratelimit-Limit:
          $ref: '#/components/headers/XRateLimitLimit'
        X-Ratelimit-Remaining:
          $ref: '#/components/headers/XRateLimitRemaining'
        X-Ratelimit-Reset:
          $ref: '#/components/headers/XRateLimitReset'
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        X-Tyk-Api-Expires:
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            status: 500
            code: OA-009
            message: Lỗi hệ thống
  headers:
    ContentLength:
      description: Response body size in bytes.
      schema:
        type: integer
      example: 430
    Date:
      description: Response date from the DNSE gateway.
      schema:
        type: string
      example: Wed, 18 Mar 2026 16:17:35 GMT
    Vary:
      description: >-
        Response header indicating the request headers used for content
        negotiation.
      schema:
        type: string
      example: Origin
    XRateLimitLimit:
      description: Maximum number of requests allowed in the current rate-limit window.
      schema:
        type: integer
      example: 300
    XRateLimitRemaining:
      description: Number of requests remaining in the current rate-limit window.
      schema:
        type: integer
      example: 299
    XRateLimitReset:
      description: Unix timestamp at which the current rate-limit window resets.
      schema:
        type: integer
      example: 1773850655
    XRequestId:
      description: Unique identifier assigned to the request by the DNSE gateway.
      schema:
        type: string
      example: unknown

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.