Docs
Open Lodol
DocumentationIntegrationsAPI

Finnhub

App · Accounting & Finance · 15 actions

Get stock market data from Finnhub: a stock's latest price, a company's profile, key metrics and peers, analyst recommendations, earnings results and the earnings and IPO calendars, company and market news, insider transactions, SEC filings, and whether a market is open or closed for a holiday. Needs a free Finnhub API key.

Actions

ActionWhat it does
Get analyst recommendationsGet how many analysts rate a stock a strong buy, buy, hold, sell or strong sell, month by month, newest first.
Get company newsGet news articles about a North American company, newest first, with each headline, summary, source and link.
Get company peersGet the stock symbols of companies similar to one company: in the same country and the same sub-industry, industry or sector.
Get company profileGet a company's name, industry, exchange, country, currency, IPO date, market cap, shares outstanding, website, logo and phone number.
Get earnings calendarGet the companies reporting earnings between two dates, with the time of day and the expected and reported EPS and revenue, for every company or just one.
Get earnings surprisesGet a company's reported earnings per share for each recent quarter against what analysts expected, and whether it beat the estimate.
Get insider transactionsGet the shares a company's executives and directors bought, sold, were granted or exercised, newest first, from their SEC Form 3, 4 and 5 filings: up to 100 at a time.
Get IPO calendarGet the IPOs between two dates, with each company's exchange, status, price range and shares offered.
Get key metricsGet a company's key financial metrics: market cap, P/E ratio, EPS, dividend yield, beta, 52-week high and low, revenue and EPS growth, margins, return on equity and debt to equity, plus every other metric Finnhub has for it.
Get market holidaysGet the days a stock exchange is closed or closes early, in date order, and the next one from today.
Get market newsGet the latest market news, newest first: general, currencies, crypto, or mergers and acquisitions.
Get market statusFind out whether a stock exchange is open right now, which session it is in (pre-market, regular or post-market), and whether it is closed for a holiday.
Get SEC filingsGet a company's SEC filings, newest first, optionally only one form such as 10-K annual reports or 8-K event reports, with links to read each one: up to 250 at a time.
Get stock quoteGet a US stock's latest price, with how much it moved since the previous close, and the day's open, high and low.
Search symbolsFind a company's stock symbol from its name, ISIN or CUSIP, best match first, optionally on one exchange.

Get analyst recommendations

Get how many analysts rate a stock a strong buy, buy, hold, sell or strong sell, month by month, newest first.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.

Outputs

latestobject
The most recent month
month_countnumber
How many months there are
monthslist
Every month Finnhub has, newest first
symboltext
The stock symbol, e.g. AAPL
Example output
{
  "latest": {
    "analyst_count": 55,
    "buy": 24,
    "hold": 16,
    "period": "2026-09-01",
    "sell": 2,
    "strong_buy": 13,
    "strong_sell": 0
  },
  "month_count": 3,
  "months": [
    {
      "analyst_count": 55,
      "buy": 24,
      "hold": 16,
      "period": "2026-09-01",
      "sell": 2,
      "strong_buy": 13,
      "strong_sell": 0
    },
    {
      "analyst_count": 54,
      "buy": 24,
      "hold": 15,
      "period": "2026-08-01",
      "sell": 2,
      "strong_buy": 13,
      "strong_sell": 0
    },
    {
      "analyst_count": 54,
      "buy": 23,
      "hold": 16,
      "period": "2026-07-01",
      "sell": 2,
      "strong_buy": 12,
      "strong_sell": 1
    }
  ],
  "symbol": "AAPL"
}

Get company news

Get news articles about a North American company, newest first, with each headline, summary, source and link. Covers the last 7 days unless you set dates.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.
Start datestart_datedate
The earliest day to include. Leave blank for 7 days before the end date. The free plan goes back a year.
End dateend_datedate
The last day to include. Leave blank for today.
Maximum articleslimitnumber
The most articles to return, newest first. Leave blank for all of them.At least 1.

Outputs

