openapi: 3.1.0
info:
  title: FCS API API
  version: '2026-10-16'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-16: 11 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; FCS API has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 8
    pages-with-code: 3
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-16'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://fcsapi.com/document/chart-api
  - https://fcsapi.com/document/forex-api
  - https://fcsapi.com/document/stock-api
servers:
- url: https://api-v4.fcsapi.com
paths:
  //stock/forecast:
    get:
      operationId: get_stock_forecast
      tags:
      - Stock
      summary: Stock Market API - Real-Time Stock Prices
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: symbol
        in: query
        required: true
        schema:
          type: string
        description: Stock ticker symbol
      - name: access_key
        in: query
        required: true
        schema:
          type: string
        description: API authentication key
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStockForecastResponse'
      x-evidence:
        kind: documentation
  //stock/indices:
    get:
      operationId: get_stock_indices
      tags:
      - Stock
      summary: Stock Market API - Real-Time Stock Prices
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: country
        in: query
        required: true
        schema:
          type: string
        description: Country filter for indices
      - name: access_key
        in: query
        required: true
        schema:
          type: string
        description: API authentication key
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStockIndicesResponse'
      x-evidence:
        kind: documentation
  //stock/list:
    get:
      operationId: get_stock_list
      tags:
      - Stock
      summary: Stock Market API - Real-Time Stock Prices
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: country
        in: query
        required: true
        schema:
          type: string
        description: Country filter for stock list
      - name: access_key
        in: query
        required: true
        schema:
          type: string
        description: API authentication key
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStockListResponse'
      x-evidence:
        kind: documentation
  //stock/profile:
    get:
      operationId: get_stock_profile
      tags:
      - Stock
      summary: Stock Market API - Real-Time Stock Prices
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: symbol
        in: query
        required: true
        schema:
          type: string
        description: Stock ticker symbol
      - name: access_key
        in: query
        required: true
        schema:
          type: string
        description: API authentication key
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStockProfileResponse'
      x-evidence:
        kind: documentation
  /RAW:
    post:
      operationId: post_RAW
      tags:
      - Raw
      summary: Forex API - Real-Time Currency Exchange Rates
      x-source: https://fcsapi.com/document/forex-api
      parameters:
      - name: type
        in: query
        required: false
        schema:
          type: string
      - name: sub_type
        in: query
        required: false
        schema:
          type: string
      - name: exchange
        in: query
        required: false
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: number
      - name: per_page
        in: query
        required: false
        schema:
          type: string
      - name: access_key
        in: query
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /forex:
    get:
      operationId: get_forex
      tags:
      - Forex
      summary: GET /forex
      x-source: https://fcsapi.com/document/forex-api
      parameters:
      - name: access_key
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetForexResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Drive me to code Example Copy curl \"https://api-v4.fcsapi.com/forex/?access_key={YOUR KEY}\" Symbols List cURL PostMan\
          \ Drive me to code Example Copy curl \"https://api-v4.fcsapi.com//forex/list?type=forex&access_key=API_KEY\" Using PostMan you can send\
          \ Request: GET/POST/JSON RAW {\n \"type\": \"forex\",\n \"sub_type\": \"spot\",\n \"exchange\": \"\",\n \"page\": 1,\n \"per_page\"\
          : \"1\",\n \"access_key\": \"API_KEY\"\n} Res"
  /forex/jwt_token:
    get:
      operationId: get_forex_jwt_token
      tags:
      - Forex
      summary: GET /forex/jwt_token
      x-source: https://fcsapi.com/document/chart-api
      parameters:
      - name: public_key
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetForexJwtTokenResponse'
      x-evidence:
        kind: code-example
        language: javascript
        snippet: fetch('https://api-v4.fcsapi.com/forex/jwt_token?public_key=YOUR_PUBLIC_KEY')
  /forex/{forexid}:
    post:
      operationId: post_forex_forexid
      tags:
      - Forex
      summary: Forex API - Real-Time Currency Exchange Rates
      x-source: https://fcsapi.com/document/forex-api
      parameters:
      - name: forexid
        in: path
        required: true
        schema:
          type: string
      - name: access_key
        in: query
        required: true
        schema:
          type: string
      - name: symbol
        in: query
        required: false
        schema:
          type: string
      - name: exchange
        in: query
        required: false
        schema:
          type: string
      - name: type
        in: query
        required: false
        schema:
          type: string
      - name: sub_type
        in: query
        required: false
        schema:
          type: string
      - name: period
        in: query
        required: false
        schema:
          type: string
      - name: columns
        in: query
        required: false
        schema:
          type: string
      - name: keep_parent_colm
        in: query
        required: false
        schema:
          type: number
      - name: filters
        in: query
        required: false
        schema:
          type: array
      - name: sort_by
        in: query
        required: false
        schema:
          type: string
      - name: merge
        in: query
        required: false
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: number
      - name: per_page
        in: query
        required: false
        schema:
          type: string
      - name: search
        in: query
        required: false
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 11 example path(s) differing only at forexId
  /stock:
    get:
      operationId: get_stock
      tags:
      - Stock
      summary: GET /stock
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: access_key
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStockResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Drive me to code Example Copy curl \"https://api-v4.fcsapi.com/stock/?access_key=API_KEY\" Exchange Report API cURL Drive\
          \ me to code Example Copy curl \"https://api-v4.fcsapi.com/stock/report?type=stock&access_key=API_KEY\" Response Example {\n \"status\"\
          : true,\n \"code\": 200,\n \"msg\": \"Successfully\",\n \"response\": {\n \"by_type\": [\n {\n \"type\": \"stock\",\n \"total_symbols\"\
          : \"6125\",\n \"socket_support_yes\": \"1"
  /stock/{stockid}:
    get:
      operationId: get_stock_stockid
      tags:
      - Stock
      summary: Stock Market API - Real-Time Stock Prices
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: stockid
        in: path
        required: true
        schema:
          type: string
      - name: symbol
        in: query
        required: true
        schema:
          type: string
        description: Comma‑separated list of symbols
      - name: merge
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of APIs to merge
      - name: period
        in: query
        required: false
        schema:
          type: string
        description: Time period for chart data
      - name: access_key
        in: query
        required: true
        schema:
          type: string
        description: API authentication key
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStockStockidResponse'
      x-evidence:
        kind: documentation
        collapsed_from: 15 example path(s) differing only at stockId
    post:
      operationId: post_stock_stockid
      tags:
      - Stock
      summary: Stock Balance Sheet Data
      x-source: https://fcsapi.com/document/stock-api
      parameters:
      - name: stockid
        in: path
        required: true
        schema:
          type: string
      - name: access_key
        in: query
        required: true
        schema:
          type: string
        description: API KEY Authentication
      - name: symbol
        in: query
        required: false
        schema:
          type: string
        description: Stock ticker symbol
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostStockStockidResponse'
      x-evidence:
        kind: documentation
        collapsed_from: 16 example path(s) differing only at stockId
