> ## 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 mã, giá

> Lấy thông tin mã và giá của thị trường cơ sở.



## OpenAPI

````yaml /vi/openapi/tcbs.v1.openapi.yaml get /tartarus/v1/tickerCommons
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:
  /tartarus/v1/tickerCommons:
    get:
      tags:
        - market-data
      summary: Thông tin mã, giá
      description: Lấy thông tin mã và giá của thị trường cơ sở.
      operationId: getTartarusTickerCommons
      parameters:
        - name: tickers
          in: query
          required: false
          description: >-
            Danh sách mã cổ phiếu phân tách bằng dấu phẩy. Không dùng kết hợp
            với tham số index.
          schema:
            type: string
        - name: index
          in: query
          required: false
          description: >-
            Rổ chứng khoán: 1 = HOSE, 2 = VN30, 3 = HNX, 4 = HNX30, 5 = UPCOM,
            10 = Midcap, 11 = VN100, 12 = VNAllShare, 13 = VNSmallCap, 14 =
            VNXAllShare, 15 = VN50, 16 = VNSI. Không dùng kết hợp với tham số
            tickers.
          schema:
            type: number
            format: double
      responses:
        '200':
          description: Phản hồi thành công
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Danh sách thông tin mã.
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          description: Mã cổ phiếu.
                        ceilPrice:
                          type: number
                          format: double
                          description: Giá trần.
                        floorPrice:
                          type: number
                          format: double
                          description: Giá sàn.
                        refPrice:
                          type: number
                          format: double
                          description: Giá tham chiếu.
                        bidPrice01:
                          type: number
                          format: double
                          description: Dư mua giá 1.
                        bidPrice02:
                          type: number
                          format: double
                          description: Dư mua giá 2.
                        bidPrice03:
                          type: number
                          format: double
                          description: Dư mua giá 3.
                        bidQtty01:
                          type: number
                          format: double
                          description: Dư mua KL 1.
                        bidQtty02:
                          type: number
                          format: double
                          description: Dư mua KL 2.
                        bidQtty03:
                          type: number
                          format: double
                          description: Dư mua KL 3.
                        offerPrice01:
                          type: number
                          format: double
                          description: Dư bán giá 1.
                        offerPrice02:
                          type: number
                          format: double
                          description: Dư bán giá 2.
                        offerPrice03:
                          type: number
                          format: double
                          description: Dư bán giá 3.
                        offerQtty01:
                          type: number
                          format: double
                          description: Dư bán KL 1.
                        offerQtty02:
                          type: number
                          format: double
                          description: Dư bán KL 2.
                        offerQtty03:
                          type: number
                          format: double
                          description: Dư bán KL 3.
                        matchPrice:
                          type: number
                          format: double
                          description: Giá khớp.
                        matchQtty:
                          type: number
                          format: double
                          description: Khối lượng khớp.
                        change:
                          type: number
                          format: double
                          description: Thay đổi giá.
                        changePercent:
                          type: number
                          format: double
                          description: Phần trăm thay đổi.
                        open:
                          type: number
                          format: double
                          description: Giá mở cửa.
                        avg:
                          type: number
                          format: double
                          description: Giá trung bình.
                        high:
                          type: number
                          format: double
                          description: Giá cao nhất.
                        low:
                          type: number
                          format: double
                          description: Giá thấp nhất.
                        totalVol:
                          type: number
                          format: double
                          description: Tổng khối lượng giao dịch.
                        totalVal:
                          type: number
                          format: double
                          description: Tổng giá trị giao dịch.
                        buyForeignQtty:
                          type: number
                          format: double
                          description: KL mua nước ngoài.
                        sellForeignQtty:
                          type: number
                          format: double
                          description: KL bán nước ngoài.
                        room:
                          type: string
                          description: Room nước ngoài.
                        indexNumber:
                          type: number
                          format: double
                          description: Mã rổ chứng khoán.
                  tradingDate:
                    type: string
                    description: Ngày giao dịch (dd/MM/yyyy).
              example:
                data:
                  - symbol: FPT
                    ceilPrice: 106100
                    floorPrice: 92300
                    refPrice: 99200
                    bidPrice01: 98700
                    bidPrice02: 98600
                    bidPrice03: 98500
                    bidQtty01: 11300
                    bidQtty02: 56800
                    bidQtty03: 45600
                    offerPrice01: 98800
                    offerPrice02: 98900
                    offerPrice03: 99000
                    offerQtty01: 100
                    offerQtty02: 23200
                    offerQtty03: 56100
                    matchPrice: 98800
                    matchQtty: 100
                    change: -400
                    changePercent: -0.4032
                    open: 99200
                    avg: 98800
                    high: 99200
                    low: 98500
                    totalVol: 833900
                    totalVal: 82409370000
                    buyForeignQtty: 647300
                    sellForeignQtty: 648500
                    room: '84'
                    indexNumber: 1
                tradingDate: 29/10/2024
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  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.