Finnhub Default API

The Default API from Finnhub — 117 operation(s) for default.

Operations 117

GET /stock/symbol Stock Symbol #
GET /stock/market-status Market Status #
GET /stock/market-holiday Market Holiday #
GET /stock/profile Company Profile #
GET /stock/profile2 Company Profile 2 #
GET /stock/executive Company Executive #
GET /news Market News #
GET /company-news Company News #
GET /press-releases Major Press Releases #
GET /news-sentiment News Sentiment #
GET /stock/peers Peers #
GET /stock/metric Basic Financials #
GET /stock/price-metric Price Metrics #
GET /ca/symbol-change Symbol Change #
GET /ca/isin-change ISIN Change #
GET /stock/historical-market-cap Historical Market Cap #
GET /stock/historical-employee-count Historical Employee Count #
GET /institutional/profile Institutional Profile #
GET /institutional/portfolio Institutional Portfolio #
GET /institutional/ownership Institutional Ownership #
GET /stock/ownership Ownership #
GET /stock/fund-ownership Fund Ownership #
GET /stock/insider-transactions Insider Transactions #
GET /stock/insider-sentiment Insider Sentiment #
GET /stock/financials Financial Statements #
GET /stock/financials-reported Financials As Reported #
GET /stock/revenue-breakdown Revenue Breakdown #
GET /stock/filings SEC Filings #
GET /stock/filings-sentiment SEC Sentiment Analysis #
GET /stock/similarity-index Similarity Index #
GET /calendar/ipo IPO Calendar #
GET /sector/metrics Sector Metrics #
GET /stock/dividend Dividends #
GET /stock/price-target Price Target #
GET /stock/upgrade-downgrade Stock Upgrade/Downgrade #
GET /stock/revenue-estimate Revenue Estimates #
GET /stock/ebitda-estimate EBITDA Estimates #
GET /stock/ebit-estimate EBIT Estimates #
GET /stock/net-income-estimate Net Income Estimates #
GET /stock/pretax-income-estimate Pretax Income Estimates #
GET /stock/gross-income-estimate Gross Income Estimates #
GET /stock/dps-estimate DPS Estimates #
GET /stock/fcf-estimate FCF Estimates #
GET /stock/capex-estimate Capex Estimates #
GET /stock/ocf-estimate OCF Estimates #
GET /stock/eps-estimate Earnings Estimates #
GET /stock/earnings Earnings Surprises #
GET /calendar/earnings Earnings Calendar #
GET /quote Quote #
GET /stock/candle Stock Candles #
GET /stock/tick Tick Data #
GET /stock/bbo Historical NBBO #
GET /stock/bidask Last Bid-Ask #
GET /stock/split Splits #
GET /stock/dividend2 Dividends 2 (Basic) #
GET /index/constituents Indices Constituents #
GET /index/historical-constituents Indices Historical Constituents #
GET /etf/profile ETFs Profile #
GET /etf/holdings ETFs Holdings #
GET /etf/sector ETFs Sector Exposure #
GET /etf/country ETFs Country Exposure #
GET /etf/allocation ETFs Equity Allocation #
GET /mutual-fund/profile Mutual Funds Profile #
GET /mutual-fund/holdings Mutual Funds Holdings #
GET /mutual-fund/sector Mutual Funds Sector Exposure #
GET /mutual-fund/country Mutual Funds Country Exposure #
GET /mutual-fund/eet Mutual Funds EET #
GET /mutual-fund/eet-pai Mutual Funds EET PAI #
GET /forex/exchange Forex Exchanges #
GET /forex/symbol Forex Symbol #
GET /forex/candle Forex Candles #
GET /forex/rates Forex rates #
GET /crypto/exchange Crypto Exchanges #
GET /crypto/symbol Crypto Symbol #
GET /crypto/profile Crypto Profile #
GET /crypto/candle Crypto Candles #
GET /scan/pattern Pattern Recognition #
GET /scan/support-resistance Support/Resistance #
GET /scan/technical-indicator Aggregate Indicators #
GET /indicator Technical Indicators #
GET /stock/transcripts/list Earnings Call Transcripts List #
GET /stock/transcripts Earnings Call Transcripts #
GET /stock/earnings-call-live Earnings Call Audio Live #
GET /stock/presentation Company Presentation #
GET /stock/social-sentiment Social Sentiment #
GET /stock/investment-theme Investment Themes (Thematic Investing) #
GET /stock/supply-chain Supply Chain Relationships #
GET /stock/esg Company ESG Scores #
GET /stock/historical-esg Historical ESG Scores #
GET /stock/earnings-quality-score Company Earnings Quality Score #
GET /covid19/us COVID-19 #
GET /fda-advisory-committee-calendar FDA Committee Meeting Calendar #
GET /stock/uspto-patent USPTO Patents #
GET /stock/visa-application H1-B Visa Application #
GET /stock/lobbying Senate Lobbying #
GET /stock/usa-spending USA Spending #
GET /stock/congressional-trading Congressional Trading #
GET /bond/profile Bond Profile #
GET /bond/price Bond price data #
GET /bond/tick Bond Tick Data #
GET /bond/yield-curve Bond Yield Curve #
GET /bank-branch Bank Branch List #
GET /airline/price-index Airline Price Index #
GET /country Country Metadata #
GET /calendar/economic Economic Calendar #
GET /economic/code Economic Code #
GET /economic Economic Data #
GET /stock/international-filings International Filings #
GET /stock/revenue-breakdown2 Revenue Breakdown & KPI #
GET /stock/newsroom Newsroom #
POST /ai-chat AI Copilot #
POST /global-filings/search-in-filing Search In Filing #
GET /global-filings/filter Search Filter #
GET /global-filings/download Download Filings #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/finnhub-default-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

