> ## 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.

# Thông tin chứng khoán

> Cung cấp thông tin về giá trần sàn tham chiếu và trạng thái của mã chứng khoán trong ngày giao dịch. 
Dữ liệu được hệ thống gửi hai lần vào lúc hệ thống kết thúc chạy dữ liệu cuối ngày (khoảng 8 giờ tối)
và vào đầu ngày giao dịch hôm sau (khoảng 8 giờ sáng).



## AsyncAPI

````yaml vi/asyncapi/dnse.2026-09-10.asyncapi.yaml securityDefinitionStream
id: securityDefinitionStream
title: Thông tin chứng khoán
description: >-
  Cung cấp thông tin về giá trần sàn tham chiếu và trạng thái của mã chứng khoán
  trong ngày giao dịch. 

  Dữ liệu được hệ thống gửi hai lần vào lúc hệ thống kết thúc chạy dữ liệu cuối
  ngày (khoảng 8 giờ tối)

  và vào đầu ngày giao dịch hôm sau (khoảng 8 giờ sáng).
servers:
  - id: production
    protocol: wss
    host: ws-openapi.dnse.com.vn
    bindings: []
    variables: []
  - id: sanbox
    protocol: wss
    host: ws-sb-openapi.dnse.com.vn
    bindings: []
    variables: []
address: /v1/stream
parameters: []
bindings:
  - protocol: ws
    version: 0.1.0
    value:
      method: GET
      query:
        type: object
        additionalProperties: false
        required:
          - encoding
        properties:
          encoding:
            type: string
            const: json
            default: json
            description: Định dạng mã hóa dữ liệu WebSocket (`json`, `msgpack`).
    schemaProperties:
      - name: method
        type: string
        description: GET
        required: false
      - name: query
        type: object
        required: false
        properties:
          - name: encoding
            type: string
            description: Định dạng mã hóa dữ liệu WebSocket (`json`, `msgpack`).
            required: true