article_countnumber
How many articles there are
articleslist
The articles, newest first
end_datetext
The last day covered, YYYY-MM-DD
start_datetext
The first day covered, YYYY-MM-DD
symboltext
The stock symbol, e.g. AAPL
Example output
{
  "article_count": 3,
  "articles": [
    {
      "category": "company",
      "headline": "What to watch in Apple's next quarter",
      "id": 136890417,
      "image_url": null,
      "published_at": "2026-09-26T09:30:00Z",
      "related_symbols": [
        "AAPL",
        "MSFT"
      ],
      "source": "MarketWatch",
      "summary": "Analysts weigh iPhone demand against services growth.",
      "url": "https://finnhub.io/api/news?id=d4e5f6"
    },
    {
      "category": "company",
      "headline": "Apple expands its self service repair program",
      "id": 136872001,
      "image_url": "https://static2.finnhub.io/file/publicdatany/finnhubimage/stock_logo/AAPL.png",
      "published_at": "2026-09-25T14:05:00Z",
      "related_symbols": [
        "AAPL"
      ],
      "source": "Yahoo",
      "summary": "Apple is adding more devices and countries to its self service repair program.",
      "url": "https://finnhub.io/api/news?id=a1b2c3"
    },
    {
      "category": "company",
      "headline": "Apple supplier ramps up production",
      "id": 136791552,
      "image_url": "https://image.example.com/supplier.jpg",
      "published_at": "2026-09-22T18:45:00Z",
      "related_symbols": [
        "AAPL"
      ],
      "source": "Reuters",
      "summary": "A key supplier is increasing output ahead of the holidays.",
      "url": "https://finnhub.io/api/news?id=g7h8i9"
    }
  ],
  "end_date": "2026-09-27",
  "start_date": "2026-09-20",
  "symbol": "AAPL"
}

Get company peers

Get the stock symbols of companies similar to one company: in the same country and the same sub-industry, industry or sector.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.
Compare bygroupingtext
How alike the peers must be. Peers are always in the same country as the company.One of: subIndustry (Same sub-industry (closest peers)), industry (Same industry), sector (Same sector (broadest)). Default: subIndustry.

Outputs

peer_countnumber
How many peers there are
peerslist
The peers' stock symbols, most similar first
symboltext
The stock symbol, e.g. AAPL
Example output
{
  "peer_count": 9,
  "peers": [
    "DELL",
    "SMCI",
    "HPQ",
    "HPE",
    "NTAP",
    "PSTG",
    "WDC",
    "STX",
    "IONQ"
  ],
  "symbol": "AAPL"
}

Get company profile

Get a company's name, industry, exchange, country, currency, IPO date, market cap, shares outstanding, website, logo and phone number.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.

Outputs

countrytext
The two-letter code of the country of its headquarters
currencytext
The currency its figures are in, e.g. USD
exchangetext
The exchange it is listed on
industrytext
Finnhub's industry for the company, e.g. Technology
ipo_datetext
When it went public, YYYY-MM-DD
logo_urltext
A link to its logo
market_capnumber
Its market capitalization, in its currency
nametext
The company's name
phonetext
Its phone number
shares_outstandingnumber
How many shares it has outstanding
symboltext
The stock symbol, e.g. AAPL
websitetext
Its website
Example output
{
  "country": "US",
  "currency": "USD",
  "exchange": "NASDAQ NMS - GLOBAL MARKET",
  "industry": "Technology",
  "ipo_date": "1980-12-12",
  "logo_url": "https://static2.finnhub.io/file/publicdatany/finnhubimage/stock_logo/AAPL.png",
  "market_cap": 3890123460000,
  "name": "Apple Inc",
  "phone": "14089961010",
  "shares_outstanding": 14840390000,
  "symbol": "AAPL",
  "website": "https://www.apple.com/"
}

Get earnings calendar

Get the companies reporting earnings between two dates, with the time of day and the expected and reported EPS and revenue, for every company or just one. Covers the next 7 days unless you set dates.

Inputs

Start datestart_datedate
The first day to include. Leave blank for today. The free plan goes back a month.
End dateend_datedate
The last day to include. Leave blank for 7 days after the start date.
Stock symbolsymboltext
Only this company's earnings, such as AAPL for Apple. Leave blank for every company.

Outputs

