How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Finnhub

Finnhub Default API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

Finnhub Default API is one of 8 APIs that Finnhub publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 117 operations across 117 paths, and defines 205 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://finnhub.io/api/v1.

117 operations 117 paths 205 schemas 114 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://finnhub.io/api/v1
Authentication
API Key
License
Apache-2.0
Resource Areas
1

Authentication & Security 1

Finnhub Default API declares 1 security scheme for authenticating requests. An API key is passed in the query as token (api_key).

Paths & Operations 117

Across 117 paths, the API surfaces 117 operations — 114 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

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

Schemas 205

The contract defines 205 schemas that model the data the API accepts and returns. The most detailed are CompanyProfile (33 properties), MutualFundProfileData (28 properties), ETFProfileData (23 properties), VisaApplication (23 properties). Each schema is shown below with its type and property counts.

CompanyEarningsQualityScore
object
3 properties
StockSymbol
object
10 properties
SimilarityIndex
object
3 properties
InstitutionalProfileInfo
object
6 properties
CompanyProfile
object
33 properties
InternationalFiling
object
9 properties
Transactions
object
8 properties
NetIncomeEstimates
object
3 properties
ScanPattern
object
LobbyingData
object
15 properties
FundOwnership
object
2 properties
SymbolLookup
object
2 properties
IPOEvent
object
8 properties
PatternRecognition
object
1 property
UsptoPatentResult
object
2 properties
PriceMetrics
object
3 properties
TranscriptContent
object
3 properties
EconomicData
object
2 properties
MutualFundEetPaiData
object
MutualFundEetData
object
MarketNews
object
9 properties
FundOwnershipInfo
object
5 properties
ETFProfileData
object
23 properties
MarketHolidayData
object
3 properties
PretaxIncomeEstimates
object
3 properties
EbitdaEstimates
object
3 properties
Forexrates
object
2 properties
SupportResistance
object
1 property
UsptoPatent
object
9 properties
ReportDataMap
object
MarketHoliday
object
3 properties
CryptoSymbol
object
3 properties
SymbolChangeInfo
object
3 properties
MarketCapData
object
2 properties
IndexHistoricalConstituent
object
3 properties
InsiderSentiments
object
2 properties
EarningsCallTranscripts
object
9 properties
FcfEstimates
object
3 properties
InvestmentThemePortfolio
object
1 property
InsiderSentimentsData
object
5 properties
FilingResponse
object
13 properties
RecommendationTrend
object
7 properties
UsaSpendingResult
object
2 properties
Company
object
7 properties
InstitutionalPortfolioGroup
object
3 properties
IPOCalendar
object
1 property
IndicesConstituents
object
3 properties
Indicator
object
3 properties
InstitutionalPortfolio
object
3 properties
CompanyNewsStatistics
object
3 properties
BankBranchData
object
5 properties
CryptoCandles
object
7 properties
DpsEstimates
object
3 properties
PressRelease
object
2 properties
FinancialStatements
object
2 properties
StockCandles
object
7 properties
EconomicCode
object
4 properties
RevenueBreakdown2
object
3 properties
MutualFundCountryExposureData
object
2 properties
CompanyESG2
object
6 properties
MarketStatus
object
6 properties
MutualFundProfile
object
2 properties
FDAComitteeMeeting
object
4 properties
CovidInfo
object
4 properties
IsinChange
object
3 properties
NewsroomArticle
object
4 properties
Dividends2
object
2 properties
EbitdaEstimatesInfo
object
7 properties
OcfEstimates
object
3 properties
VisaApplicationResult
object
2 properties
ExcerptResponse
object
4 properties
SearchBody
object
22 properties 1 required
EarningsCallLive
object
1 property
TechnicalIndicator
object
RevenueBreakdown
object
3 properties
CompanyProfile2
object
12 properties
Report
object
11 properties
InstitutionalProfile
object
2 properties
GrossIncomeEstimates
object
3 properties
HistoricalCompanyESG
object
2 properties
SymbolLookupInfo
object
4 properties
LobbyingResult
object
2 properties
NetIncomeEstimatesInfo
object
7 properties
Trend
object
2 properties
SupplyChainRelationships
object
2 properties
BondYieldCurve
object
2 properties
SocialSentiment
object
2 properties
VisaApplication
object
23 properties
MutualFundSectorExposureData
object
2 properties
MutualFundHoldingsData
object
8 properties
ETFsSectorExposure
object
2 properties
CongressionalTransaction
object
10 properties
MutualFundHoldings
object
4 properties
ETFsHoldings
object
4 properties
CountryMetadata
object
13 properties
Quote
object
7 properties
MutualFundSectorExposure
object
2 properties
ForexSymbol
object
3 properties
OcfEstimatesInfo
object
7 properties
StockPresentation
object
2 properties
CapexEstimatesInfo
object
7 properties
IsinChangeInfo
object
3 properties
FcfEstimatesInfo
object
7 properties
AirlinePriceIndexData
object
4 properties
CompanyEarningsQualityScoreData
object
7 properties
InstitutionalPortfolioInfo
object
11 properties
UpgradeDowngrade
object
6 properties
Dividends2Info
object
2 properties
HistoricalMarketCapData
object
3 properties
Economic_event
object
8 properties
SearchFilter
object
2 properties
ETFCountryExposureData
object
2 properties
CompanyNews
object
9 properties
PriceTarget
object
7 properties
MetricMap
object
InstitutionalOwnership
object
3 properties
InFilingSearchBody
object
2 properties 2 required
InvestmentThemes
object
2 properties
RevenueEstimatesInfo
object
7 properties
LastBid-Ask
object
5 properties
EarningResult
object
8 properties
ETFSectorExposureData
object
2 properties
EbitEstimatesInfo
object
7 properties
EbitEstimates
object
3 properties
InFilingResponse
object
14 properties
ETFHoldingsData
object
8 properties
HistoricalNBBO
object
12 properties
BankBranchRes
object
2 properties
PriceMetricMap
object
Newsroom
object
2 properties
ETFsCountryExposure
object
2 properties
UsaSpending
object
20 properties
CryptoProfile
object
11 properties
EarningsCallLiveResult
object
7 properties
EarningRelease
object
9 properties
DpsEstimatesInfo
object
7 properties
CompanyESGMap
object
SectorMetricData
object
2 properties
PretaxIncomeEstimatesInfo
object
7 properties
CompanyExecutive
object
2 properties
ETFsAllocation
object
2 properties
RevenueEstimates
object
3 properties
AIChatBody
object
2 properties 1 required
SymbolChange
object
3 properties
MutualFundProfileData
object
28 properties
CapexEstimates
object
3 properties
Development
object
5 properties
IndicatorFields
object
BondTickData
object
12 properties
SentimentContent
object
7 properties
TranscriptParticipant
object
3 properties
TechnicalAnalysis
object
2 properties
SearchResponse
object
4 properties
EmployeeCount
object
2 properties
EarningsEstimatesInfo
object
7 properties
AggregateIndicators
object
2 properties
Dividends
object
9 properties
Ownership
object
2 properties
FinancialsAsReported
object
3 properties
Sentiment
object
2 properties
DocumentResponse
object
6 properties
IndicesHistoricalConstituents
object
2 properties
AIChatMessage
object
2 properties
BondYieldCurveInfo
object
2 properties
MetricSeriesMap
object
CongressionalTrading
object
2 properties
SECSentimentAnalysis
object
4 properties
NewsSentiment
object
6 properties
EarningsCallTranscriptsList
object
2 properties
InsiderTransactions
object
2 properties
StockTranscripts
object
5 properties
BreakdownItem
object
2 properties
KeyCustomersSuppliers
object
12 properties
EarningsCalendar
object
1 property
FinancialMap
object
IndicesConstituentsBreakdown
object
6 properties
SimilarityIndexInfo
object
12 properties
MutualFundCountryExposure
object
2 properties
MutualFundEetPai
object
2 properties
CompanyESG
object
6 properties
EconomicCalendar
object
1 property
SectorMetric
object
2 properties
ForexRate
object
BasicFinancials
object
4 properties
BondCandles
object
3 properties
TickData
object
9 properties
OwnershipInfo
object
4 properties
ForexCandles
object
7 properties
AirlinePriceIndex
object
3 properties
EarningsEstimates
object
3 properties
BondProfile
object
21 properties
Split
object
4 properties
ETFAllocationData
object
9 properties
PresentationData
object
5 properties
EconomicDataInfo
object
2 properties
HistoricalEmployeeCount
object
2 properties
AIChatResponse
object
7 properties
InstitutionalOwnershipInfo
object
10 properties
InstitutionalOwnershipGroup
object
2 properties
MutualFundEet
object
2 properties
BreakdownItemMap
object
Filing
object
8 properties
GrossIncomeEstimatesInfo
object
7 properties
ETFsProfile
object
2 properties
FilingSentiment
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

finnhub-default-api-openapi.yml Raw ↑

Other APIs Finnhub publishes across the network.

Finnhub Company News API
AE Profile APIs.io
Finnhub Crypto API
AE Profile APIs.io
Finnhub Forex API
AE Profile APIs.io
Finnhub News API
AE Profile APIs.io
Finnhub Quote API
AE Profile APIs.io
Finnhub Search API
AE Profile APIs.io
Finnhub Stock API
AE Profile APIs.io
← Back to F APIs
API Details
ID
finnhub:finnhub-default-api
Base URL
https://finnhub.io/api/v1
Docs
https://finnhub.io/docs/api
Provider
Finnhub
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=finnhub-default-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/finnhub-default-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Finnhub Default API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.