api-ninjas-com Stock Split API

openapi: 3.2.0
info:
  title: Ninjas Stock Split API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Stock Split
  description: The Stock Split API provides historical and upcoming stock split data for companies listed on the world's largest stock exchanges. Look up a company's full split history by ticker, or query a forward / reverse split calendar by date range and exchange.
paths:
  /v1/stocksplit:
    get:
      tags:
      - Stock Split
      summary: Get stock split records matching your filters
      description: Returns historical and upcoming stock split records filtered by ticker, exchange, forward or reverse split type, and a single date or date range.
      operationId: getStockSplit
      parameters:
      - name: ticker
        in: query
        required: false
        description: Company ticker symbol. For U.S.-listed stocks use the bare symbol (e.g. GOOG); for international listings include the exchange suffix as the symbol trades (e.g. 7203.T for Toyota on Tokyo, RELIANCE.NS for Reliance on NSE India). Returns that company's full split history. Share classes and preferred shares can be written in any common form, e.g. BRK.B, BRK-B, BRK/B or BRKB, and BAC.PRL or BAC-PL. Non-US stocks take an exchange suffix (SHEL.L, 7203.T) or prefix (LON:SHEL).
        schema:
          type: string
      - name: exchange
        in: query
        required: false
        description: Filter results to a single exchange by its code - for example US, JPX (Tokyo), LSE (London), HKSE (Hong Kong), or NSE (India). US covers every US venue; pass a venue such as NASDAQ or NYSE to narrow it.
        schema:
          type: string
      - name: split_type
        in: query
        required: false
        description: 'Filter by split direction: forward (e.g. 4-for-1) or reverse (a consolidation, e.g. 1-for-10).'
        schema:
          type: string
          enum:
          - forward
          - reverse
      - name: date
        in: query
        required: false
        description: Single date in YYYY-MM-DD format. Cannot be combined with date_start or date_end.
        schema:
          type: string
      - name: date_start
        in: query
        required: false
        description: Range start in YYYY-MM-DD format. Free-tier users cannot query earlier than 24 months ago.
        schema:
          type: string
      - name: date_end
        in: query
        required: false
        description: Range end in YYYY-MM-DD format.
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: Maximum results to return. Default 50, max 1000.
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        description: Number of results to skip for pagination. Default 0.
        schema:
          type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/StockSplit'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  schemas:
    StockSplit:
      type: object
      properties:
        ticker:
          type: string
          description: Company ticker symbol, including the exchange suffix for international listings.
          example: GOOG
        name:
          type: string
          description: Company name.
          example: Alphabet Inc.
        short_name:
          type: string
          description: Company name with the trailing legal form (Inc., Ltd., Corp., etc.) removed.
          example: Alphabet
        exchange:
          type: string
          description: Exchange code for the listing (e.g. US, JPX, HKSE, LSE, or NSE).
          example: US
        venue:
          type: string
          description: Listing venue (e.g. NASDAQ, NYSE or OTC for US listings); the same as exchange elsewhere.
          example: NASDAQ
        date:
          type: string
          description: Effective (ex-) date of the split (YYYY-MM-DD).
          example: '2022-07-18'
        numerator:
          type: number
          description: Shares held after the split (the 4 in a 4-for-1 split).
          example: 20
        denominator:
          type: number
          description: Shares held before the split (the 1 in a 4-for-1 split).
          example: 1
        ratio:
          type: string
          description: Human-readable split ratio, e.g. 4:1 or 1:10.
          example: '20:1'
        split_factor:
          type: number
          description: Numeric multiplier (numerator / denominator) - e.g. 4 for a 4-for-1 split, 0.1 for a 1-for-10 reverse split. Use it to back-adjust historical prices and share counts.
          example: 20
        split_type:
          type: string
          description: forward when numerator >= denominator; reverse for a consolidation.
          example: forward
        currency:
          type: string
          description: Trading currency of the listing (e.g. USD, JPY, HKD).
          example: USD
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api