end_datetext
The last day covered, YYYY-MM-DD
release_countnumber
How many releases there are
releaseslist
The earnings releases, in date order
start_datetext
The first day covered, YYYY-MM-DD
Example output
{
  "end_date": "2026-10-04",
  "release_count": 3,
  "releases": [
    {
      "date": "2026-09-29",
      "eps_actual": null,
      "eps_estimate": 0.3312,
      "quarter": 4,
      "revenue_actual": null,
      "revenue_estimate": 7981000000,
      "symbol": "CCL",
      "time_of_day": "Before market open",
      "year": 2026
    },
    {
      "date": "2026-09-30",
      "eps_actual": null,
      "eps_estimate": 0.2715,
      "quarter": 1,
      "revenue_actual": null,
      "revenue_estimate": 11215000000,
      "symbol": "NKE",
      "time_of_day": "After market close",
      "year": 2027
    },
    {
      "date": "2026-10-01",
      "eps_actual": null,
      "eps_estimate": null,
      "quarter": 3,
      "revenue_actual": null,
      "revenue_estimate": null,
      "symbol": "ABCX",
      "time_of_day": null,
      "year": 2026
    }
  ],
  "start_date": "2026-09-27"
}

Get earnings surprises

Get a company's reported earnings per share for each recent quarter against what analysts expected, and whether it beat the estimate. The free plan covers the last 4 quarters.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.

Outputs

quarter_countnumber
How many quarters there are
quarterslist
The reported quarters, newest first
symboltext
The stock symbol, e.g. AAPL
Example output
{
  "quarter_count": 4,
  "quarters": [
    {
      "actual_eps": 1.57,
      "beat_estimate": true,
      "estimated_eps": 1.4425,
      "period": "2026-06-30",
      "quarter": 3,
      "surprise": 0.1275,
      "surprise_percent": 8.8388,
      "year": 2026
    },
    {
      "actual_eps": 1.65,
      "beat_estimate": true,
      "estimated_eps": 1.6295,
      "period": "2026-03-31",
      "quarter": 2,
      "surprise": 0.0205,
      "surprise_percent": 1.2581,
      "year": 2026
    },
    {
      "actual_eps": 2.4,
      "beat_estimate": true,
      "estimated_eps": 2.3525,
      "period": "2025-12-31",
      "quarter": 1,
      "surprise": 0.0475,
      "surprise_percent": 2.0191,
      "year": 2026
    },
    {
      "actual_eps": 1.64,
      "beat_estimate": false,
      "estimated_eps": 1.6454,
      "period": "2025-09-30",
      "quarter": 4,
      "surprise": -0.0054,
      "surprise_percent": -0.3282,
      "year": 2025
    }
  ],
  "symbol": "AAPL"
}

Get insider transactions

Get the shares a company's executives and directors bought, sold, were granted or exercised, newest first, from their SEC Form 3, 4 and 5 filings: up to 100 at a time.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.
Start datestart_datedate
Only transactions on or after this day. Leave blank for the latest ones.
End dateend_datedate
Only transactions on or before this day.

Outputs

symboltext
The stock symbol, e.g. AAPL
transaction_countnumber
How many transactions there are
transactionslist
The transactions, newest first
Example output
{
  "symbol": "AAPL",
  "transaction_count": 3,
  "transactions": [
    {
      "filing_date": "2026-09-18",
      "name": "COOK TIMOTHY D",
      "price": 238.45,
      "shares_changed": -38821,
      "shares_held_after": 3280180,
      "transaction_code": "S",
      "transaction_date": "2026-09-16",
      "transaction_type": "Sold on the open market"
    },
    {
      "filing_date": "2026-09-03",
      "name": "ADAMS KATHERINE L",
      "price": 0,
      "shares_changed": 16457,
      "shares_held_after": 81306,
      "transaction_code": "M",
      "transaction_date": "2026-09-01",
      "transaction_type": "Option exercise"
    },
    {
      "filing_date": "2026-09-03",
      "name": "ADAMS KATHERINE L",
      "price": 255.46,
      "shares_changed": -8617,
      "shares_held_after": 72689,
      "transaction_code": "F",
      "transaction_date": "2026-09-01",
      "transaction_type": "Shares withheld for tax or exercise price"
    }
  ]
}

