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

# Chi tiết mã chứng khoán

> Truy vấn danh sách thông tin cơ bản của các mã chứng khoán theo điều kiện lọc.



## OpenAPI

````yaml https://cdn.entrade.com.vn/dnse-openapi/doc/dnse-openapi-2026-07-23.yaml get /instruments
openapi: 3.0.0
info:
  title: OpenAPI-V2-Spec 260730
  version: 1.0.0
  description: DNSE OpenAPI spec and tests
servers:
  - url: https://openapi-uat.dnse.com.vn
security: []
paths:
  /instruments:
    get:
      tags:
        - market-data
      summary: Chi tiết mã chứng khoán
      description: >-
        Truy vấn danh sách thông tin cơ bản của các mã chứng khoán theo điều
        kiện lọc.
      parameters:
        - name: symbol
          in: query
          description: Danh sách mã chứng khoán
          schema:
            type: string
          example: SSI,SHS,ACB,HUT,DSE
        - name: marketId
          in: query
          description: |-
            Mã thị trường niêm yết
            - STO: Cổ phiếu sàn HOSE
            - STX: Cổ phiếu sàn HNX
            - UPX: Cổ phiếu sàn UPCOM
            - DVX: Phái sinh
            - HCX: Trái phiếu doanh nghiệp
          schema:
            type: string
          example: STO
        - name: securityGroupId
          in: query
          description: |-
            Nhóm chứng khoán
            - ST: Cổ phiếu
            - EF: Quỹ ETF
            - EW: Chứng quyền
            - FU: Hợp đồng tương lai
            - BS: Trái phiếu
          schema:
            type: string
          example: ST
        - name: indexName
          in: query
          description: |-
            Chỉ số thị trường 
            - VN30: Top 30 cổ phiếu sàn HOSE
            - VN100: Top 100 cổ phiếu sàn HOSE
            - HNX30: Top 30 cổ phiếu sàn HNX
          schema:
            type: string
          example: VN30
        - name: limit
          in: query
          description: Số bản ghi trên mỗi trang
          schema:
            type: integer
          example: 100
        - name: page
          in: query
          description: Phân trang hiện tại
          schema:
            type: integer
          example: 1
        - name: X-API-Key
          in: header
          required: true
          description: API Key được cấp khi đăng ký dịch vụ
          schema:
            type: string
          example: '{{apiKey}}'
        - name: X-Aux-Date
          in: header
          required: true
          description: Thời gian thực hiện yêu cầu
          schema:
            type: string
          example: '{{date}}'
        - name: X-Signature
          in: header
          required: true
          description: Chữ ký xác thực yêu cầu
          schema:
            type: string
          example: '{{signature}}'
        - name: version
          in: header
          description: API version (YYYY-MM-DD)
          schema:
            type: string
            format: date
          example: '2026-07-23'
      responses:
        '200':
          description: OK
          headers:
            Access-Control-Allow-Credentials:
              deprecated: false
              schema: {}
              example: 'true'
            Content-Length:
              deprecated: false
              schema: {}
              example: '1388'
            Date:
              deprecated: false
              schema: {}
              example: Tue, 24 Mar 2026 06:16:46 GMT
            Vary:
              deprecated: false
              schema: {}
              example: Origin
            X-Content-Type-Options:
              deprecated: false
              schema: {}
              example: nosniff
            X-Frame-Options:
              deprecated: false
              schema: {}
              example: SAMEORIGIN
            X-Ratelimit-Limit:
              deprecated: false
              schema: {}
              example: '1000'
            X-Ratelimit-Remaining:
              deprecated: false
              schema: {}
              example: '993'
            X-Ratelimit-Reset:
              deprecated: false
              schema: {}
              example: '1774414805'
            X-Request-Id:
              deprecated: false
              schema: {}
              example: fpWsYgR7RLZP8Ys8YtpnDXi6m8fbRbVZ
            X-Tyk-Api-Expires:
              deprecated: false
              schema: {}
              example: Thu, 02 Jan 3000 15:04:00 UTC
            X-Xss-Protection:
              deprecated: false
              schema: {}
              example: 1; mode=block
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    example:
                      - symbol: ACB
                        marketId: STO
                        securityGroupId: ST
                        symbolType: ''
                        listedDate: '2020-12-09'
                        shortName: Ngân hàng Á Châu
                        name: Ngân hàng TMCP Á Châu
                        indexName:
                          - VN100
                          - VN30
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: ACB
                          description: Mã chứng khoán
                        marketId:
                          type: string
                          example: STO
                          description: |-
                            Mã thị trường niêm yết mã chứng khoán
                            - DVX: Phái sinh sàn HNX
                            - HCX: Trái phiếu doanh nghiệp HNX
                            - STO: Cổ phiếu sàn HOSE
                            - STX: Cổ phiếu sàn HNX
                            - UPX: Cổ phiếu sàn Upcom
                        securityGroupId:
                          type: string
                          example: ST
                          description: |-
                            Nhóm chứng khoán
                            - BS: Trái phiếu doanh nghiệp
                            - EF: Quỹ ETF
                            - EW: Chứng quyền
                            - FU: Hợp đồng tương lai
                            - ST: Cổ phiếu
                        symbolType:
                          type: string
                          example: ''
                          description: >-
                            Phân loại mã hợp đồng phái sinh theo thời gian đáo
                            hạn (áp dụng cho DERIVATIVE)

                            - VN30F1M: HĐTL chỉ số VN30 1 tháng

                            - VN30F2M: HĐTL chỉ số VN30 2 tháng

                            - VN30F1Q: HĐTL chỉ số VN30 1 quý

                            - VN30F2Q: HĐTL chỉ số VN30 2 quý
                        listedDate:
                          type: string
                          example: '2020-12-09'
                          description: Ngày niêm yết
                        shortName:
                          type: string
                          example: Ngân hàng Á Châu
                          description: Tên viết tắt của tổ chức phát hành
                        name:
                          type: string
                          example: Ngân hàng TMCP Á Châu
                          description: Tên đầy đủ của tổ chức phát hành
                        indexName:
                          type: array
                          example:
                            - VN100
                          items:
                            type: string
                            example: VN100
                            description: ''
                          description: Danh sách chỉ số mà mã chứng khoán thuộc về (nếu có)
                    description: Danh sách thông tin mã chứng khoán
                  total:
                    type: integer
                    format: int32
                    example: 2
                    description: Tổng số bản ghi
                  page:
                    type: integer
                    format: int32
                    example: 1
                    description: Trang hiện tại (bắt đầu từ 1)
                  pageSize:
                    type: integer
                    format: int32
                    example: 100
                    description: Số bản ghi trên mỗi trang
              example:
                data:
                  - symbol: ACB
                    marketId: STO
                    securityGroupId: ST
                    symbolType: ''
                    listedDate: '2020-12-09'
                    shortName: Ngân hàng Á Châu
                    name: Ngân hàng TMCP Á Châu
                    indexName:
                      - VN100
                      - VN30
                  - symbol: DSE
                    marketId: STO
                    securityGroupId: ST
                    symbolType: ''
                    listedDate: '2024-07-01'
                    shortName: Chứng khoán DNSE
                    name: CTCP Chứng khoán DNSE
                    indexName:
                      - VN100
                  - symbol: HUT
                    marketId: STX
                    securityGroupId: ST
                    symbolType: ''
                    listedDate: '2008-04-11'
                    shortName: CTCP TASCO
                    name: CTCP Tasco
                    indexName:
                      - HNX30
                  - symbol: SHS
                    marketId: STX
                    securityGroupId: ST
                    symbolType: ''
                    listedDate: '2009-06-25'
                    shortName: Chứng khoán SG HN
                    name: CTCP Chứng khoán Sài Gòn - Hà Nội
                    indexName:
                      - HNX30
                  - symbol: SSI
                    marketId: STO
                    securityGroupId: ST
                    symbolType: ''
                    listedDate: '2007-10-29'
                    shortName: Chứng khoán SSI
                    name: CTCP Chứng khoán SSI
                    indexName:
                      - VN100
                      - VN30
                total: 5
                page: 1
                pageSize: 100
        '400':
          description: Yêu cầu không hợp lệ
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  status:
                    type: integer
              example:
                code: OA-003
                message: Thông tin nhập không hợp lệ
                status: 400
        '500':
          description: Lỗi hệ thống
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 500
                    description: Mã HTTP
                    format: int32
                  code:
                    type: string
                    example: OA-009
                    description: Mã lỗi
                  message:
                    type: string
                    example: Lỗi hệ thống
                    description: Thông điệp lỗi
              example:
                code: OA-009
                message: Lỗi hệ thống
                status: 500

````

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