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

# Monthly supply & demand

> Get monthly supply and demand data for a stock symbol.



## OpenAPI

````yaml /en/openapi/tcbs-v1.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: []
paths:
  /nyx/v1/intraday/{ticker}/bsa-month:
    get:
      summary: Monthly supply & demand
      description: Get monthly supply and demand data for a stock symbol.
      parameters:
        - name: ticker
          in: path
          required: true
          description: Stock symbol, e.g. TCB.
          schema:
            type: string
        - name: timeWindow
          in: query
          required: false
          description: 'Time frame: 1M.'
          schema:
            type: string
        - name: type
          in: query
          required: false
          description: >-
            Investor type: sheep (small retail), wolf (medium institutional),
            shark (large institutional), all (default).
          schema:
            $ref: '#/components/schemas/InvestorType'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ticker:
                    type: string
                    description: Stock symbol.
                  data[].bup:
                    type: number
                    format: double
                    description: Buy Up Percent.
                  data[].sdp:
                    type: number
                    format: double
                    description: Sell Down Percent.
                  data[].bsr:
                    type: number
                    format: double
                    description: Buy/Sell Ratio.
                  data[].t:
                    type: string
                    description: Time (DD/MM).
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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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