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

# Cung cầu theo tháng

> Lấy dữ liệu cung cầu theo tháng của mã cổ phiếu.



## OpenAPI

````yaml /vi/openapi/tcbs.v1.openapi.yaml get /nyx/v1/intraday/{ticker}/bsa-month
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:
  /nyx/v1/intraday/{ticker}/bsa-month:
    get:
      tags:
        - market-data
      summary: Cung cầu theo tháng
      description: Lấy dữ liệu cung cầu theo tháng của mã cổ phiếu.
      operationId: getNyxIntradayTickerBsaMonth
      parameters:
        - name: ticker
          in: path
          required: true
          description: Mã cổ phiếu, ví dụ TCB.
          schema:
            type: string
        - name: timeWindow
          in: query
          required: false
          description: 'Khung thời gian: 1M.'
          schema:
            type: string
        - name: type
          in: query
          required: false
          description: >-
            Loại nhà đầu tư: sheep (small retail), wolf (medium institutional),
            shark (large institutional), all (mặc định).
          schema:
            $ref: '#/components/schemas/InvestorType'
      responses:
        '200':
          description: Phản hồi thành công
          content:
            application/json:
              schema:
                type: object
                properties:
                  ticker:
                    type: string
                    description: Mã cổ phiếu.
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        bup:
                          type: number
                          format: double
                          description: Tỷ lệ % mua tích cực.
                        sdp:
                          type: number
                          format: double
                          description: Tỷ lệ % bán tiêu cực.
                        bsr:
                          type: number
                          format: double
                          description: Tỷ lệ mua/bán.
                        t:
                          type: string
                          description: Thời gian (DD/MM).
              example:
                ticker: TCB
                data:
                  - bup: 0.65
                    sdp: 0.35
                    bsr: 1.25
                    t: 07/05
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    InvestorType:
      type: string
      description: >-
        Loại nhà đầu tư: sheep = cá nhân nhỏ lẻ, wolf = tổ chức vừa, shark = tổ
        chức lớn, all = tất cả.
      enum:
        - sheep
        - wolf
        - shark
        - all
  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.