components:
  schemas:
    GetStockForecastResponse:
      type: object
      properties:
        forecast:
          type: object
          description: Price target forecasts
    GetStockIndicesResponse:
      type: object
      properties:
        response:
          type: array
          description: List of index objects
    GetStockListResponse:
      type: object
      properties:
        response:
          type: array
          description: List of stock objects
    GetStockProfileResponse:
      type: object
      properties:
        response:
          type: array
          description: Profile details
    GetForexResponse:
      type: object
      properties:
        ticker:
          type: string
        profile:
          type: object
          properties:
            symbol:
              type: string
            exchange:
              type: string
            currency:
              type: string
            name:
              type: string
            type:
              type: string
            sub_type:
              type: string
            base_logo:
              type: string
            curr_logo:
              type: string
            exc_logo:
              type: string
        meta:
          type: object
          properties:
            logoid:
              type: string
            update_mode:
              type: string
            fractional:
              type: string
            base_logo:
              type: string
            curr_logo:
              type: string
            market:
              type: string
            base_currency_desc:
              type: string
            currency_desc:
              type: string
            minmov:
              type: integer
            pricescale:
              type: integer
            base_currency:
              type: string
            base_id:
              type: string
            exc_logo:
              type: string
            country:
              type: string
    GetForexJwtTokenResponse:
      type: object
      properties:
        price:
          type: integer
        color:
          type: string
        label:
          type: string
        style:
          type: string
    GetStockResponse:
      type: object
      properties:
        status:
          type: boolean
        code:
          type: integer
        msg:
          type: string
        response:
          type: object
          properties:
            by_type:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  total_symbols:
                    type: string
                  socket_support_yes:
                    type: string
                  socket_support_no:
                    type: string
                  no_of_exchanges:
                    type: string
            by_exchange:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  exchange:
                    type: string
                  total_symbols:
                    type: string
                  socket_support_yes:
                    type: string
                  socket_support_no:
                    type: string
        info:
          type: object
          properties:
            server_time:
              type: string
              format: date-time
            credit_count:
              type: integer
            process_time:
              type: string
    GetStockStockidResponse:
      type: object
      properties:
        response:
          type: object
          description: Combined data including latest price and profile
    PostStockStockidResponse:
      type: object
      properties:
        interim/Yearly:
          type: object
          description: Balance sheet totals
        total_liabilities:
          type: object
          description: Liabilities values
        equity:
          type: object
          description: Equity values
tags:
- name: Forex
- name: Raw
- name: Stock