Get IPO calendar

Get the IPOs between two dates, with each company's exchange, status, price range and shares offered. Covers the next 30 days unless you set dates.

Inputs

Start datestart_datedate
The first day to include. Leave blank for today.
End dateend_datedate
The last day to include. Leave blank for 30 days after the start date.

Outputs

end_datetext
The last day covered, YYYY-MM-DD
ipo_countnumber
How many IPOs there are
iposlist
The IPOs, in date order
start_datetext
The first day covered, YYYY-MM-DD
Example output
{
  "end_date": "2026-10-27",
  "ipo_count": 3,
  "ipos": [
    {
      "date": "2026-09-30",
      "exchange": "NYSE",
      "name": "ALPINE FOODS CORP",
      "price_high": 21.0,
      "price_low": 21.0,
      "price_range": "21.00",
      "shares_offered": 12000000,
      "status": "priced",
      "symbol": "ALPF",
      "total_value": 252000000
    },
    {
      "date": "2026-10-08",
      "exchange": "NASDAQ Global",
      "name": "NORTHWIND ROBOTICS INC",
      "price_high": 18.0,
      "price_low": 16.0,
      "price_range": "16.00-18.00",
      "shares_offered": 7650000,
      "status": "expected",
      "symbol": "NWRB",
      "total_value": 158355000
    },
    {
      "date": "2026-10-20",
      "exchange": null,
      "name": "HARBOR BIOSCIENCES INC",
      "price_high": null,
      "price_low": null,
      "price_range": null,
      "shares_offered": null,
      "status": "filed",
      "symbol": null,
      "total_value": null
    }
  ],
  "start_date": "2026-09-27"
}

Get key metrics

Get a company's key financial metrics: market cap, P/E ratio, EPS, dividend yield, beta, 52-week high and low, revenue and EPS growth, margins, return on equity and debt to equity, plus every other metric Finnhub has for it.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.

Outputs