operations:
  - &ref_1
    id: onSecurityDefinitionSubscription
    title: Đăng ký luồng thông tin chứng khoán
    type: receive
    messages:
      - &ref_3
        id: subscribeRequest
        contentType: application/json
        payload:
          - name: Đăng ký luồng thông tin chứng khoán
            description: Đăng ký topic `security_definition.{market_group}.{encoding}`.
            type: object
            properties:
              - name: action
                type: string
                description: subscribe
                required: true
              - name: channels
                type: array
                required: true
                properties:
                  - name: name
                    type: string
                    description: Topic thông tin chứng khoán theo nhóm thị trường.
                    required: true
                  - name: symbols
                    type: array
                    required: true
                    properties:
                      - name: item
                        type: string
                        required: false
        headers: []
        jsonPayloadSchema:
          type: object
          additionalProperties: false
          required:
            - action
            - channels
          properties:
            action:
              type: string
              const: subscribe
              x-parser-schema-id: <anonymous-schema-243>
            channels:
              type: array
              minItems: 1
              uniqueItems: true
              items:
                type: object
                additionalProperties: false
                required:
                  - name
                  - symbols
                properties:
                  name:
                    type: string
                    description: Topic thông tin chứng khoán theo nhóm thị trường.
                    pattern: ^security_definition\.[A-Z0-9]+\.json$
                    x-parser-schema-id: <anonymous-schema-246>
                  symbols:
                    type: array
                    minItems: 1
                    uniqueItems: true
                    items:
                      type: string
                      minLength: 1
                      x-parser-schema-id: <anonymous-schema-248>
                    x-parser-schema-id: <anonymous-schema-247>
                x-parser-schema-id: <anonymous-schema-245>
              x-parser-schema-id: <anonymous-schema-244>
          x-parser-schema-id: <anonymous-schema-242>
        title: Đăng ký luồng thông tin chứng khoán
        description: Đăng ký topic `security_definition.{market_group}.{encoding}`.
        example: |-
          {
            "action": "subscribe",
            "channels": [
              {
                "name": "security_definition.G1.json",
                "symbols": [
                  "HPG"
                ]
              }
            ]
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribeRequest
    bindings: []
    extensions: &ref_0
      - id: x-parser-unique-object-id
        value: securityDefinitionStream
  - &ref_2
    id: onSecurityDefinitionUpdates
    title: Nhận cập nhật thông tin chứng khoán
    type: send
    messages:
      - &ref_4
        id: update
        contentType: application/json
        payload:
          - name: Cập nhật thông tin chứng khoán
            description: Bản cập nhật giá tham chiếu, biên độ và trạng thái chứng khoán.
            type: object
            properties:
              - name: T
                type: string
                description: Mã loại message thông tin chứng khoán.
                required: true
              - name: symbol
                type: string
                description: Mã chứng khoán.
                required: true
              - name: isin
                type: string
                description: Mã định danh quốc tế (ISIN) của chứng khoán.
                required: true
              - name: marketId
                type: string
                description: Mã thị trường niêm yết mã chứng khoán.
                required: true
              - name: boardId
                type: string
                description: Mã bảng giao dịch.
                required: true
              - name: basicPrice
                type: number
                description: Giá tham chiếu trong ngày giao dịch.
                required: true
              - name: ceilingPrice
                type: number
                description: Giá trần trong ngày giao dịch.
                required: true
              - name: floorPrice
                type: number
                description: Giá sàn trong ngày giao dịch.
                required: true
              - name: productGrpId
                type: string
                description: Nhóm sản phẩm theo thị trường.
                required: true
              - name: securityGroupId
                type: string
                description: Nhóm chứng khoán.
                required: true
              - name: openInterestQuantity
                type: integer
                description: Khối lượng hợp đồng phái sinh mở qua đêm.
                required: true
              - name: securityStatus
                type: string
                description: Trạng thái giao dịch của mã chứng khoán.
                required: true
              - name: symbolAdminStatusCode
                type: string
                description: Trạng thái quản lý hành chính mã chứng khoán.
                required: true
              - name: symbolTradingMethodStatusCode
                type: string
                description: Trạng thái cơ chế giao dịch mã chứng khoán.
                required: true
              - name: symbolTradingSanctionStatusCode
                type: string
                description: Tình trạng giao dịch của mã chứng khoán.
                required: true
              - name: listingDate
                type: oneOf
                description: Ngày niêm yết.
                required: true
              - name: finalTradeDate
                type: oneOf
                description: >-
                  Ngày giao dịch cuối cùng đối với mã phái sinh hoặc chứng
                  quyền.
                required: true
              - name: time
                type: object
                description: Thời gian trong các message giá của sàn trả về.
                required: true
                properties:
                  - name: Seconds
                    type: integer
                    description: Unix timestamp tính bằng giây.
                    required: true
                  - name: Nanos
                    type: integer
                    description: Phần nanosecond của timestamp.
                    required: true
        headers: []
        jsonPayloadSchema:
          type: object
          description: Dữ liệu tham chiếu và trạng thái giao dịch của một mã chứng khoán.
          required:
            - T
            - symbol
            - marketId
            - boardId
            - basicPrice
            - ceilingPrice
            - floorPrice
            - isin
            - productGrpId
            - securityGroupId
            - openInterestQuantity
            - securityStatus
            - symbolAdminStatusCode
            - symbolTradingMethodStatusCode
            - symbolTradingSanctionStatusCode
            - listingDate
            - finalTradeDate
            - time
          properties:
            T:
              type: string
              description: Mã loại message thông tin chứng khoán.
              const: sd
              x-parser-schema-id: <anonymous-schema-250>
            symbol:
              type: string
              description: Mã chứng khoán.
              x-parser-schema-id: <anonymous-schema-251>
            isin:
              type: string
              description: Mã định danh quốc tế (ISIN) của chứng khoán.
              x-parser-schema-id: <anonymous-schema-252>
            marketId:
              type: string
              description: Mã thị trường niêm yết mã chứng khoán.
              x-parser-schema-id: <anonymous-schema-253>
            boardId:
              type: string
              description: Mã bảng giao dịch.
              x-parser-schema-id: <anonymous-schema-254>
            basicPrice:
              type: number
              description: Giá tham chiếu trong ngày giao dịch.
              x-parser-schema-id: <anonymous-schema-255>
            ceilingPrice:
              type: number
              description: Giá trần trong ngày giao dịch.
              x-parser-schema-id: <anonymous-schema-256>
            floorPrice:
              type: number
              description: Giá sàn trong ngày giao dịch.
              x-parser-schema-id: <anonymous-schema-257>
            productGrpId:
              type: string
              description: Nhóm sản phẩm theo thị trường.
              x-parser-schema-id: <anonymous-schema-258>
            securityGroupId:
              type: string
              description: Nhóm chứng khoán.
              x-parser-schema-id: <anonymous-schema-259>
            openInterestQuantity:
              type: integer
              format: int64
              description: Khối lượng hợp đồng phái sinh mở qua đêm.
              x-parser-schema-id: <anonymous-schema-260>
            securityStatus:
              type: string
              description: Trạng thái giao dịch của mã chứng khoán.
              x-parser-schema-id: <anonymous-schema-261>
            symbolAdminStatusCode:
              type: string
              description: Trạng thái quản lý hành chính mã chứng khoán.
              x-parser-schema-id: <anonymous-schema-262>
            symbolTradingMethodStatusCode:
              type: string
              description: Trạng thái cơ chế giao dịch mã chứng khoán.
              x-parser-schema-id: <anonymous-schema-263>
            symbolTradingSanctionStatusCode:
              type: string
              description: Tình trạng giao dịch của mã chứng khoán.
              x-parser-schema-id: <anonymous-schema-264>
            listingDate:
              oneOf:
                - type: string
                  x-parser-schema-id: <anonymous-schema-266>
                - type: integer
                  x-parser-schema-id: <anonymous-schema-267>
              description: Ngày niêm yết.
              x-parser-schema-id: <anonymous-schema-265>
            finalTradeDate:
              oneOf:
                - type: string
                  x-parser-schema-id: <anonymous-schema-269>
                - type: integer
                  x-parser-schema-id: <anonymous-schema-270>
                - type: 'null'
                  x-parser-schema-id: <anonymous-schema-271>
              description: Ngày giao dịch cuối cùng đối với mã phái sinh hoặc chứng quyền.
              x-parser-schema-id: <anonymous-schema-268>
            time:
              type: object
              description: Thời gian trong các message giá của sàn trả về.
              required:
                - Seconds
                - Nanos
              properties:
                Seconds:
                  type: integer
                  format: int64
                  description: Unix timestamp tính bằng giây.
                  x-parser-schema-id: <anonymous-schema-273>
                Nanos:
                  type: integer
                  format: int32
                  description: Phần nanosecond của timestamp.
                  x-parser-schema-id: <anonymous-schema-274>
              x-parser-schema-id: <anonymous-schema-272>
          x-parser-schema-id: <anonymous-schema-249>
        title: Cập nhật thông tin chứng khoán
        description: Bản cập nhật giá tham chiếu, biên độ và trạng thái chứng khoán.
        example: |-
          {
            "T": "sd",
            "marketId": "DVX",
            "boardId": "G1",
            "isin": "VN41I1G20009",
            "symbol": "41I1G2000",
            "productGrpId": "FIO",
            "securityGroupId": "FU",
            "basicPrice": 2066.6,
            "ceilingPrice": 2211.2,
            "floorPrice": 1922,
            "openInterestQuantity": 24473,
            "securityStatus": "NO_HALT",
            "symbolAdminStatusCode": "NRM",
            "symbolTradingMethodStatusCode": "NRM",
            "symbolTradingSanctionStatusCode": "NRM",
            "listingDate": 20260223,
            "finalTradeDate": 20260416,
            "time": {
              "Seconds": 1779757279,
              "Nanos": 101000000
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: update
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_1
receiveOperations:
  - *ref_2
sendMessages:
  - *ref_3
receiveMessages:
  - *ref_4
extensions:
  - id: x-parser-unique-object-id
    value: securityDefinitionStream
securitySchemes: []

````

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