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

# Tra cứu thông tin chứng khoán

> Tra cứu thông tin chi tiết của mã chứng khoán: thông tin niêm yết, giá trần/sàn, sàn giao dịch, loại chứng khoán, hạn mức giao dịch, v.v.



## OpenAPI

````yaml /vi/openapi/tcbs.v1.openapi.yaml get /ananke/v1/securities
openapi: 3.0.3
info:
  title: TCBS iFlash Open API
  description: REST APIs for trading stocks and derivatives on TCBS.
  version: 1.0.0
  contact:
    email: openapi@tcbs.com.vn
servers:
  - url: https://openapi.tcbs.com.vn
    description: Production
security:
  - bearerAuth: []
tags:
  - name: authentication
    description: Xác thực và cấp token truy cập.
    x-group: Xác thực
  - name: account
    description: Thông tin tài khoản, tài sản và hạn mức.
    x-group: Tài khoản
  - name: market-data
    description: Dữ liệu chứng khoán và phái sinh.
    x-group: Dữ liệu thị trường
  - name: cash
    description: Giao dịch và thông tin tiền.
    x-group: Tiền
  - name: stock-orders
    description: Đặt, sửa, hủy và tra cứu lệnh cổ phiếu.
    x-group: Lệnh cổ phiếu
  - name: derivative-orders
    description: Đặt, sửa, hủy và tra cứu lệnh phái sinh.
    x-group: Lệnh phái sinh