finnhub-default-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 1.0.0
  title: Finnhub Default API
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://finnhub.io/api/v1
tags:
- name: Default
paths:
  /search:
    get:
      summary: Symbol Lookup
      description: Search for best-matching symbols based on your query. You can input anything from symbol, security's name to ISIN and Cusip.
      operationId: symbol-search
      navHeader: Symbol Lookup
      urlId: symbol-search
      title: Global Stocks Search
      examples:
      - url: /search?q=apple&exchange=US&token=<token>
        text: /search?q=apple&exchange=US
      - url: /search?q=US5949181045&token=<token>
        text: /search?q=US5949181045
      widget: null
      freeTier: null
      premium: null
      newEndpoint: null
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: q
        description: Query text can be symbol, name, isin, or cusip.
        required: true
        schema:
          type: string
      - in: query
        name: exchange
        description: Exchange limit.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/SymbolLookup'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.symbol_lookup('apple'))
        go: res, _, err := finnhubClient.SymbolSearch(context.Background()).Q("AAPL").Execute()
        javascript: "finnhubClient.symbolSearch('AAPL', (error, data, response) => {\n  console.log(data)\n});"
        ruby: puts(finnhub_client.symbol_search('AAPL'))
        kotlin: println(apiClient.symbolSearch("AAPL"))
        php: print_r($client->symbolSearch("AAPL"));
        useTemplate: true
      sampleResponse: "{\n  \"count\": 4,\n  \"result\": [\n    {\n      \"description\": \"APPLE INC\",\n      \"displaySymbol\": \"AAPL\",\n      \"symbol\": \"AAPL\",\n      \"type\": \"Common Stock\"\n    },\n    {\n      \"description\": \"APPLE INC\",\n      \"displaySymbol\": \"AAPL.SW\",\n      \"symbol\": \"AAPL.SW\",\n      \"type\": \"Common Stock\"\n    },\n    {\n      \"description\": \"APPLE INC\",\n      \"displaySymbol\": \"APC.BE\",\n      \"symbol\": \"APC.BE\",\n      \"type\": \"Common Stock\"\n    },\n    {\n      \"description\": \"APPLE INC\",\n      \"displaySymbol\": \"APC.DE\",\n      \"symbol\": \"APC.DE\",\n      \"type\": \"Common Stock\"\n    }\n  ]\n}"
      security:
      - api_key: []
  /stock/symbol:
    get:
      summary: Stock Symbol
      description: List supported stocks. We use the following symbology to identify stocks on Finnhub <code>Exchange_Ticker.Exchange_Code</code>. A list of supported exchange codes can be found <a href="https://docs.google.com/spreadsheets/d/1I3pBxjfXB056-g_JYf_6o3Rns3BV2kMGG1nCatb91ls/edit?usp=sharing" target="_blank">here</a>.
      operationId: stock-symbols
      navHeader: Stock Symbols
      urlId: stock-symbols
      title: Stock Symbols By Exchange
      examples:
      - url: /stock/symbol?exchange=US&token=<token>
        text: /stock/symbol?exchange=US
      - url: /stock/symbol?exchange=US&mic=XNYS&token=<token>
        text: /stock/symbol?exchange=US&mic=XNYS
      widget: null
      freeTier: null
      premium: null
      newEndpoint: null
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: exchange
        description: Exchange you want to get the list of symbols from. List of exchange codes can be found <a href="https://docs.google.com/spreadsheets/d/1I3pBxjfXB056-g_JYf_6o3Rns3BV2kMGG1nCatb91ls/edit?usp=sharing" target="_blank">here</a>.
        required: true
        schema:
          type: string
      - in: query
        name: mic
        description: Filter by MIC code.
        required: false
        schema:
          type: string
      - in: query
        name: securityType
        description: Filter by security type used by OpenFigi standard.
        required: false
        schema:
          type: string
      - in: query
        name: currency
        description: Filter by currency.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/StockSymbol'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.stock_symbols('US'))
        go: res, _, err := finnhubClient.StockSymbols(context.Background()).Exchange("US").Execute()
        javascript: "finnhubClient.stockSymbols(\"US\", (error, data, response) => {\n  console.log(data)\n});"
        ruby: puts(finnhub_client.stock_symbols('US'))
        kotlin: println(apiClient.stockSymbols("US", "", "", ""))
        php: print_r($client->stockSymbols("US"));
        useTemplate: true
      sampleResponse: "[\n  {\n    \"currency\": \"USD\",\n    \"description\": \"UAN POWER CORP\",\n    \"displaySymbol\": \"UPOW\",\n    \"figi\": \"BBG000BGHYF2\",\n    \"mic\": \"OTCM\",\n    \"symbol\": \"UPOW\",\n    \"type\": \"Common Stock\"\n  },\n  {\n    \"currency\": \"USD\",\n    \"description\": \"APPLE INC\",\n    \"displaySymbol\": \"AAPL\",\n    \"figi\": \"BBG000B9Y5X2\",\n    \"mic\": \"XNGS\",\n    \"symbol\": \"AAPL\",\n    \"type\": \"Common Stock\"\n  },\n  {\n    \"currency\": \"USD\",\n    \"description\": \"EXCO TECHNOLOGIES LTD\",\n    \"displaySymbol\": \"EXCOF\",\n    \"figi\": \"BBG000JHDDS8\",\n    \"mic\": \"OOTC\",\n    \"symbol\": \"EXCOF\",\n    \"type\": \"Common Stock\"\n  }\n]"
      security:
      - api_key: []
  /stock/market-status:
    get:
      summary: Market Status
      description: Get current market status for global exchanges (whether exchanges are open or close).
      operationId: market-status
      navHeader: Market Status
      urlId: market-status
      title: Global Market Status API
      examples:
      - url: /stock/market-status?exchange=US&token=<token>
        text: /stock/market-status?exchange=US
      - url: /stock/market-status?exchange=L&token=<token>
        text: /stock/market-status?exchange=L
      widget: null
      freeTier: null
      premium: null
      newEndpoint: New Endpoint
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: exchange
        description: Exchange code.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/MarketStatus'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.market_status(exchange='US'))
        go: res, _, err := finnhubClient.MarketStatus(context.Background()).Exchange("US").Execute()
        javascript: "finnhubClient.marketStatus({'exchange': 'US'}, (error, data, response) => {\n  console.log(data)\n});"
        ruby: 'puts(finnhub_client.market_status({exchange: ''US''}))'
        kotlin: println(apiClient.marketStatus(exchange = "US"))
        php: print_r($client->marketStatus("US"));
        useTemplate: true
      sampleResponse: "{\n  \"exchange\": \"US\",\n  \"holiday\": null,\n  \"isOpen\": false,\n  \"session\": \"pre-market\",\n  \"timezone\": \"America/New_York\",\n  \"t\": 1697018041\n}"
      security:
      - api_key: []
  /stock/market-holiday:
    get:
      summary: Market Holiday
      description: Get a list of holidays for global exchanges.
      operationId: market-holiday
      navHeader: Market Holiday
      urlId: market-holiday
      title: Global Stock Market Holiday API
      examples:
      - url: /stock/market-holiday?exchange=US&token=<token>
        text: /stock/market-holiday?exchange=US
      - url: /stock/market-holiday?exchange=L&token=<token>
        text: /stock/market-holiday?exchange=L
      widget: null
      freeTier: null
      premium: null
      newEndpoint: New Endpoint
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: exchange
        description: Exchange code.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/MarketHoliday'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.market_holiday(exchange='US'))
        go: res, _, err := finnhubClient.MarketHoliday(context.Background()).Exchange("US").Execute()
        javascript: "finnhubClient.marketHoliday({'exchange': 'US'}, (error, data, response) => {\n  console.log(data)\n});"
        ruby: 'puts(finnhub_client.market_holiday({exchange: ''US''}))'
        kotlin: println(apiClient.marketHoliday(exchange = "US"))
        php: print_r($client->marketHoliday("US"));
        useTemplate: true
      sampleResponse: "{\n  \"data\": [\n    {\n      \"eventName\": \"Christmas\",\n      \"atDate\": \"2023-12-25\",\n      \"tradingHour\": \"\"\n    },\n    {\n      \"eventName\": \"Independence Day\",\n      \"atDate\": \"2023-07-03\",\n      \"tradingHour\": \"09:30-13:00\"\n    }\n  ],\n  \"exchange\": \"US\",\n  \"timezone\": \"America/New_York\"\n}"
      security:
      - api_key: []
  /stock/profile:
    get:
      summary: Company Profile
      description: Get general information of a company. You can query by symbol, ISIN or CUSIP
      operationId: company-profile
      navHeader: Company Profile
      urlId: company-profile
      title: Global Company Profile
      examples:
      - url: /stock/profile?symbol=AAPL&token=<token>
        text: /stock/profile?symbol=AAPL
      - url: /stock/profile?symbol=IBM&token=<token>
        text: /stock/profile?symbol=IBM
      - url: /stock/profile?isin=US5949181045&token=<token>
        text: /stock/profile?isin=US5949181045
      - url: /stock/profile?cusip=023135106&token=<token>
        text: /stock/profile?cusip=023135106
      widget: null
      freeTier: null
      premium: Premium Access Required
      newEndpoint: null
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: symbol
        description: 'Symbol of the company: AAPL e.g.'
        required: false
        schema:
          type: string
      - in: query
        name: isin
        description: ISIN
        required: false
        schema:
          type: string
      - in: query
        name: cusip
        description: CUSIP
        required: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/CompanyProfile'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.company_profile(symbol='AAPL'))
        go: res, _, err := finnhubClient.CompanyProfile(context.Background()).Symbol("AAPL").Execute()
        javascript: "finnhubClient.companyProfile({'symbol': 'AAPL'}, (error, data, response) => {\n  console.log(data)\n});"
        ruby: 'puts(finnhub_client.company_profile({symbol: ''AAPL''}))'
        kotlin: println(apiClient.companyProfile(symbol = "AAPL", isin = null, cusip = null))
        php: print_r($client->companyProfile("AAPL"));
        useTemplate: true
      sampleResponse: "{\n  \"address\": \"1 Apple Park Way\",\n  \"city\": \"CUPERTINO\",\n  \"country\": \"US\",\n  \"currency\": \"USD\",\n  \"cusip\": \"\",\n  \"sedol\":\"2046251\",\n  \"description\": \"Apple Inc. is an American multinational technology company headquartered in Cupertino, California, that designs, develops, and sells consumer electronics, computer software, and online services. It is considered one of the Big Four technology companies, alongside Amazon, Google, and Microsoft. The company's hardware products include the iPhone smartphone, the iPad tablet computer, the Mac personal computer, the iPod portable media player, the Apple Watch smartwatch, the Apple TV digital media player, the AirPods wireless earbuds and the HomePod smart speaker. Apple's software includes the macOS, iOS, iPadOS, watchOS, and tvOS operating systems, the iTunes media player, the Safari web browser, the Shazam acoustic fingerprint utility, and the iLife and iWork creativity and productivity suites, as well as professional applications like Final Cut Pro, Logic Pro, and Xcode. Its online services include the iTunes Store, the iOS App Store, Mac App Store, Apple Music, Apple TV+, iMessage, and iCloud. Other services include Apple Store, Genius Bar, AppleCare, Apple Pay, Apple Pay Cash, and Apple Card.\",\n  \"employeeTotal\": \"137000\",\n  \"exchange\": \"NASDAQ/NMS (GLOBAL MARKET)\",\n  \"ggroup\": \"Technology Hardware & Equipment\",\n  \"gind\": \"Technology Hardware, Storage & Peripherals\",\n  \"gsector\": \"Information Technology\",\n  \"gsubind\": \"Technology Hardware, Storage & Peripherals\",\n  \"ipo\": \"1980-12-12\",\n  \"isin\": \"\",\n  \"marketCapitalization\": 1415993,\n  \"naics\": \"Communications Equipment Manufacturing\",\n  \"naicsNationalIndustry\": \"Radio and Television Broadcasting and Wireless Communications Equipment Manufacturing\",\n  \"naicsSector\": \"Manufacturing\",\n  \"naicsSubsector\": \"Computer and Electronic Product Manufacturing\",\n  \"name\": \"Apple Inc\",\n  \"phone\": \"14089961010\",\n  \"shareOutstanding\": 4375.47998046875,\n  \"state\": \"CALIFORNIA\",\n  \"ticker\": \"AAPL\",\n  \"weburl\": \"https://www.apple.com/\",\n  \"logo\": \"https://static.finnhub.io/logo/87cb30d8-80df-11ea-8951-00000000092a.png\",\n  \"finnhubIndustry\":\"Technology\"\n}"
      security:
      - api_key: []
  /stock/profile2:
    get:
      summary: Company Profile 2
      description: Get general information of a company. You can query by symbol, ISIN or CUSIP. This is the free version of <a href="#company-profile">Company Profile</a>.
      operationId: company-profile2
      navHeader: Company Profile 2
      urlId: company-profile2
      title: Global Company Profile 2
      examples:
      - url: /stock/profile2?symbol=AAPL&token=<token>
        text: /stock/profile2?symbol=AAPL
      - url: /stock/profile2?isin=US5949181045&token=<token>
        text: /stock/profile2?isin=US5949181045
      - url: /stock/profile2?cusip=023135106&token=<token>
        text: /stock/profile2?cusip=023135106
      widget: null
      freeTier: null
      premium: null
      newEndpoint: New Endpoint
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: symbol
        description: 'Symbol of the company: AAPL e.g.'
        required: false
        schema:
          type: string
      - in: query
        name: isin
        description: ISIN
        required: false
        schema:
          type: string
      - in: query
        name: cusip
        description: CUSIP
        required: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/CompanyProfile2'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.company_profile2(symbol='AAPL'))
        go: res, _, err := finnhubClient.CompanyProfile2(context.Background()).Symbol("AAPL").Execute()
        javascript: "finnhubClient.companyProfile2({'symbol': 'AAPL'}, (error, data, response) => {\n  console.log(data)\n});"
        ruby: 'puts(finnhub_client.company_profile2({symbol: ''AAPL''}))'
        kotlin: println(apiClient.companyProfile2(symbol = "AAPL", isin = null, cusip = null))
        php: print_r($client->companyProfile2("AAPL"));
        useTemplate: true
      sampleResponse: "{\n  \"country\": \"US\",\n  \"currency\": \"USD\",\n  \"exchange\": \"NASDAQ/NMS (GLOBAL MARKET)\",\n  \"ipo\": \"1980-12-12\",\n  \"marketCapitalization\": 1415993,\n  \"name\": \"Apple Inc\",\n  \"phone\": \"14089961010\",\n  \"shareOutstanding\": 4375.47998046875,\n  \"ticker\": \"AAPL\",\n  \"weburl\": \"https://www.apple.com/\",\n  \"logo\": \"https://static.finnhub.io/logo/87cb30d8-80df-11ea-8951-00000000092a.png\",\n  \"finnhubIndustry\":\"Technology\"\n}"
      security:
      - api_key: []
  /stock/executive:
    get:
      summary: Company Executive
      description: Get a list of company's executives and members of the Board.
      operationId: company-executive
      navHeader: Company Executive
      urlId: company-executive
      title: Global Company Executives & Compensation
      examples:
      - url: /stock/executive?symbol=AAPL&token=<token>
        text: /stock/executive?symbol=AAPL
      - url: /stock/executive?symbol=AMZN&token=<token>
        text: /stock/executive?symbol=AMZN
      widget: null
      freeTier: null
      premium: Premium Access Required
      newEndpoint: null
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: symbol
        description: 'Symbol of the company: AAPL.'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/CompanyExecutive'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.company_executive('AAPL'))
        go: res, _, err := finnhubClient.CompanyExecutive(context.Background()).Symbol("AAPL").Execute()
        javascript: "finnhubClient.companyExecutive('AAPL', (error, data, response) => {\n  console.log(data)\n});"
        ruby: puts(finnhub_client.company_executive('AAPL'))
        kotlin: println(apiClient.companyExecutive("AAPL"))
        php: print_r($client->companyExecutive("AAPL"));
        useTemplate: true
      sampleResponse: "{\n  \"executive\": [\n    {\n      \"age\": 56,\n      \"compensation\": 25209637,\n      \"currency\": \"USD\",\n      \"name\": \"Luca Maestri\",\n      \"position\": \"Senior Vice President and Chief Financial Officer\",\n      \"sex\": \"male\",\n      \"since\": \"2014\"\n    },\n    {\n      \"age\": 59,\n      \"compensation\": 11555466,\n      \"currency\": \"USD\",\n      \"name\": \"Mr. Timothy Cook\",\n      \"position\": \"Director and Chief Executive Officer\",\n      \"sex\": \"male\",\n      \"since\": \"2011\"\n    }\n  ]\n}"
      security:
      - api_key: []
  /news:
    get:
      summary: Market News
      description: Get latest market news.
      operationId: market-news
      navHeader: Market News
      urlId: market-news
      title: Real-time Market News API
      examples:
      - url: /news?category=general&token=<token>
        text: /news?category=general
      - url: /news?category=forex&minId=10&token=<token>
        text: /news?category=forex&minId=10
      widget: null
      freeTier: null
      premium: null
      newEndpoint: null
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: category
        description: This parameter can be 1 of the following values <code>general, forex, crypto, merger</code>.
        required: true
        schema:
          type: string
      - in: query
        name: minId
        description: Use this field to get only news after this ID. Default to 0
        required: false
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MarketNews'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.general_news('general', min_id=0))
        go: res, _, err := finnhubClient.MarketNews(context.Background()).Category("general").Execute()
        javascript: "finnhubClient.marketNews(\"general\", {}, (error, data, response) => {\n  console.log(data)\n});"
        ruby: 'puts(finnhub_client.market_news(''general'', {min_id: 0}))'
        kotlin: println(apiClient.marketNews("general", minId = 0))
        php: print_r($client->marketNews("forex", 0));
        useTemplate: true
      sampleResponse: "[\n  {\n    \"category\": \"technology\",\n    \"datetime\": 1596589501,\n    \"headline\": \"Square surges after reporting 64% jump in revenue, more customers using Cash App\",\n    \"id\": 5085164,\n    \"image\": \"https://image.cnbcfm.com/api/v1/image/105569283-1542050972462rts25mct.jpg?v=1542051069\",\n    \"related\": \"\",\n    \"source\": \"CNBC\",\n    \"summary\": \"Shares of Square soared on Tuesday evening after posting better-than-expected quarterly results and strong growth in its consumer payments app.\",\n    \"url\": \"https://www.cnbc.com/2020/08/04/square-sq-earnings-q2-2020.html\"\n  },\n  {\n    \"category\": \"business\",\n    \"datetime\": 1596588232,\n    \"headline\": \"B&G Foods CEO expects pantry demand to hold up post-pandemic\",\n    \"id\": 5085113,\n    \"image\": \"https://image.cnbcfm.com/api/v1/image/106629991-1595532157669-gettyimages-1221952946-362857076_1-5.jpeg?v=1595532242\",\n    \"related\": \"\",\n    \"source\": \"CNBC\",\n    \"summary\": \"\\\"I think post-Covid, people will be working more at home, which means people will be eating more breakfast\\\" and other meals at home, B&G CEO Ken Romanzi said.\",\n    \"url\": \"https://www.cnbc.com/2020/08/04/bg-foods-ceo-expects-pantry-demand-to-hold-up-post-pandemic.html\"\n  },\n  {\n    \"category\": \"top news\",\n    \"datetime\": 1596584406,\n    \"headline\": \"Anthony Levandowski gets 18 months in prison for stealing Google self-driving car files\",\n    \"id\": 5084850,\n    \"image\": \"https://image.cnbcfm.com/api/v1/image/106648265-1596584130509-UBER-LEVANDOWSKI.JPG?v=1596584247\",\n    \"related\": \"\",\n    \"source\": \"CNBC\",\n    \"summary\": \"A U.S. judge on Tuesday sentenced former Google engineer Anthony Levandowski to 18 months in prison for stealing a trade secret from Google related to self-driving cars months before becoming the head of Uber Technologies Inc's rival unit.\",\n    \"url\": \"https://www.cnbc.com/2020/08/04/anthony-levandowski-gets-18-months-in-prison-for-stealing-google-self-driving-car-files.html\"\n  }\n  }]"
      security:
      - api_key: []
  /company-news:
    get:
      summary: Company News
      description: List latest company news by symbol. This endpoint is only available for North American companies.
      operationId: company-news
      navHeader: Company News
      urlId: company-news
      title: Real-time Global Company News API
      examples:
      - url: /company-news?symbol=AAPL&from=2025-05-15&to=2025-06-20&token=<token>
        text: /company-news?symbol=AAPL&from=2025-05-15&to=2025-06-20
      widget: null
      freeTier: 1 year of historical news and new updates
      premium: null
      newEndpoint: null
      highUsage: High Usage
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: symbol
        description: Company symbol.
        required: true
        schema:
          type: string
      - in: query
        name: from
        description: From date <code>YYYY-MM-DD</code>.
        required: true
        schema:
          type: string
          format: date
      - in: query
        name: to
        description: To date <code>YYYY-MM-DD</code>.
        required: true
        schema:
          type: string
          format: date
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyNews'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.company_news('AAPL', _from="2020-06-01", to="2020-06-10"))
        go: res, _, err := finnhubClient.CompanyNews(context.Background()).Symbol("AAPL").From("2020-05-01").To("2020-05-01").Execute()
        javascript: "finnhubClient.companyNews(\"AAPL\", \"2020-01-01\", \"2020-05-01\", (error, data, response) => {\n\tconsole.log(data)\n});"
        ruby: puts(finnhub_client.company_news('AAPL', "2020-06-01", "2020-06-10"))
        kotlin: println(apiClient.companyNews("AAPL", from = "2020-06-01", to = "2020-06-10"))
        php: print_r($client->companyNews("AAPL", "2020-06-01", "2020-06-10"));
        useTemplate: true
      sampleResponse: "[\n  {\n    \"category\": \"company news\",\n    \"datetime\": 1569550360,\n    \"headline\": \"More sops needed to boost electronic manufacturing: Top govt official More sops needed to boost electronic manufacturing: Top govt official.  More sops needed to boost electronic manufacturing: Top govt official More sops needed to boost electronic manufacturing: Top govt official\",\n    \"id\": 25286,\n    \"image\": \"https://img.etimg.com/thumb/msid-71321314,width-1070,height-580,imgsize-481831,overlay-economictimes/photo.jpg\",\n    \"related\": \"AAPL\",\n    \"source\": \"The Economic Times India\",\n    \"summary\": \"NEW DELHI | CHENNAI: India may have to offer electronic manufacturers additional sops such as cheap credit and incentives for export along with infrastructure support in order to boost production and help the sector compete with China, Vietnam and Thailand, according to a top government official.These incentives, over and above the proposed reduction of corporate tax to 15% for new manufacturing units, are vital for India to successfully attract companies looking to relocate manufacturing facilities.“While the tax announcements made last week send a very good signal, in order to help attract investments, we will need additional initiatives,” the official told ET, pointing out that Indian electronic manufacturers incur 8-10% higher costs compared with other Asian countries.Sops that are similar to the incentives for export under the existing Merchandise Exports from India Scheme (MEIS) are what the industry requires, the person said.MEIS gives tax credit in the range of 2-5%. An interest subvention scheme for cheaper loans and a credit guarantee scheme for plant and machinery are some other possible measures that will help the industry, the official added.“This should be 2.0 (second) version of the electronic manufacturing cluster (EMC) scheme, which is aimed at creating an ecosystem with an anchor company plus its suppliers to operate in the same area,” he said.Last week, finance minister Nirmala Sitharaman announced a series of measures to boost economic growth including a scheme allowing any new manufacturing company incorporated on or after October 1, to pay income tax at 15% provided the company does not avail of any other exemption or incentives.\",\n    \"url\": \"https://economictimes.indiatimes.com/industry/cons-products/electronics/more-sops-needed-to-boost-electronic-manufacturing-top-govt-official/articleshow/71321308.cms\"\n  },\n  {\n    \"category\": \"company news\",\n    \"datetime\": 1569528720,\n    \"headline\": \"How to disable comments on your YouTube videos in 2 different ways\",\n    \"id\": 25287,\n    \"image\": \"https://amp.businessinsider.com/images/5d8d16182e22af6ab66c09e9-1536-768.jpg\",\n    \"related\": \"AAPL\",\n    \"source\": \"Business Insider\",\n    \"summary\": \"You can disable comments on your own YouTube video if you don't want people to comment on it. It's easy to disable comments on YouTube by adjusting the settings for one of your videos in the beta or classic version of YouTube Studio. Visit Business Insider's homepage for more stories . The comments section has a somewhat complicated reputation for creators, especially for those making videos on YouTube . While it can be useful to get the unfiltered opinions of your YouTube viewers and possibly forge a closer connection with them, it can also open you up to quite a bit of negativity. So it makes sense that there may be times when you want to turn off the feature entirely. Just keep in mind that the action itself can spark conversation. If you decide that you don't want to let people leave comments on your YouTube video, here's how to turn off the feature, using either the classic or beta version of the creator studio: How to disable comments on YouTube in YouTube Studio (beta) 1. Go to youtube.com and log into your account, if necessary. 2.\",\n    \"url\": \"https://www.businessinsider.com/how-to-disable-comments-on-youtube\"\n  },\n  {\n    \"category\": \"company news\",\n    \"datetime\": 1569526180,\n    \"headline\": \"Apple iPhone 11 Pro Teardowns Look Encouraging for STMicro and Sony\",\n    \"id\": 25341,\n    \"image\": \"http://s.thestreet.com/files/tsc/v2008/photos/contrib/uploads/ba140938-d409-11e9-822b-fda891ce1fc1.png\",\n    \"related\": \"AAPL\",\n    \"source\": \"TheStreet\",\n    \"summary\": \"STMicroelectronics and Sony each appear to be supplying four chips for Apple's latest flagship iPhones. Many other historical iPhone suppliers also make appearances in the latest teardowns….STM\",\n    \"url\": \"https://realmoney.thestreet.com/investing/technology/iphone-11-pro-teardowns-look-encouraging-for-stmicro-sony-15105767\"\n  },\n]"
      security:
      - api_key: []
  /press-releases:
    get:
      summary: Major Press Releases
      description: <p>Get latest major press releases of a company. This data can be used to highlight the most significant events comprised of mostly press releases sourced from the exchanges, BusinessWire, AccessWire, GlobeNewswire, Newsfile, and PRNewswire.</p><p>Full-text press releases data is available for Enterprise clients. <a href="mailto:support@finnhub.io">Contact Us</a> to learn more.</p>
      operationId: press-releases
      navHeader: Press Releases
      urlId: press-releases
      title: Real-time Press Releases API
      examples:
      - url: /press-releases?symbol=AAPL&token=<token>
        text: /press-releases?symbol=AAPL
      - url: /press-releases?symbol=IBM&from=2019-11-01&to=2020-02-15&token=<token>
        text: /press-releases?symbol=IBM&from=2019-11-01&to=2020-02-15
      widget: null
      freeTier: null
      premium: Premium Access Required
      newEndpoint: null
      highUsage: null
      tags:
      - Default
      section: Stock Fundamentals
      parameters:
      - in: query
        name: symbol
        description: Company symbol.
        required: true
        schema:
          type: string
      - in: query
        name: from
        description: 'From time: 2020-01-01.'
        required: false
        schema:
          type: string
          format: date
      - in: query
        name: to
        description: 'To time: 2020-01-05.'
        required: false
        schema:
          type: string
          format: date
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/PressRelease'
      sampleCode:
        curl: autoGenerated
        python: print(finnhub_client.press_releases('AAPL'))
        go: res, _, err := finnhubClient.PressReleases(context.Background()).Symbol("AAPL").Execute()
        javascript: "finnhubClient.pressReleases(\"AAPL\", {}, (error, data, response) => {\n  console.log(data)\n});"
        ruby: 'puts(finnhub_client.press_releases(''AAPL'', {from: "2020-01-01", to: "2020-12-31"}))

          '
        kotlin: println(apiClient.pressReleases("AAPL", from = "2020-01-01", to = "2020-12-31"))
        php: print_r($client->pressReleases("AAPL", "2020-01-01", "2020-12-31"));
        useTemplate: true
      sampleResponse: "{\n  \"majorDevelopment\": [\n    {\n      \"s

# --- truncated at 32 KB (450 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/openapi/finnhub-default-api-openapi.yml