api-ninjas-com Ticker API

openapi: 3.2.0
info:
  title: Ninjas Ticker 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: Ticker
  description: The Ticker API provides comprehensive company profile information for publicly traded companies, including executive details, financial metrics, identifiers, and contact information.
paths:
  /v1/ticker:
    get:
      summary: Get detailed company profile information for any given ticker symbol
      description: Returns the company profile for a ticker symbol, including executive details, financial metrics, identifiers, and contact information. Requires a `ticker`.
      operationId: getTicker
      tags:
      - Ticker
      parameters:
      - name: ticker
        in: query
        description: Stock ticker symbol (e.g., AAPL). 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).
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerOpenapi_Error'
      security:
      - ApiKeyAuth: []
  /v1/tickersearch:
    get:
      summary: Search for ticker symbols by company name
      description: Searches ticker symbols by company name, with optional negative keywords to exclude matches. Requires a `name`. For the full profile of a symbol use /ticker.
      operationId: searchTickers
      tags:
      - Ticker
      parameters:
      - name: name
        in: query
        description: Company name to search for (e.g., Apple).
        required: true
        schema:
          type: string
      - name: negative_keywords
        in: query
        description: Comma-separated list of keywords to filter out from results. If any negative keyword appears in a company name (case-insensitive), that result will be excluded (e.g., pineapple,appleseed).
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TickerSearchResult'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerOpenapi_Error'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    TickerSearchResult:
      type: object
      properties:
        ticker:
          type: string
          example: AAPL
        company_name:
          type: string
          example: Apple Inc.
        exchange:
          type: string
          example: NASDAQ
        logo_url:
          type:
          - string
          - 'null'
          example: https://media.api-ninjas.com/ticker_logos/AAPL_7c799a12f38f.png
          description: URL of the company logo as a PNG.
    TickerOpenapi_Error:
      type: object
      properties:
        message:
          type: string
    TickerResponse:
      type: object
      properties:
        name:
          type: string
          example: Apple Inc.
        ticker:
          type: string
          example: AAPL
        logo_url:
          type:
          - string
          - 'null'
          example: https://media.api-ninjas.com/ticker_logos/AAPL_7c799a12f38f.png
          description: URL of the company logo as a PNG. Premium only.
        chief_executive_officer:
          type: string
          example: Timothy D. Cook
        address:
          type: object
          properties:
            address:
              type: string
              example: One Apple Park Way
            city:
              type: string
              example: Cupertino
            state:
              type: string
              example: CA
            zip:
              type: string
              example: '95014'
        latest_price:
          type:
          - number
          - 'null'
          example: 269.05
          description: Latest stock price. Premium only.
        latest_market_cap:
          type:
          - number
          - 'null'
          example: 3992809620000
          description: Latest market capitalization. Premium only.
        latest_dividend:
          type:
          - number
          - 'null'
          example: 1.02
          description: Total dividends per share over the trailing 12 months, in the currency the stock is quoted in. 0 if the company pays no dividend. Premium only.
        dividend_yield:
          type:
          - number
          - 'null'
          example: 0.38
          description: Trailing 12-month dividend yield as a percentage (latest_dividend divided by latest_price; 2.69 means 2.69%). 0 if the company pays no dividend. Premium only.
        cik:
          type: string
          example: 0000320193
        cusip:
          type: string
          example: 037833100
        isin:
          type: string
          example: US0378331005
        exchange:
          type: string
          example: NASDAQ
        website:
          type: string
          example: https://www.apple.com
        phone_number:
          type: string
          example: (408) 996-1010
        ipo_date:
          type:
          - string
          - 'null'
          format: date
          example: '1980-12-12'
          description: Initial public offering date in YYYY-MM-DD format. Premium only.
        latest_earnings:
          type: object
          properties:
            year:
              type: integer
              example: 2025
            quarter:
              type: integer
              example: 4
        sector:
          type:
          - string
          - 'null'
          example: Technology
          description: Company sector in the API Ninjas classification (e.g. Technology, Financials, Health Care). Available for all companies. Premium only.
        industry:
          type:
          - string
          - 'null'
          example: Computer Hardware
          description: Company industry (sub-sector) within its sector (e.g. Semiconductors, Banks, Airlines). Available for all companies. Premium only.
        sic_code:
          type:
          - string
          - 'null'
          example: '3571'
          description: Standard Industrial Classification (SIC) code from the company's SEC filing. US-listed companies only. Premium only.
        sic_description:
          type:
          - string
          - 'null'
          example: Electronic Computers
          description: Human-readable description of the SIC code. US-listed companies only. Premium only.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api