paths:
  /ananke/v1/securities:
    get:
      tags:
        - market-data
      summary: Tra cứu thông tin chứng khoán
      description: >-
        Tra cứu thông tin chi tiết của mã chứng khoán: thông tin niêm yết, giá
        trần/sàn, sàn giao dịch, loại chứng khoán, hạn mức giao dịch, v.v.
      operationId: getAnankeSecurities
      parameters:
        - name: fields
          in: query
          required: false
          description: 'Các trường cần trả về. Mặc định: all.'
          schema:
            type: string
        - name: filter
          in: query
          required: false
          description: 'Bộ lọc theo cú pháp trường=giá trị, ví dụ: symbol=TCB.'
          schema:
            type: string
      responses:
        '200':
          description: Phản hồi thành công
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecuritiesResponse'
              example:
                content:
                  - codeId: '003415'
                    issuerId: '0000001736'
                    issuerName: Công ty cổ phần Kỹ thương
                    symbol: TCB
                    secType: '001'
                    investmentType: '002'
                    issueDate: '2016-12-14T00:00:00.000+07:00'
                    expDate: '2016-12-14T00:00:00.000+07:00'
                    underlyingSymbol: ''
                    coveredWarrantType: ''
                    exercisePrice: 0
                    parValue: 10000
                    tradePlace: '001'
                    status: 'Y'
                    halt: 'N'
                    securitiesInfo:
                      symbol: TCB
                      status: '001'
                      listingQtty: 3517238514
                      txDate: '2016-12-13'
                      listingStatus: 'N'
                      tradeUnit: 1000
                      ceilingPrice: 56700
                      floorPrice: 49300
                      basicPrice: 53000
                      tradeLot: 100
                      tradeBuySell: 'Y'
                      marginLimitMax: 0
                      currentRoom: 0
                      securedRatioMax: 102
                      mortageRatioMax: 0
                totalElements: 1
                totalPages: 1
                size: 1000
                number: 0
                first: true
                last: true
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    SecuritiesResponse:
      type: object
      description: Danh sách chứng khoán có phân trang.
      properties:
        content:
          type: array
          description: Danh sách chứng khoán.
          items:
            $ref: '#/components/schemas/Security'
        totalElements:
          type: integer
          format: int64
          description: Tổng số bản ghi.
        totalPages:
          type: integer
          format: int64
          description: Tổng số trang.
        size:
          type: integer
          format: int64
          description: Số bản ghi mỗi trang (mặc định 1000).
        number:
          type: integer
          format: int64
          description: Trang hiện tại (0-indexed).
        first:
          type: boolean
          description: Có phải trang đầu.
        last:
          type: boolean
          description: Có phải trang cuối.
    Security:
      type: object
      description: Thông tin cơ bản của một chứng khoán.
      properties:
        codeId:
          type: string
          description: Mã số quy ước của chứng khoán.
        issuerId:
          type: string
          description: Mã tổ chức phát hành.
        issuerName:
          type: string
          description: Tên tổ chức phát hành.
        symbol:
          type: string
          description: Mã niêm yết giao dịch.
        secType:
          type: string
          description: >-
            Phân loại chứng khoán: 001 = cổ phiếu phổ thông, 002 = cổ phiếu ưu
            đãi, 003 = trái phiếu chuyển đổi, 006 = trái phiếu.
          enum:
            - '001'
            - '002'
            - '003'
            - '006'
        investmentType:
          type: string
          description: 'Hình thức đầu tư: 001 = ngắn hạn, 002 = dài hạn.'
          enum:
            - '001'
            - '002'
        issueDate:
          type: string
          format: date-time
          description: Ngày phát hành.
        expDate:
          type: string
          format: date-time
          description: Ngày hết hạn.
        underlyingSymbol:
          type: string
          description: Mã gốc, ví dụ mã chứng quyền.
        coveredWarrantType:
          type: string
          description: Loại chứng quyền.
        exercisePrice:
          type: number
          description: Giá quyền.
        parValue:
          type: number
          description: Mệnh giá chứng khoán.
        tradePlace:
          type: string
          description: 'Nơi giao dịch: 001 = HOSE, 002 = HNX, 005 = UPCOM.'
          enum:
            - '001'
            - '002'
            - '005'
        status:
          type: string
          description: Có sử dụng hay không (Y/N).
          enum:
            - 'Y'
            - 'N'
        halt:
          type: string
          description: Tạm ngừng giao dịch (Y/N).
          enum:
            - 'Y'
            - 'N'
        securitiesInfo:
          $ref: '#/components/schemas/SecuritiesInfo'
    SecuritiesInfo:
      type: object
      description: Thông tin chi tiết niêm yết của chứng khoán.
      properties:
        symbol:
          type: string
          description: Mã niêm yết.
        status:
          type: string
          description: >-
            Trạng thái giao dịch: 001 = bình thường, 002 = tạm ngừng, 003 =
            dừng, 004 = giám sát, 005 = cảnh báo.
          enum:
            - '001'
            - '002'
            - '003'
            - '004'
            - '005'
        listingQtty:
          type: integer
          format: int64
          description: Tổng khối lượng niêm yết.
        txDate:
          type: string
          format: date
          description: Ngày giao dịch.
        listingStatus:
          type: string
          description: >-
            Trạng thái niêm yết: N = bình thường, L = niêm yết mới, U = hủy, I =
            tăng vốn, D = giảm vốn.
          enum:
            - 'N'
            - L
            - U
            - I
            - D
        tradeUnit:
          type: integer
          format: int64
          description: Đơn vị giá giao dịch.
        ceilingPrice:
          type: integer
          format: int64
          description: Giá trần.
        floorPrice:
          type: integer
          format: int64
          description: Giá sàn.
        basicPrice:
          type: integer
          format: int64
          description: Giá tham chiếu.
        tradeLot:
          type: integer
          format: int64
          description: Đơn vị khối lượng giao dịch.
        tradeBuySell:
          type: string
          description: Cho phép mua bán cùng ngày (Y/N).
          enum:
            - 'Y'
            - 'N'
        marginLimitMax:
          type: integer
          format: int64
          description: Hạn mức giao dịch margin tối đa.
        currentRoom:
          type: integer
          format: int64
          description: Room còn lại của nhà đầu tư nước ngoài.
        securedRatioMax:
          type: number
          description: Tỷ lệ ký quỹ tối đa.
        mortageRatioMax:
          type: number
          description: Tỷ lệ cầm cố tối đa.
  responses:
    Unauthorized:
      description: Không xác thực — thiếu, sai hoặc không hợp lệ Bearer token.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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