all_metricsobject
Every metric Finnhub has for the company, under Finnhub's own names, with market cap, enterprise value and volumes in millions
average_volume_10_daynumber
Average shares traded a day, over 10 days
average_volume_3_monthnumber
Average shares traded a day, over 3 months
betanumber
Beta: how much the price moves with the market
current_rationumber
Current assets divided by current liabilities
debt_to_equitynumber
Total debt divided by total equity
dividend_per_sharenumber
Dividends paid per share, over the last 12 months
dividend_yield_percentnumber
Dividend yield, as a percentage
enterprise_valuenumber
Enterprise value, in the company's currency
epsnumber
Earnings per share, over the last 12 months
eps_growth_percentnumber
EPS growth over the last 12 months, year on year, as a percentage
gross_margin_percentnumber
Gross margin, as a percentage
market_capnumber
Market capitalization, in the company's currency
net_margin_percentnumber
Net profit margin, as a percentage
operating_margin_percentnumber
Operating margin, as a percentage
pe_rationumber
Price to earnings ratio, over the last 12 months
price_to_booknumber
Price to book ratio
price_to_salesnumber
Price to sales ratio, over the last 12 months
return_on_equity_percentnumber
Return on equity, as a percentage
revenue_growth_percentnumber
Revenue growth over the last 12 months, year on year, as a percentage
symboltext
The stock symbol, e.g. AAPL
week_52_highnumber
The highest price in the last 52 weeks
week_52_high_datetext
When it reached that high, YYYY-MM-DD
week_52_lownumber
The lowest price in the last 52 weeks
week_52_low_datetext
When it reached that low, YYYY-MM-DD
week_52_return_percentnumber
Price change over 52 weeks, as a percentage
year_to_date_return_percentnumber
Price change since the start of the year, as a percentage
Example output
{
  "all_metrics": {
    "10DayAverageTradingVolume": 48.21507,
    "13WeekPriceReturnDaily": 14.2175,
    "26WeekPriceReturnDaily": 21.0385,
    "3MonthAverageTradingVolume": 52.37811,
    "52WeekHigh": 264.1,
    "52WeekHighDate": "2026-09-19",
    "52WeekLow": 169.21,
    "52WeekLowDate": "2026-04-08",
    "52WeekPriceReturnDaily": 12.3571,
    "5DayPriceReturnDaily": 1.2034,
    "beta": 1.1062,
    "bookValuePerShareAnnual": 4.3882,
    "currentDividendYieldTTM": 0.3972,
    "currentRatioAnnual": 0.8673,
    "currentRatioQuarterly": 0.8684,
    "dividendPerShareAnnual": 1.0,
    "dividendPerShareTTM": 1.03,
    "dividendYieldIndicatedAnnual": 0.4034,
    "enterpriseValue": 3921344.98,
    "epsAnnual": 6.1128,
    "epsGrowthTTMYoy": 12.0987,
    "epsTTM": 7.3942,
    "grossMarginAnnual": 46.21,
    "grossMarginTTM": 46.68,
    "marketCapitalization": 3890123.46,
    "netProfitMarginAnnual": 23.97,
    "netProfitMarginTTM": 24.3,
    "operatingMarginAnnual": 31.51,
    "operatingMarginTTM": 31.87,
    "pb": 58.1293,
    "peTTM": 35.3988,
    "psTTM": 9.3102,
    "revenueGrowthTTMYoy": 5.9832,
    "roeTTM": 154.92,
    "totalDebt/totalEquityAnnual": 1.8714,
    "totalDebt/totalEquityQuarterly": 1.5436,
    "yearToDatePriceReturnDaily": 4.5237
  },
  "average_volume_10_day": 48215070,
  "average_volume_3_month": 52378110,
  "beta": 1.1062,
  "current_ratio": 0.8684,
  "debt_to_equity": 1.5436,
  "dividend_per_share": 1.03,
  "dividend_yield_percent": 0.3972,
  "enterprise_value": 3921344980000,
  "eps": 7.3942,
  "eps_growth_percent": 12.0987,
  "gross_margin_percent": 46.68,
  "market_cap": 3890123460000,
  "net_margin_percent": 24.3,
  "operating_margin_percent": 31.87,
  "pe_ratio": 35.3988,
  "price_to_book": 58.1293,
  "price_to_sales": 9.3102,
  "return_on_equity_percent": 154.92,
  "revenue_growth_percent": 5.9832,
  "symbol": "AAPL",
  "week_52_high": 264.1,
  "week_52_high_date": "2026-09-19",
  "week_52_low": 169.21,
  "week_52_low_date": "2026-04-08",
  "week_52_return_percent": 12.3571,
  "year_to_date_return_percent": 4.5237
}

Get market holidays

Get the days a stock exchange is closed or closes early, in date order, and the next one from today.

Inputs

Exchangeexchangetext
The stock exchange to check.One of: BA (Argentina: Bolsa de Comercio de Buenos Aires), AX (Australia: ASX), VI (Austria: Vienna Stock Exchange), BH (Bahrain: Bahrain Bourse), BR (Belgium: Euronext Brussels), SA (Brazil: B3 (Sao Paulo)), CN (Canada: Canadian Securities Exchange), NE (Canada: NEO Exchange), TO (Canada: Toronto Stock Exchange), V (Canada: TSX Venture Exchange), and 67 more. Default: US.

Outputs

exchangetext
The exchange's code, e.g. US
exchange_nametext
The exchange's name
holiday_countnumber
How many holidays there are
holidayslist
The holidays, in date order
next_holidayobject
The next holiday from today
timezonetext
The exchange's time zone, e.g. America/New_York
Example output
{
  "exchange": "US",
  "exchange_name": "NYSE, Nasdaq and other US exchanges",
  "holiday_count": 12,
  "holidays": [
    {
      "closed_all_day": true,
      "date": "2026-01-01",
      "name": "New Year's Day",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-01-19",
      "name": "Martin Luther King, Jr. Day",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-02-16",
      "name": "Washington's Birthday",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-04-03",
      "name": "Good Friday",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-05-25",
      "name": "Memorial Day",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-06-19",
      "name": "Juneteenth National Independence Day",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-07-03",
      "name": "Independence Day",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-09-07",
      "name": "Labor Day",
      "trading_hours": null
    },
    {
      "closed_all_day": true,
      "date": "2026-11-26",
      "name": "Thanksgiving Day",
      "trading_hours": null
    },
    {
      "closed_all_day": false,
      "date": "2026-11-27",
      "name": "Thanksgiving Day",
      "trading_hours": "09:30-13:00"
    },
    {
      "closed_all_day": false,
      "date": "2026-12-24",
      "name": "Christmas",
      "trading_hours": "09:30-13:00"
    },
    {
      "closed_all_day": true,
      "date": "2026-12-25",
      "name": "Christmas",
      "trading_hours": null
    }
  ],
  "next_holiday": {
    "closed_all_day": true,
    "date": "2026-11-26",
    "name": "Thanksgiving Day",
    "trading_hours": null
  },
  "timezone": "America/New_York"
}

Get market news

Get the latest market news, newest first: general, currencies, crypto, or mergers and acquisitions. Returns the newest article's ID, so a scheduled workflow can get only what is new each time.

Inputs

Categorycategorytext
The kind of market news to get.One of: general (General market news), forex (Currencies (forex)), crypto, merger (Mergers and acquisitions). Default: general.
Only articles after IDnewer_than_idnumber
Only articles newer than the one with this ID. To get only what is new since the last run, pass in the Latest ID an earlier run of this step returned. Leave blank for the latest articles.
Maximum articleslimitnumber
The most articles to return, newest first. Leave blank for all of them.At least 1.

Outputs

article_countnumber
How many articles there are
articleslist
The articles, newest first
categorytext
The news category
latest_idnumber
The newest article's ID. Pass it as Only articles after ID next time to get only newer ones
Example output
{
  "article_count": 2,
  "articles": [
    {
      "category": "top news",
      "headline": "Stocks close higher as rate hopes build",
      "id": 7512345,
      "image_url": "https://image.cnbcfm.com/api/v1/image/stocks.jpg",
      "published_at": "2026-09-26T21:10:00Z",
      "related_symbols": [],
      "source": "CNBC",
      "summary": "The S&P 500 rose for a third day.",
      "url": "https://www.cnbc.com/2026/09/26/stock-market-today.html"
    },
    {
      "category": "business",
      "headline": "Oil slips as supply worries ease",
      "id": 7512290,
      "image_url": null,
      "published_at": "2026-09-26T19:42:00Z",
      "related_symbols": [],
      "source": "Reuters",
      "summary": "Crude prices fell after inventories rose.",
      "url": "https://www.reuters.com/business/energy/oil-2026-09-26/"
    }
  ],
  "category": "general",
  "latest_id": 7512345
}

Get market status

Find out whether a stock exchange is open right now, which session it is in (pre-market, regular or post-market), and whether it is closed for a holiday.

Inputs

Exchangeexchangetext
The stock exchange to check.One of: BA (Argentina: Bolsa de Comercio de Buenos Aires), AX (Australia: ASX), VI (Austria: Vienna Stock Exchange), BH (Bahrain: Bahrain Bourse), BR (Belgium: Euronext Brussels), SA (Brazil: B3 (Sao Paulo)), CN (Canada: Canadian Securities Exchange), NE (Canada: NEO Exchange), TO (Canada: Toronto Stock Exchange), V (Canada: TSX Venture Exchange), and 67 more. Default: US.

Outputs

checked_attext
When Finnhub checked, as an ISO 8601 UTC time
exchangetext
The exchange's code, e.g. US
exchange_nametext
The exchange's name
holidaytext
The holiday it is closed for today, if any
is_opentrue/false
True while the market is open for regular trading
sessiontext
pre-market, regular or post-market while one is on; empty otherwise
timezonetext
The exchange's time zone, e.g. America/New_York
Example output
{
  "checked_at": "2026-09-25T12:15:00Z",
  "exchange": "US",
  "exchange_name": "NYSE, Nasdaq and other US exchanges",
  "holiday": null,
  "is_open": false,
  "session": "pre-market",
  "timezone": "America/New_York"
}

Get SEC filings

Get a company's SEC filings, newest first, optionally only one form such as 10-K annual reports or 8-K event reports, with links to read each one: up to 250 at a time.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.
Formformtext
Only filings of this form. Leave blank for every form.One of: 10-K (10-K: annual report), 10-Q (10-Q: quarterly report), 8-K (8-K: major event or earnings release), 4 (4: insider trade), DEF 14A (DEF 14A: proxy statement), S-1 (S-1: IPO registration), S-3 (S-3: shelf registration), 13F-HR (13F-HR: fund holdings report), SC 13D (SC 13D: stake over 5%, active investor), SC 13G (SC 13G: stake over 5%, passive investor), 20-F (20-F: annual report of a foreign company), 6-K (6-K: current report of a foreign company).
Start datestart_datedate
Only filings on or after this day. Leave blank for the latest ones.
End dateend_datedate
Only filings on or before this day.

Outputs

filing_countnumber
How many filings there are
filingslist
The filings, newest first
symboltext
The stock symbol, e.g. AAPL
Example output
{
  "filing_count": 2,
  "filings": [
    {
      "accepted_at": "2025-10-31T06:01:26",
      "access_number": "0000320193-25-000079",
      "cik": "320193",
      "filed_date": "2025-10-31",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html",
      "form": "10-K",
      "report_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
    },
    {
      "accepted_at": "2024-11-01T06:01:36",
      "access_number": "0000320193-24-000123",
      "cik": "320193",
      "filed_date": "2024-11-01",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
      "form": "10-K",
      "report_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
    }
  ],
  "symbol": "AAPL"
}

Get stock quote

Get a US stock's latest price, with how much it moved since the previous close, and the day's open, high and low.

Inputs

Stock symbolsymboltextRequired
The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search symbols finds one from a company name.

Outputs

changenumber
How much the price moved since the previous close
highnumber
The day's highest price
lownumber
The day's lowest price
opennumber
The day's opening price
percent_changenumber
That move as a percentage, e.g. 0.88 for 0.88%
previous_closenumber
The previous trading day's closing price
pricenumber
The latest price
symboltext
The stock symbol, e.g. AAPL
updated_attext
When the price was last updated, as an ISO 8601 UTC time
Example output
{
  "change": 2.29,
  "high": 263.31,
  "low": 260.68,
  "open": 261.07,
  "percent_change": 0.8826,
  "previous_close": 259.45,
  "price": 261.74,
  "symbol": "AAPL",
  "updated_at": "2026-09-25T20:00:00Z"
}

Search symbols

Find a company's stock symbol from its name, ISIN or CUSIP, best match first, optionally on one exchange. The symbol is what the other Finnhub actions take.

Inputs

Search forquerytextRequired
A company name, symbol, ISIN or CUSIP, such as Apple, AAPL or US0378331005.
Exchangeexchangetext
Only symbols listed on this exchange. Leave blank to search every exchange.One of: BA (Argentina: Bolsa de Comercio de Buenos Aires), AX (Australia: ASX), VI (Austria: Vienna Stock Exchange), BH (Bahrain: Bahrain Bourse), BR (Belgium: Euronext Brussels), SA (Brazil: B3 (Sao Paulo)), CN (Canada: Canadian Securities Exchange), NE (Canada: NEO Exchange), TO (Canada: Toronto Stock Exchange), V (Canada: TSX Venture Exchange), and 67 more.

Outputs

result_countnumber
How many symbols matched
resultslist
The matching symbols, best match first
Example output
{
  "result_count": 3,
  "results": [
    {
      "name": "APPLE INC",
      "symbol": "AAPL",
      "type": "Common Stock"
    },
    {
      "name": "APPLE HOSPITALITY REIT INC",
      "symbol": "APLE",
      "type": "Common Stock"
    },
    {
      "name": "APPLE REIT",
      "symbol": "APLR",
      "type": null
    }
  ]
}

finlight

Previous Page

Finta

Next Page

On this page

ActionsGet analyst recommendationsGet company newsGet company peersGet company profileGet earnings calendarGet earnings surprisesGet insider transactionsGet IPO calendarGet key metricsGet market holidaysGet market newsGet market statusGet SEC filingsGet stock quoteSearch symbols