{
"openapi": "3.0.0",
"info": {
"version": "1.0.0",
"title": "Finnhub API",
"license": {
"name": "Apache-2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0.html"
}
},
"paths": {
"/search": {
"get": {
"tags": [
"Default"
],
"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",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "q",
"in": "query",
"description": "Query text can be symbol, name, isin, or cusip.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "exchange",
"in": "query",
"description": "Exchange limit.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SymbolLookup"
}
}
}
}
}
}
},
"/stock/symbol": {
"get": {
"tags": [
"Default"
],
"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",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "exchange",
"in": "query",
"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"
}
},
{
"name": "mic",
"in": "query",
"description": "Filter by MIC code.",
"schema": {
"type": "string"
}
},
{
"name": "securityType",
"in": "query",
"description": "Filter by security type used by OpenFigi standard.",
"schema": {
"type": "string"
}
},
{
"name": "currency",
"in": "query",
"description": "Filter by currency.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/StockSymbol"
}
}
}
}
}
}
}
},
"/stock/market-status": {
"get": {
"tags": [
"Default"
],
"summary": "Market Status",
"description": "Get current market status for global exchanges (whether exchanges are open or close).",
"operationId": "market-status",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "exchange",
"in": "query",
"description": "Exchange code.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MarketStatus"
}
}
}
}
}
}
},
"/stock/market-holiday": {
"get": {
"tags": [
"Default"
],
"summary": "Market Holiday",
"description": "Get a list of holidays for global exchanges.",
"operationId": "market-holiday",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "exchange",
"in": "query",
"description": "Exchange code.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MarketHoliday"
}
}
}
}
}
}
},
"/stock/profile": {
"get": {
"tags": [
"Default"
],
"summary": "Company Profile",
"description": "Get general information of a company. You can query by symbol, ISIN or CUSIP",
"operationId": "company-profile",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL e.g.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ISIN",
"schema": {
"type": "string"
}
},
{
"name": "cusip",
"in": "query",
"description": "CUSIP",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/CompanyProfile"
}
}
}
}
}
}
},
"/stock/profile2": {
"get": {
"tags": [
"Default"
],
"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",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL e.g.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ISIN",
"schema": {
"type": "string"
}
},
{
"name": "cusip",
"in": "query",
"description": "CUSIP",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/CompanyProfile2"
}
}
}
}
}
}
},
"/stock/executive": {
"get": {
"tags": [
"Default"
],
"summary": "Company Executive",
"description": "Get a list of company's executives and members of the Board.",
"operationId": "company-executive",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"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"
}
}
}
}
}
}
},
"/news": {
"get": {
"tags": [
"Default"
],
"summary": "Market News",
"description": "Get latest market news.",
"operationId": "market-news",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "category",
"in": "query",
"description": "This parameter can be 1 of the following values <code>general, forex, crypto, merger</code>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "minId",
"in": "query",
"description": "Use this field to get only news after this ID. Default to 0",
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MarketNews"
}
}
}
}
}
}
}
},
"/company-news": {
"get": {
"tags": [
"Default"
],
"summary": "Company News",
"description": "List latest company news by symbol. This endpoint is only available for North American companies.",
"operationId": "company-news",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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"
}
}
}
}
}
}
}
},
"/press-releases": {
"get": {
"tags": [
"Default"
],
"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",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From time: 2020-01-01.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To time: 2020-01-05.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/PressRelease"
}
}
}
}
}
}
},
"/news-sentiment": {
"get": {
"tags": [
"Default"
],
"summary": "News Sentiment",
"description": "Get company's news sentiment and statistics. This endpoint is only available for US companies.",
"operationId": "news-sentiment",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/NewsSentiment"
}
}
}
}
}
}
},
"/stock/peers": {
"get": {
"tags": [
"Default"
],
"summary": "Peers",
"description": "Get company peers. Return a list of peers operating in the same country and sector/industry.",
"operationId": "company-peers",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "grouping",
"in": "query",
"description": "Specify the grouping criteria for choosing peers.Supporter values: <code>sector</code>, <code>industry</code>, <code>subIndustry</code>. Default to <code>subIndustry</code>.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
},
"/stock/metric": {
"get": {
"tags": [
"Default"
],
"summary": "Basic Financials",
"description": "Get company basic financials such as margin, P/E ratio, 52-week high/low etc.",
"operationId": "company-basic-financials",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "metric",
"in": "query",
"description": "Metric type. Can be 1 of the following values <code>all</code>",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/BasicFinancials"
}
}
}
}
}
}
},
"/stock/price-metric": {
"get": {
"tags": [
"Default"
],
"summary": "Price Metrics",
"description": "Get company price performance statistics such as 52-week high/low, YTD return and much more.",
"operationId": "price-metrics",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "date",
"in": "query",
"description": "Get data on a specific date in the past. The data is available weekly so your date will be automatically adjusted to the last day of that week.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/PriceMetrics"
}
}
}
}
}
}
},
"/ca/symbol-change": {
"get": {
"tags": [
"Default"
],
"summary": "Symbol Change",
"description": "Get a list of symbol changes for US-listed, EU-listed, NSE and ASX securities. Limit to 2000 events at a time.",
"operationId": "symbol-change",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SymbolChange"
}
}
}
}
}
}
},
"/ca/isin-change": {
"get": {
"tags": [
"Default"
],
"summary": "ISIN Change",
"description": "Get a list of ISIN changes for EU-listed securities. Limit to 2000 events at a time.",
"operationId": "isin-change",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/IsinChange"
}
}
}
}
}
}
},
"/stock/historical-market-cap": {
"get": {
"tags": [
"Default"
],
"summary": "Historical Market Cap",
"description": "Get historical market cap data for global companies.",
"operationId": "historical-market-cap",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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": "object",
"$ref": "#/components/schemas/HistoricalMarketCapData"
}
}
}
}
}
}
},
"/stock/historical-employee-count": {
"get": {
"tags": [
"Default"
],
"summary": "Historical Employee Count",
"description": "Get historical employee count for global companies.",
"operationId": "historical-employee-count",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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": "object",
"$ref": "#/components/schemas/HistoricalEmployeeCount"
}
}
}
}
}
}
},
"/institutional/profile": {
"get": {
"tags": [
"Default"
],
"summary": "Institutional Profile",
"description": "Get a list of well-known institutional investors. Currently support 60+ profiles.",
"operationId": "institutional-profile",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "cik",
"in": "query",
"description": "Filter by CIK. Leave blank to get the full list.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InstitutionalProfile"
}
}
}
}
}
}
},
"/institutional/portfolio": {
"get": {
"tags": [
"Default"
],
"summary": "Institutional Portfolio",
"description": "Get the holdings/portfolio data of institutional investors from 13-F filings. Limit to 1 year of data at a time. You can get a list of supported CIK <a href=\"/api/v1/institutional/list?token=\" target=\"_blank\">here</a>.",
"operationId": "institutional-portfolio",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "cik",
"in": "query",
"description": "Fund's CIK.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InstitutionalPortfolio"
}
}
}
}
}
}
},
"/institutional/ownership": {
"get": {
"tags": [
"Default"
],
"summary": "Institutional Ownership",
"description": "Get a list institutional investors' positions for a particular stock overtime. Data from 13-F filings. Limit to 1 year of data at a time.",
"operationId": "institutional-ownership",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Filter by symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "cusip",
"in": "query",
"description": "Filter by CUSIP.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InstitutionalOwnership"
}
}
}
}
}
}
},
"/stock/ownership": {
"get": {
"tags": [
"Default"
],
"summary": "Ownership",
"description": "Get a full list of shareholders of a company in descending order of the number of shares held. Data is sourced from <code>13F form</code>, <code>Schedule 13D</code> and <code>13G</code> for US market, <code>UK Share Register</code> for UK market, <code>SEDI</code> for Canadian market and equivalent filings for other international markets.",
"operationId": "ownership",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Limit number of results. Leave empty to get the full list.",
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/Ownership"
}
}
}
}
}
}
},
"/stock/fund-ownership": {
"get": {
"tags": [
"Default"
],
"summary": "Fund Ownership",
"description": "Get a full list fund and institutional investors of a company in descending order of the number of shares held. Data is sourced from <code>13F form</code>, <code>Schedule 13D</code> and <code>13G</code> for US market, <code>UK Share Register</code> for UK market, <code>SEDI</code> for Canadian market and equivalent filings for other international markets.",
"operationId": "fund-ownership",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Limit number of results. Leave empty to get the full list.",
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/FundOwnership"
}
}
}
}
}
}
},
"/stock/insider-transactions": {
"get": {
"tags": [
"Default"
],
"summary": "Insider Transactions",
"description": "Company insider transactions data sourced from <code>Form 3,4,5</code>, SEDI and relevant companies' filings. This endpoint covers US, UK, Canada, Australia, India, and all major EU markets. Limit to 100 transactions per API call.",
"operationId": "insider-transactions",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL. Leave this param blank to get the latest transactions.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date: 2020-03-15.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2020-03-16.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InsiderTransactions"
}
}
}
}
}
}
},
"/stock/insider-sentiment": {
"get": {
"tags": [
"Default"
],
"summary": "Insider Sentiment",
"description": "Get insider sentiment data for US companies calculated using method discussed <a href=\"https://medium.com/@stock-api/finnhub-insiders-sentiment-analysis-cc43f9f64b3a\" target=\"_blank\">here</a>. The MSPR ranges from -100 for the most negative to 100 for the most positive which can signal price changes in the coming 30-90 days.",
"operationId": "insider-sentiment",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date: 2020-03-15.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2020-03-16.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InsiderSentiments"
}
}
}
}
}
}
},
"/stock/financials": {
"get": {
"tags": [
"Default"
],
"summary": "Financial Statements",
"description": "<p>Get standardized balance sheet, income statement and cash flow for global companies going back 30+ years. Data is sourced from original filings most of which made available through <a href=\"#filings\">SEC Filings</a> and <a href=\"#international-filings\">International Filings</a> endpoints.</p><p>Set <code>preliminary</code> param to true for faster updates for US companies.</p><p><i>Wondering why our standardized data is different from Bloomberg, Reuters, Factset, S&P or Yahoo Finance ? Check out our <a href=\"/faq\">FAQ page</a> to learn more</i></p>",
"operationId": "financials",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "statement",
"in": "query",
"description": "Statement can take 1 of these values <code>bs, ic, cf</code> for Balance Sheet, Income Statement, Cash Flow respectively.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Frequency can take 1 of these values <code>annual, quarterly, ttm, ytd</code>. TTM (Trailing Twelve Months) option is available for Income Statement and Cash Flow. YTD (Year To Date) option is only available for Cash Flow.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "preliminary",
"in": "query",
"description": "If set to <code>true</code>, it will return Preliminary financial statements for the latest period which are usually available within an hour of the earnings announcement if finalized data is not available yet. This preliminary data is currently available for US companies. You will see <code>\"preliminary\": true</code> in the data if that period is using preliminary data.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/FinancialStatements"
}
}
}
}
}
}
},
"/stock/financials-reported": {
"get": {
"tags": [
"Default"
],
"summary": "Financials As Reported",
"description": "Get financials as reported. This data is available for bulk download on <a href=\"https://www.kaggle.com/finnhub/reported-financials\" target=\"_blank\">Kaggle SEC Financials database</a>.",
"operationId": "financials-reported",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"schema": {
"type": "string"
}
},
{
"name": "cik",
"in": "query",
"description": "CIK.",
"schema": {
"type": "string"
}
},
{
"name": "accessNumber",
"in": "query",
"description": "Access number of a specific report you want to retrieve financials from.",
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Frequency. Can be either <code>annual</code> or <code>quarterly</code>. Default to <code>annual</code>.",
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>. Filter for endDate.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>. Filter for endDate.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/FinancialsAsReported"
}
}
}
}
}
}
},
"/stock/revenue-breakdown": {
"get": {
"tags": [
"Default"
],
"summary": "Revenue Breakdown",
"description": "<p>Get revenue breakdown as-reporetd by product and geography. Users on personal plans can access data for US companies which disclose their revenue breakdown in the annual or quarterly reports.</p><p>Global standardized revenue breakdown/segments data is available for Enterprise users. <a href=\"mailto:support@finnhub.io\">Contact us</a> to inquire about the access for Global standardized data.</p>",
"operationId": "revenue-breakdown",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"schema": {
"type": "string"
}
},
{
"name": "cik",
"in": "query",
"description": "CIK.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/RevenueBreakdown"
}
}
}
}
}
}
},
"/stock/filings": {
"get": {
"tags": [
"Default"
],
"summary": "SEC Filings",
"description": "List company's filing. Limit to 250 documents at a time. This data is available for bulk download on <a href=\"https://www.kaggle.com/finnhub/sec-filings\" target=\"_blank\">Kaggle SEC Filings database</a>.",
"operationId": "filings",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol. Leave <code>symbol</code>,<code>cik</code> and <code>accessNumber</code> empty to list latest filings.",
"schema": {
"type": "string"
}
},
{
"name": "cik",
"in": "query",
"description": "CIK.",
"schema": {
"type": "string"
}
},
{
"name": "accessNumber",
"in": "query",
"description": "Access number of a specific report you want to retrieve data from.",
"schema": {
"type": "string"
}
},
{
"name": "form",
"in": "query",
"description": "Filter by form. You can use this value <code>NT 10-K</code> to find non-timely filings for a company.",
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date: 2023-03-15.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2023-03-16.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Filing"
}
}
}
}
}
}
}
},
"/stock/filings-sentiment": {
"get": {
"tags": [
"Default"
],
"summary": "SEC Sentiment Analysis",
"description": "Get sentiment analysis of 10-K and 10-Q filings from SEC. An abnormal increase in the number of positive/negative words in filings can signal a significant change in the company's stock price in the upcoming 4 quarters. We make use of <a href= \"https://sraf.nd.edu/textual-analysis/resources/\" target=\"_blank\">Loughran and McDonald Sentiment Word Lists</a> to calculate the sentiment for each filing.",
"operationId": "filings-sentiment",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "accessNumber",
"in": "query",
"description": "Access number of a specific report you want to retrieve data from.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SECSentimentAnalysis"
}
}
}
}
}
}
},
"/stock/similarity-index": {
"get": {
"tags": [
"Default"
],
"summary": "Similarity Index",
"description": "<p>Calculate the textual difference between a company's 10-K / 10-Q reports and the same type of report in the previous year using Cosine Similarity. For example, this endpoint compares 2019's 10-K with 2018's 10-K. Companies breaking from its routines in disclosure of financial condition and risk analysis section can signal a significant change in the company's stock price in the upcoming 4 quarters.</p>",
"operationId": "similarity-index",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol. Required if cik is empty",
"schema": {
"type": "string"
}
},
{
"name": "cik",
"in": "query",
"description": "CIK. Required if symbol is empty",
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "<code>annual</code> or <code>quarterly</code>. Default to <code>annual</code>",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SimilarityIndex"
}
}
}
}
}
}
},
"/calendar/ipo": {
"get": {
"tags": [
"Default"
],
"summary": "IPO Calendar",
"description": "Get recent and upcoming IPO.",
"operationId": "ipo-calendar",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "from",
"in": "query",
"description": "From date: 2020-03-15.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2020-03-16.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/IPOCalendar"
}
}
}
}
}
}
},
"/sector/metrics": {
"get": {
"tags": [
"Default"
],
"summary": "Sector Metrics",
"description": "Get ratios for different sectors and regions/indices.",
"operationId": "sector-metric",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "region",
"in": "query",
"description": "Region. A list of supported values for this field can be found <a href=\"https://docs.google.com/spreadsheets/d/1afedyv7yWJ-z7pMjaAZK-f6ENY3mI3EBCk95QffpoHw/edit?usp=sharing\" target=\"_blank\">here</a>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SectorMetric"
}
}
}
}
}
}
},
"/stock/dividend": {
"get": {
"tags": [
"Default"
],
"summary": "Dividends",
"description": "Get dividends data for common stocks going back 30 years.",
"operationId": "stock-dividends",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "YYYY-MM-DD.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "YYYY-MM-DD.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Dividends"
}
}
}
}
}
}
}
},
"/stock/recommendation": {
"get": {
"tags": [
"Default"
],
"summary": "Recommendation Trends",
"description": "Get latest analyst recommendation trends for a company.",
"operationId": "recommendation-trends",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RecommendationTrend"
}
}
}
}
}
}
}
},
"/stock/price-target": {
"get": {
"tags": [
"Default"
],
"summary": "Price Target",
"description": "Get latest price target consensus.",
"operationId": "price-target",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"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/PriceTarget"
}
}
}
}
}
}
},
"/stock/upgrade-downgrade": {
"get": {
"tags": [
"Default"
],
"summary": "Stock Upgrade/Downgrade",
"description": "Get latest stock upgrade and downgrade.",
"operationId": "upgrade-downgrade",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL. If left blank, the API will return latest stock upgrades/downgrades.",
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date: 2000-03-15.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2020-03-16.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UpgradeDowngrade"
}
}
}
}
}
}
}
},
"/stock/revenue-estimate": {
"get": {
"tags": [
"Default"
],
"summary": "Revenue Estimates",
"description": "Get company's revenue estimates.",
"operationId": "company-revenue-estimates",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Can take 1 of the following values: <code>annual, quarterly</code>. Default to <code>quarterly</code>",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/RevenueEstimates"
}
}
}
}
}
}
},
"/stock/ebitda-estimate": {
"get": {
"tags": [
"Default"
],
"summary": "EBITDA Estimates",
"description": "Get company's ebitda estimates.",
"operationId": "company-ebitda-estimates",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Can take 1 of the following values: <code>annual, quarterly</code>. Default to <code>quarterly</code>",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EbitdaEstimates"
}
}
}
}
}
}
},
"/stock/ebit-estimate": {
"get": {
"tags": [
"Default"
],
"summary": "EBIT Estimates",
"description": "Get company's ebit estimates.",
"operationId": "company-ebit-estimates",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Can take 1 of the following values: <code>annual, quarterly</code>. Default to <code>quarterly</code>",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EbitEstimates"
}
}
}
}
}
}
},
"/stock/eps-estimate": {
"get": {
"tags": [
"Default"
],
"summary": "Earnings Estimates",
"description": "Get company's EPS estimates.",
"operationId": "company-eps-estimates",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Can take 1 of the following values: <code>annual, quarterly</code>. Default to <code>quarterly</code>",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EarningsEstimates"
}
}
}
}
}
}
},
"/stock/earnings": {
"get": {
"tags": [
"Default"
],
"summary": "Earnings Surprises",
"description": "Get company historical quarterly earnings surprise going back to 2000.",
"operationId": "company-earnings",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Limit number of period returned. Leave blank to get the full history.",
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EarningResult"
}
}
}
}
}
}
}
},
"/calendar/earnings": {
"get": {
"tags": [
"Default"
],
"summary": "Earnings Calendar",
"description": "Get historical and coming earnings release. EPS and Revenue in this endpoint are non-GAAP, which means they are adjusted to exclude some one-time or unusual items. This is the same data investors usually react to and talked about on the media. Estimates are sourced from both sell-side and buy-side analysts.",
"operationId": "earnings-calendar",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "from",
"in": "query",
"description": "From date: 2020-03-15.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2020-03-16.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "symbol",
"in": "query",
"description": "Filter by symbol: AAPL.",
"schema": {
"type": "string"
}
},
{
"name": "international",
"in": "query",
"description": "Set to <code>true</code> to include international markets. Default value is <code>false</code>",
"schema": {
"type": "boolean"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EarningsCalendar"
}
}
}
}
}
}
},
"/quote": {
"get": {
"tags": [
"Default"
],
"summary": "Quote",
"description": "<p>Get real-time quote data for US stocks. Constant polling is not recommended. Use websocket if you need real-time updates.</p><p>Real-time stock prices for international markets are supported for Enterprise clients via our partner's feed. <a href=\"mailto:support@finnhub.io\">Contact Us</a> to learn more.</p>",
"operationId": "quote",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/Quote"
}
}
}
}
}
}
},
"/stock/candle": {
"get": {
"tags": [
"Default"
],
"summary": "Stock Candles",
"description": "<p>Get candlestick data (OHLCV) for stocks.</p><p>Daily data will be adjusted for Splits. Intraday data will remain unadjusted. Only 1 month of intraday will be returned at a time. If you need more historical intraday data, please use the from and to params iteratively to request more data.</p>",
"operationId": "stock-candles",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "UNIX timestamp. Interval initial value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "UNIX timestamp. Interval end value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/StockCandles"
}
}
}
}
}
}
},
"/stock/tick": {
"get": {
"tags": [
"Default"
],
"summary": "Tick Data",
"description": "<p>Get historical tick data for global exchanges.</p><p>For more historical tick data, you can visit our bulk download page in the Dashboard <a target=\"_blank\" href=\"/dashboard/download\",>here</a> to speed up the download process.</p><table class=\"table table-hover\">\n <thead>\n <tr>\n <th>Exchange</th>\n <th>Segment</th>\n <th>Delay</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"text-blue\">US CTA/UTP</th>\n <td>Full SIP</td>\n <td>End-of-day</td>\n </tr>\n <tr>\n <td class=\"text-blue\">TSX</th>\n <td><ul><li>TSX</li><li>TSX Venture</li><li>Index</li></ul></td>\n <td>End-of-day</td>\n </tr>\n <tr>\n <td class=\"text-blue\">LSE</th>\n <td><ul><li>London Stock Exchange (L)</li><li>LSE International (L)</li><li>LSE European (L)</li></ul></td>\n <td>15 minute</td>\n </tr>\n <tr>\n <td class=\"text-blue\">Euronext</th>\n <td><ul> <li>Euronext Paris (PA)</li> <li>Euronext Amsterdam (AS)</li> <li>Euronext Lisbon (LS)</li> <li>Euronext Brussels (BR)</li> <li>Euronext Oslo (OL)</li> <li>Euronext London (LN)</li> <li>Euronext Dublin (IR)</li> <li>Index</li> <li>Warrant</li></ul></td>\n <td>End-of-day</td>\n </tr>\n <tr>\n <td class=\"text-blue\">Deutsche B\u00f6rse</th>\n <td><ul> <li>Frankfurt (F)</li> <li>Xetra (DE)</li> <li>Duesseldorf (DU)</li> <li>Hamburg (HM)</li> <li>Berlin (BE)</li> <li>Hanover (HA)</li> <li>Stoxx (SX)</li> <li>TradeGate (TG)</li> <li>Zertifikate (SC)</li> <li>Index</li> <li>Warrant</li></ul></td>\n <td>End-of-day</td>\n </tr>\n </tbody>\n</table>",
"operationId": "stock-tick",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "date",
"in": "query",
"description": "Date: 2020-04-02.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "limit",
"in": "query",
"description": "Limit number of ticks returned. Maximum value: <code>25000</code>",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "skip",
"in": "query",
"description": "Number of ticks to skip. Use this parameter to loop through the entire data.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/TickData"
}
}
}
}
}
}
},
"/stock/bbo": {
"get": {
"tags": [
"Default"
],
"summary": "Historical NBBO",
"description": "<p>Get historical best bid and offer for US stocks, LSE, TSX, Euronext and Deutsche Borse.</p><p>For US market, this endpoint only serves historical NBBO from the beginning of 2023. To download more historical data, please visit our bulk download page in the Dashboard <a target=\"_blank\" href=\"/dashboard/download\",>here</a>.</p>",
"operationId": "stock-nbbo",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "date",
"in": "query",
"description": "Date: 2020-04-02.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "limit",
"in": "query",
"description": "Limit number of ticks returned. Maximum value: <code>25000</code>",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "skip",
"in": "query",
"description": "Number of ticks to skip. Use this parameter to loop through the entire data.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/HistoricalNBBO"
}
}
}
}
}
}
},
"/stock/bidask": {
"get": {
"tags": [
"Default"
],
"summary": "Last Bid-Ask",
"description": "Get last bid/ask data for US stocks.",
"operationId": "stock-bidask",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/LastBid-Ask"
}
}
}
}
}
}
},
"/stock/split": {
"get": {
"tags": [
"Default"
],
"summary": "Splits",
"description": "Get splits data for stocks.",
"operationId": "stock-splits",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "YYYY-MM-DD.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "YYYY-MM-DD.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Split"
}
}
}
}
}
}
}
},
"/stock/dividend2": {
"get": {
"tags": [
"Default"
],
"summary": "Dividends 2 (Basic)",
"description": "Get global dividends data.",
"operationId": "stock-basic-dividends",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/Dividends2"
}
}
}
}
}
}
},
"/index/constituents": {
"get": {
"tags": [
"Default"
],
"summary": "Indices Constituents",
"description": "Get a list of index's constituents. A list of supported indices for this endpoint can be found <a href=\"/api/v1/index/list?token=\" target=\"_blank\">here</a>.",
"operationId": "indices-constituents",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "symbol",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/IndicesConstituents"
}
}
}
}
}
}
},
"/index/historical-constituents": {
"get": {
"tags": [
"Default"
],
"summary": "Indices Historical Constituents",
"description": "Get full history of index's constituents including symbols and dates of joining and leaving the Index. A list of supported indices for this endpoint can be found <a href=\"/api/v1/index/historical-list?token=\" target=\"_blank\">here</a>.",
"operationId": "indices-historical-constituents",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "symbol",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/IndicesHistoricalConstituents"
}
}
}
}
}
}
},
"/etf/profile": {
"get": {
"tags": [
"Default"
],
"summary": "ETFs Profile",
"description": "Get ETF profile information. This endpoint has global coverage. A list of supported ETFs can be found <a href=\"/api/v1/etf/list?type=csv&token=\" target=\"_blank\">here</a>.",
"operationId": "etfs-profile",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "ETF symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ETF isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/ETFsProfile"
}
}
}
}
}
}
},
"/etf/holdings": {
"get": {
"tags": [
"Default"
],
"summary": "ETFs Holdings",
"description": "Get full ETF holdings/constituents. This endpoint has global coverage. Widget only shows top 10 holdings. A list of supported ETFs can be found <a href=\"/api/v1/etf/list?token=\" target=\"_blank\">here</a>.",
"operationId": "etfs-holdings",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "ETF symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ETF isin.",
"schema": {
"type": "string"
}
},
{
"name": "skip",
"in": "query",
"description": "Skip the first n results. You can use this parameter to query historical constituents data. The latest result is returned if skip=0 or not set.",
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "date",
"in": "query",
"description": "Query holdings by date. You can use either this param or <code>skip</code> param, not both.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/ETFsHoldings"
}
}
}
}
}
}
},
"/etf/sector": {
"get": {
"tags": [
"Default"
],
"summary": "ETFs Sector Exposure",
"description": "Get ETF sector exposure data.",
"operationId": "etfs-sector-exposure",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "ETF symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ETF isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/ETFsSectorExposure"
}
}
}
}
}
}
},
"/etf/country": {
"get": {
"tags": [
"Default"
],
"summary": "ETFs Country Exposure",
"description": "Get ETF country exposure data.",
"operationId": "etfs-country-exposure",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "ETF symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ETF isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/ETFsCountryExposure"
}
}
}
}
}
}
},
"/etf/allocation": {
"get": {
"tags": [
"Default"
],
"summary": "ETFs Equity Allocation",
"description": "Get ETF equity allocation based on the characteristics of the holdings.",
"operationId": "etfs-allocation",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "ETF symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "ETF isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/ETFsAllocation"
}
}
}
}
}
}
},
"/mutual-fund/profile": {
"get": {
"tags": [
"Default"
],
"summary": "Mutual Funds Profile",
"description": "Get mutual funds profile information. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN. A list of supported funds can be found <a href=\"/api/v1/mutual-fund/list?type=csv&token=\" target=\"_blank\">here</a>.",
"operationId": "mutual-fund-profile",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Fund's symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "Fund's isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MutualFundProfile"
}
}
}
}
}
}
},
"/mutual-fund/holdings": {
"get": {
"tags": [
"Default"
],
"summary": "Mutual Funds Holdings",
"description": "Get full Mutual Funds holdings/constituents. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN. A list of supported funds can be found <a href=\"/api/v1/mutual-fund/list?token=\" target=\"_blank\">here</a>.",
"operationId": "mutual-fund-holdings",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Fund's symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "Fund's isin.",
"schema": {
"type": "string"
}
},
{
"name": "skip",
"in": "query",
"description": "Skip the first n results. You can use this parameter to query historical constituents data. The latest result is returned if skip=0 or not set.",
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MutualFundHoldings"
}
}
}
}
}
}
},
"/mutual-fund/sector": {
"get": {
"tags": [
"Default"
],
"summary": "Mutual Funds Sector Exposure",
"description": "Get Mutual Funds sector exposure data.",
"operationId": "mutual-fund-sector-exposure",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Mutual Fund symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "Fund's isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MutualFundSectorExposure"
}
}
}
}
}
}
},
"/mutual-fund/country": {
"get": {
"tags": [
"Default"
],
"summary": "Mutual Funds Country Exposure",
"description": "Get Mutual Funds country exposure data.",
"operationId": "mutual-fund-country-exposure",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"schema": {
"type": "string"
}
},
{
"name": "isin",
"in": "query",
"description": "Fund's isin.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MutualFundCountryExposure"
}
}
}
}
}
}
},
"/mutual-fund/eet": {
"get": {
"tags": [
"Default"
],
"summary": "Mutual Funds EET",
"description": "Get EET data for EU funds. For PAIs data, please see the EET PAI endpoint.",
"operationId": "mutual-fund-eet",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "isin",
"in": "query",
"description": "ISIN.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MutualFundEet"
}
}
}
}
}
}
},
"/mutual-fund/eet-pai": {
"get": {
"tags": [
"Default"
],
"summary": "Mutual Funds EET PAI",
"description": "Get EET PAI data for EU funds.",
"operationId": "mutual-fund-eet-pai",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "isin",
"in": "query",
"description": "ISIN.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/MutualFundEetPai"
}
}
}
}
}
}
},
"/forex/exchange": {
"get": {
"tags": [
"Default"
],
"summary": "Forex Exchanges",
"description": "List supported forex exchanges",
"operationId": "forex-exchanges",
"security": [
{
"api_key": []
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
},
"/forex/symbol": {
"get": {
"tags": [
"Default"
],
"summary": "Forex Symbol",
"description": "List supported forex symbols.",
"operationId": "forex-symbols",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "exchange",
"in": "query",
"description": "Exchange you want to get the list of symbols from.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ForexSymbol"
}
}
}
}
}
}
}
},
"/forex/candle": {
"get": {
"tags": [
"Default"
],
"summary": "Forex Candles",
"description": "Get candlestick data for forex symbols.",
"operationId": "forex-candles",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Use symbol returned in <code>/forex/symbol</code> endpoint for this field.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "UNIX timestamp. Interval initial value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "UNIX timestamp. Interval end value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/ForexCandles"
}
}
}
}
}
}
},
"/forex/rates": {
"get": {
"tags": [
"Default"
],
"summary": "Forex rates",
"description": "Get rates for all forex pairs. Ideal for currency conversion",
"operationId": "forex-rates",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "base",
"in": "query",
"description": "Base currency. Default to EUR.",
"schema": {
"type": "string"
}
},
{
"name": "date",
"in": "query",
"description": "Date. Leave blank to get the latest data.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/Forexrates"
}
}
}
}
}
}
},
"/crypto/exchange": {
"get": {
"tags": [
"Default"
],
"summary": "Crypto Exchanges",
"description": "List supported crypto exchanges",
"operationId": "crypto-exchanges",
"security": [
{
"api_key": []
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
},
"/crypto/symbol": {
"get": {
"tags": [
"Default"
],
"summary": "Crypto Symbol",
"description": "List supported crypto symbols by exchange",
"operationId": "crypto-symbols",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "exchange",
"in": "query",
"description": "Exchange you want to get the list of symbols from.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CryptoSymbol"
}
}
}
}
}
}
}
},
"/crypto/profile": {
"get": {
"tags": [
"Default"
],
"summary": "Crypto Profile",
"description": "Get crypto's profile.",
"operationId": "crypto-profile",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Crypto symbol such as BTC or ETH.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/CryptoProfile"
}
}
}
}
}
}
},
"/crypto/candle": {
"get": {
"tags": [
"Default"
],
"summary": "Crypto Candles",
"description": "Get candlestick data for crypto symbols.",
"operationId": "crypto-candles",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Use symbol returned in <code>/crypto/symbol</code> endpoint for this field.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "UNIX timestamp. Interval initial value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "UNIX timestamp. Interval end value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/CryptoCandles"
}
}
}
}
}
}
},
"/scan/pattern": {
"get": {
"tags": [
"Default"
],
"summary": "Pattern Recognition",
"description": "Run pattern recognition algorithm on a symbol. Support double top/bottom, triple top/bottom, head and shoulders, triangle, wedge, channel, flag, and candlestick patterns.",
"operationId": "pattern-recognition",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/PatternRecognition"
}
}
}
}
}
}
},
"/scan/support-resistance": {
"get": {
"tags": [
"Default"
],
"summary": "Support/Resistance",
"description": "Get support and resistance levels for a symbol.",
"operationId": "support-resistance",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SupportResistance"
}
}
}
}
}
}
},
"/scan/technical-indicator": {
"get": {
"tags": [
"Default"
],
"summary": "Aggregate Indicators",
"description": "Get aggregate signal of multiple technical indicators such as MACD, RSI, Moving Average v.v. A full list of indicators can be found <a href=\"https://docs.google.com/spreadsheets/d/1MWuy0WuT2yVlxr1KbPdggVygMZtJfunDnhe-C0GEXYM/edit?usp=sharing\" target=\"_blank\">here</a>.",
"operationId": "aggregate-indicator",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "symbol",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/AggregateIndicators"
}
}
}
}
}
}
},
"/indicator": {
"get": {
"tags": [
"Default"
],
"summary": "Technical Indicators",
"description": "Return technical indicator with price data. List of supported indicators can be found <a href=\"https://docs.google.com/spreadsheets/d/1ylUvKHVYN2E87WdwIza8ROaCpd48ggEl1k5i5SgA29k/edit?usp=sharing\" target=\"_blank\">here</a>.",
"operationId": "technical-indicator",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "symbol",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "resolution",
"in": "query",
"description": "Supported resolution includes <code>1, 5, 15, 30, 60, D, W, M </code>.Some timeframes might not be available depending on the exchange.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "UNIX timestamp. Interval initial value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "UNIX timestamp. Interval end value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "indicator",
"in": "query",
"description": "Indicator name. Full list can be found <a href=\"https://docs.google.com/spreadsheets/d/1ylUvKHVYN2E87WdwIza8ROaCpd48ggEl1k5i5SgA29k/edit?usp=sharing\" target=\"_blank\">here</a>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/IndicatorFields"
}
}
}
},
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/TechnicalIndicator"
}
}
}
}
}
}
},
"/stock/transcripts/list": {
"get": {
"tags": [
"Default"
],
"summary": "Earnings Call Transcripts List",
"description": "List earnings call transcripts' metadata. This endpoint is available for US, UK, European, Australian and Canadian companies.",
"operationId": "transcripts-list",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol: AAPL. Leave empty to list the latest transcripts",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EarningsCallTranscriptsList"
}
}
}
}
}
}
},
"/stock/transcripts": {
"get": {
"tags": [
"Default"
],
"summary": "Earnings Call Transcripts",
"description": "<p>Get earnings call transcripts, audio and participants' list. Data is available for US, UK, European, Australian and Canadian companies.<p>15+ years of data is available with 220,000+ audio which add up to 7TB in size.</p>",
"operationId": "transcripts",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "id",
"in": "query",
"description": "Transcript's id obtained with <a href=\"#transcripts-list\">Transcripts List endpoint</a>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EarningsCallTranscripts"
}
}
}
}
}
}
},
"/stock/earnings-call-live": {
"get": {
"tags": [
"Default"
],
"summary": "Earnings Call Audio Live",
"description": "<p>Stream live earnings calls with data provided in the calendar. The data will be available in m3u8 format. mp3 files will be available once the calls finish in the <code>recording</code> field.</p>",
"operationId": "earnings-call-live",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "symbol",
"in": "query",
"description": "Filter by symbol: AAPL.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EarningsCallLive"
}
}
}
}
}
}
},
"/stock/presentation": {
"get": {
"tags": [
"Default"
],
"summary": "Company Presentation",
"description": "<p>Get presentations/slides data in PDF format that are usually used during earnings calls.</p>",
"operationId": "stock-presentation",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/StockPresentation"
}
}
}
}
}
}
},
"/stock/social-sentiment": {
"get": {
"tags": [
"Default"
],
"summary": "Social Sentiment",
"description": "<p>Get social sentiment for stocks on Reddit and Twitter.</p>",
"operationId": "social-sentiment",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SocialSentiment"
}
}
}
}
}
}
},
"/stock/investment-theme": {
"get": {
"tags": [
"Default"
],
"summary": "Investment Themes (Thematic Investing)",
"description": "<p>Thematic investing involves creating a portfolio (or portion of a portfolio) by gathering together a collection of companies involved in certain areas that you predict will generate above-market returns over the long term. Themes can be based on a concept such as ageing populations or a sub-sector such as robotics, and drones. Thematic investing focuses on predicted long-term trends rather than specific companies or sectors, enabling investors to access structural, one-off shifts that can change an entire industry.</p><p>This endpoint will help you get portfolios of different investment themes that are changing our life and are the way of the future.</p><p>A full list of themes supported can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1ULj9xDh4iPoQj279M084adZ2_S852ttRthKKJ7madYc/edit?usp=sharing\">here</a>. The theme coverage and portfolios are updated bi-weekly by our analysts. Our approach excludes penny, super-small cap and illiquid stocks.</p>",
"operationId": "investment-themes",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "theme",
"in": "query",
"description": "Investment theme. A full list of themes supported can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1ULj9xDh4iPoQj279M084adZ2_S852ttRthKKJ7madYc/edit?usp=sharing\">here</a>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InvestmentThemes"
}
}
}
}
}
}
},
"/stock/supply-chain": {
"get": {
"tags": [
"Default"
],
"summary": "Supply Chain Relationships",
"description": "<p>This endpoint provides an overall map of public companies' key customers and suppliers. The data offers a deeper look into a company's supply chain and how products are created. The data will help investors manage risk, limit exposure or generate alpha-generating ideas and trading insights.</p>",
"operationId": "supply-chain-relationships",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SupplyChainRelationships"
}
}
}
}
}
}
},
"/stock/esg": {
"get": {
"tags": [
"Default"
],
"summary": "Company ESG Scores",
"description": "<p>This endpoint provides the latest ESG scores and important indicators for 7000+ global companies. The data is collected through company's public ESG disclosure and public sources.</p><p>Our ESG scoring models takes into account more than 150 different inputs to calculate the level of ESG risks and how well a company is managing them. A higher score means lower ESG risk or better ESG management. ESG scores are in the the range of 0-100. Some key indicators might contain letter-grade score from C- to A+ with C- is the lowest score and A+ is the highest score.</p>",
"operationId": "company-esg-score",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/CompanyESG"
}
}
}
}
}
}
},
"/stock/historical-esg": {
"get": {
"tags": [
"Default"
],
"summary": "Historical ESG Scores",
"description": "<p>This endpoint provides historical ESG scores and important indicators for 7000+ global companies. The data is collected through company's public ESG disclosure and public sources.</p><p>Our ESG scoring models takes into account more than 150 different inputs to calculate the level of ESG risks and how well a company is managing them. A higher score means lower ESG risk or better ESG management. ESG scores are in the the range of 0-100. Some key indicators might contain letter-grade score from C- to A+ with C- is the lowest score and A+ is the highest score.</p>",
"operationId": "company-historical-esg-score",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/HistoricalCompanyESG"
}
}
}
}
}
}
},
"/stock/earnings-quality-score": {
"get": {
"tags": [
"Default"
],
"summary": "Company Earnings Quality Score",
"description": "<p>This endpoint provides Earnings Quality Score for global companies.</p><p> Earnings quality refers to the extent to which current earnings predict future earnings. \"High-quality\" earnings are expected to persist, while \"low-quality\" earnings do not. A higher score means a higher earnings quality</p><p>Finnhub uses a proprietary model which takes into consideration 4 criteria:</p> <ul style=\"list-style-type: unset; margin-left: 30px;\"><li>Profitability</li><li>Growth</li><li>Cash Generation & Capital Allocation</li><li>Leverage</li></ul><br/><p>We then compare the metrics of each company in each category against its peers in the same industry to gauge how quality its earnings is.</p>",
"operationId": "company-earnings-quality-score",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "freq",
"in": "query",
"description": "Frequency. Currently support <code>annual</code> and <code>quarterly</code>",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/CompanyEarningsQualityScore"
}
}
}
}
}
}
},
"/covid19/us": {
"get": {
"tags": [
"Default"
],
"summary": "COVID-19",
"description": "Get real-time updates on the number of COVID-19 (Corona virus) cases in the US with a state-by-state breakdown. Data is sourced from CDC and reputable sources. You can also access this API <a href=\"https://rapidapi.com/Finnhub/api/finnhub-real-time-covid-19\" target=\"_blank\" rel=\"nofollow\">here</a>",
"operationId": "covid-19",
"security": [
{
"api_key": []
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CovidInfo"
}
}
}
}
}
}
}
},
"/fda-advisory-committee-calendar": {
"get": {
"tags": [
"Default"
],
"summary": "FDA Committee Meeting Calendar",
"description": "FDA's advisory committees are established to provide functions which support the agency's mission of protecting and promoting the public health, while meeting the requirements set forth in the Federal Advisory Committee Act. Committees are either mandated by statute or established at the discretion of the Department of Health and Human Services. Each committee is subject to renewal at two-year intervals unless the committee charter states otherwise.",
"operationId": "fda-committee-meeting-calendar",
"security": [
{
"api_key": []
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FDAComitteeMeeting"
}
}
}
}
}
}
}
},
"/stock/uspto-patent": {
"get": {
"tags": [
"Default"
],
"summary": "USPTO Patents",
"description": "List USPTO patents for companies. Limit to 250 records per API call.",
"operationId": "stock-uspto-patent",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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": "object",
"$ref": "#/components/schemas/UsptoPatentResult"
}
}
}
}
}
}
},
"/stock/visa-application": {
"get": {
"tags": [
"Default"
],
"summary": "H1-B Visa Application",
"description": "Get a list of H1-B and Permanent visa applications for companies from the DOL. The data is updated quarterly.",
"operationId": "stock-visa-application",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>. Filter on the <code>beginDate</code> column.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>. Filter on the <code>beginDate</code> column.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/VisaApplicationResult"
}
}
}
}
}
}
},
"/stock/lobbying": {
"get": {
"tags": [
"Default"
],
"summary": "Senate Lobbying",
"description": "Get a list of reported lobbying activities in the Senate and the House.",
"operationId": "stock-lobbying",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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": "object",
"$ref": "#/components/schemas/LobbyingResult"
}
}
}
}
}
}
},
"/stock/usa-spending": {
"get": {
"tags": [
"Default"
],
"summary": "USA Spending",
"description": "<p>Get a list of government's spending activities from USASpending dataset for public companies. This dataset can help you identify companies that win big government contracts which is extremely important for industries such as Defense, Aerospace, and Education. Only recent data is available via the API.</p><p>For historical data, you can download it here: <a href=\"/api/v1/stock/usa-spending?fileId=before_2021&token=\" target=\"_blank\">Pre-2021</a>, <a href=\"/api/v1/stock/usa-spending?fileId=2021&token=\" target=\"_blank\">2021</a>, <a href=\"/api/v1/stock/usa-spending?fileId=2022&token=\" target=\"_blank\">2022</a>, <a href=\"/api/v1/stock/usa-spending?fileId=2023&token=\" target=\"_blank\">2023</a>, <a href=\"/api/v1/stock/usa-spending?fileId=2024&token=\" target=\"_blank\">2024</a></p>",
"operationId": "stock-usa-spending",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>. Filter for <code>actionDate</code>",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>. Filter for <code>actionDate</code>",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/UsaSpendingResult"
}
}
}
}
}
}
},
"/stock/congressional-trading": {
"get": {
"tags": [
"Default"
],
"summary": "Congressional Trading",
"description": "Get stock trades data disclosed by members of congress.",
"operationId": "congressional-trading",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol of the company: AAPL.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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": "object",
"$ref": "#/components/schemas/CongressionalTrading"
}
}
}
}
}
}
},
"/bond/profile": {
"get": {
"tags": [
"Default"
],
"summary": "Bond Profile",
"description": "Get general information of a bond. You can query by FIGI, ISIN or CUSIP. A list of supported bonds can be found <a href=\"/api/v1/bond/list?type=csv&token=\" target=\"_blank\">here</a>.",
"operationId": "bond-profile",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "isin",
"in": "query",
"description": "ISIN",
"schema": {
"type": "string"
}
},
{
"name": "cusip",
"in": "query",
"description": "CUSIP",
"schema": {
"type": "string"
}
},
{
"name": "figi",
"in": "query",
"description": "FIGI",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/BondProfile"
}
}
}
}
}
}
},
"/bond/price": {
"get": {
"tags": [
"Default"
],
"summary": "Bond price data",
"description": "<p>Get bond's price data. The following datasets are supported:</p><table class=\"table table-hover\">\n <thead>\n <tr>\n <th>Exchange</th>\n <th>Segment</th>\n <th>Delay</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"text-blue\">US Government Bonds</th>\n <td>Government Bonds</td>\n <td>End-of-day</td>\n </tr>\n <tr>\n <td class=\"text-blue\">FINRA Trace</th>\n <td>BTDS: US Corporate Bonds</td>\n <td>Delayed 4h</td>\n </tr>\n <tr>\n <td class=\"text-blue\">FINRA Trace</th>\n <td>144A Bonds</td>\n <td>Delayed 4h</td>\n </tr>\n </tbody>\n</table>",
"operationId": "bond-price",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "isin",
"in": "query",
"description": "ISIN.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "UNIX timestamp. Interval initial value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "to",
"in": "query",
"description": "UNIX timestamp. Interval end value.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/BondCandles"
}
}
}
}
}
}
},
"/bond/tick": {
"get": {
"tags": [
"Default"
],
"summary": "Bond Tick Data",
"description": "<p>Get trade-level data for bonds. The following datasets are supported:</p><table class=\"table table-hover\">\n <thead>\n <tr>\n <th>Exchange</th>\n <th>Segment</th>\n <th>Delay</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"text-blue\">FINRA Trace</th>\n <td>BTDS: US Corporate Bonds</td>\n <td>Delayed 4h</td>\n </tr>\n <tr>\n <td class=\"text-blue\">FINRA Trace</th>\n <td>144A Bonds</td>\n <td>Delayed 4h</td>\n </tr>\n </tbody>\n</table>",
"operationId": "bond-tick",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "isin",
"in": "query",
"description": "ISIN.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "date",
"in": "query",
"description": "Date: 2020-04-02.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "limit",
"in": "query",
"description": "Limit number of ticks returned. Maximum value: <code>25000</code>",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "skip",
"in": "query",
"description": "Number of ticks to skip. Use this parameter to loop through the entire data.",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "exchange",
"in": "query",
"description": "Currently support the following values: <code>trace</code>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/BondTickData"
}
}
}
}
}
}
},
"/bond/yield-curve": {
"get": {
"tags": [
"Default"
],
"summary": "Bond Yield Curve",
"description": "Get yield curve data for Treasury bonds.",
"operationId": "bond-yield-curve",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "code",
"in": "query",
"description": "Bond's code. You can find the list of supported code <a href=\"https://docs.google.com/spreadsheets/d/1iA-lM0Kht7lsQZ7Uu_s6r2i1BbQNUNO9eGkO5-zglHg/edit?usp=sharing\" target=\"_blank\" rel=\"noopener\">here</a>.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/BondYieldCurve"
}
}
}
}
}
}
},
"/bank-branch": {
"get": {
"tags": [
"Default"
],
"summary": "Bank Branch List",
"description": "Retrieve list of US bank branches information for a given symbol.",
"operationId": "bank-branch",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/BankBranchRes"
}
}
}
}
}
}
},
"/airline/price-index": {
"get": {
"tags": [
"Default"
],
"summary": "Airline Price Index",
"description": "<p>The Flight Ticket Price Index API provides comprehensive data on airline ticket prices, including the average daily ticket price and its percentage change (price index). This data, collected weekly and projected two weeks ahead, aggregates daily prices and indexes from the 50 busiest and largest airports across the USA. The dataset includes detailed information on airlines, dates, and average ticket prices, offering valuable insights for market analysis and pricing strategies.</p><p>The price index is calculated as percentage change of average daily ticket price from the previous weekly reading. Raw ticket prices data is available for Enterprise users. <a href=\"mailto:support@finnhub.io\">Contact us</a> to inquire about the raw price data.</p>",
"operationId": "airline-price-index",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "airline",
"in": "query",
"description": "Filter data by airline. Accepted values: <code>united</code>,<code>delta</code>,<code>american_airlines</code>,<code>southwest</code>,<code>southern_airways_express</code>,<code>alaska_airlines</code>,<code>frontier_airlines</code>,<code>jetblue_airways</code>,<code>spirit_airlines</code>,<code>sun_country_airlines</code>,<code>breeze_airways</code>,<code>hawaiian_airlines</code>",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"required": true,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"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": "object",
"$ref": "#/components/schemas/AirlinePriceIndexData"
}
}
}
}
}
}
},
"/country": {
"get": {
"tags": [
"Default"
],
"summary": "Country Metadata",
"description": "List all countries and metadata.",
"operationId": "country",
"security": [
{
"api_key": []
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CountryMetadata"
}
}
}
}
}
}
}
},
"/calendar/economic": {
"get": {
"tags": [
"Default"
],
"summary": "Economic Calendar",
"description": "<p>Get recent and upcoming economic releases.</p><p>Historical events and surprises are available for Enterprise clients.</p>",
"operationId": "economic-calendar",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "from",
"in": "query",
"description": "From date <code>YYYY-MM-DD</code>.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date <code>YYYY-MM-DD</code>.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EconomicCalendar"
}
}
}
}
}
}
},
"/economic/code": {
"get": {
"tags": [
"Default"
],
"summary": "Economic Code",
"description": "List codes of supported economic data.",
"operationId": "economic-code",
"security": [
{
"api_key": []
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EconomicCode"
}
}
}
}
}
}
}
},
"/economic": {
"get": {
"tags": [
"Default"
],
"summary": "Economic Data",
"description": "Get economic data.",
"operationId": "economic-data",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "code",
"in": "query",
"description": "Economic code.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/EconomicData"
}
}
}
}
}
}
},
"/stock/international-filings": {
"get": {
"tags": [
"Default"
],
"summary": "International Filings",
"description": "List filings for international companies. Limit to 500 documents at a time. These are the documents we use to source our fundamental data. Enterprise clients who need access to the full filings for global markets should contact us for the access.",
"operationId": "international-filings",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol. Leave empty to list latest filings.",
"schema": {
"type": "string"
}
},
{
"name": "country",
"in": "query",
"description": "Filter by country using country's 2-letter code.",
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From date: 2023-01-15.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To date: 2023-12-16.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InternationalFiling"
}
}
}
}
}
}
}
},
"/stock/revenue-breakdown2": {
"get": {
"tags": [
"Default"
],
"summary": "Revenue Breakdown & KPI",
"description": "<p>Get standardized revenue breakdown and KPIs data for 30,000+ global companies.</p>",
"operationId": "revenue-breakdown2",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Symbol.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/RevenueBreakdown2"
}
}
}
}
}
}
},
"/stock/newsroom": {
"get": {
"tags": [
"Default"
],
"summary": "Newsroom",
"description": "<p>Get latest articles posted directly on the companies' newsroom and investor relations page. Newsroom API along with the Press Releases API provide a comprehensive text-based dataset directly from the company. We currently cover 1,250 US Companies with this dataset.</p>",
"operationId": "newsroom",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "symbol",
"in": "query",
"description": "Company symbol.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "from",
"in": "query",
"description": "From time: 2025-01-01.",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"description": "To time: 2026-01-05.",
"schema": {
"type": "string",
"format": "date"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/Newsroom"
}
}
}
}
}
}
},
"/ai-chat": {
"post": {
"tags": [
"Default"
],
"summary": "AI Copilot",
"description": "<p>Chat with our AI copilot trained on the extensive Finnhub's global data. You can ask it any finance-related questions just like with other LLM models and receive results in texts and widgets.</p>",
"operationId": "ai-chat",
"security": [
{
"api_key": []
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AIChatBody"
}
}
}
},
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/AIChatResponse"
}
}
}
}
}
}
},
"/global-filings/search": {
"post": {
"tags": [
"Default"
],
"summary": "Global Filings Search",
"description": "<p>Search for best-matched filings across global companies' filings, transcripts and press releases. You can filter by anything from symbol, ISIN to form type, and document sources.</p><p>This endpoint will return a list of documents that match your search criteria. If you would like to get the excerpts as well, please set <code>highlighted</code> to <code>true</code>. Once you have the list of documents, you can get a list of excerpts and positions to highlight the document using the <code>/search-in-filing</code> endpoint</p>",
"operationId": "global-filings-search",
"security": [
{
"api_key": []
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchBody"
}
}
}
},
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SearchResponse"
}
}
}
}
}
}
},
"/global-filings/search-in-filing": {
"post": {
"tags": [
"Default"
],
"summary": "Search In Filing",
"description": "<p>Get a list of excerpts and highlight positions within a document using your query.</p>",
"operationId": "search-in-filing",
"security": [
{
"api_key": []
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InFilingSearchBody"
}
}
}
},
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/InFilingResponse"
}
}
}
}
}
}
},
"/global-filings/filter": {
"get": {
"tags": [
"Default"
],
"summary": "Search Filter",
"description": "<p>Get available values for each filter in search body.</p>",
"operationId": "global-filings-search-filter",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "field",
"in": "query",
"description": "Field to get available filters. Available filters are \"countries\", \"exchanges\", \"exhibits\", \"forms\", \"gics\", \"naics\", \"caps\", \"acts\", and \"sort\".",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "source",
"in": "query",
"description": "Get available forms for each source.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"$ref": "#/components/schemas/SearchFilter"
}
}
}
}
}
}
},
"/global-filings/download": {
"get": {
"tags": [
"Default"
],
"summary": "Download Filings",
"description": "<p>Download filings using document ids.</p>",
"operationId": "global-filings-download",
"security": [
{
"api_key": []
}
],
"parameters": [
{
"name": "documentId",
"in": "query",
"description": "Document's id. Note that this is different from filingId as 1 filing can contain multiple documents.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response"
}
}
}
}
},
"components": {
"schemas": {
"SearchBody": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"description": "Search query",
"type": "string"
},
"isins": {
"description": "List of isin to search, comma separated (Max: 50).",
"type": "string"
},
"cusips": {
"description": "List of cusip to search, comma separated (Max: 50).",
"type": "string"
},
"ciks": {
"description": "List of SEC Center Index Key to search, comma separated (Max: 50).",
"type": "string"
},
"sedarIds": {
"description": "List of SEDAR issuer number to search, comma separated (Max: 50).",
"type": "string"
},
"chIds": {
"description": "List of Companies House number to search, comma separated (Max: 50).",
"type": "string"
},
"symbols": {
"description": "List of symbols to search, comma separated (Max: 50).",
"type": "string"
},
"sedols": {
"description": "List of sedols to search, comma separated (Max: 50).",
"type": "string"
},
"sources": {
"description": "List of sources to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"forms": {
"description": "List of forms to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"gics": {
"description": "List of gics to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"naics": {
"description": "List of sources to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"exhibits": {
"description": "List of exhibits to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"exchanges": {
"description": "List of exchanges to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"countries": {
"description": "List of sources to search, comma separated (Max: 50). Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"acts": {
"description": "List of SEC's exchanges act to search, comma separated. Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"caps": {
"description": "List of market capitalization to search, comma separated. Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"fromDate": {
"description": "Search from date in format: YYYY-MM-DD, default from the last 2 years",
"type": "string"
},
"toDate": {
"description": "Search to date in format: YYYY-MM-DD, default to today",
"type": "string"
},
"page": {
"description": "Use for pagination, default to page 1",
"type": "string"
},
"sort": {
"description": "Sort result by, default: sortMostRecent. Look at <code>/filter</code> endpoint to see all available values.",
"type": "string"
},
"highlighted": {
"description": "Enable highlight in returned filings. If enabled, only return 10 results each time",
"type": "boolean"
}
}
},
"AIChatBody": {
"type": "object",
"required": [
"messages"
],
"properties": {
"messages": {
"description": "Messages",
"type": "array",
"items": {
"$ref": "#/components/schemas/AIChatMessage"
}
},
"stream": {
"description": "Stream responses",
"type": "boolean"
}
}
},
"AIChatMessage": {
"type": "object",
"properties": {
"role": {
"description": "Role system/user",
"type": "string"
},
"content": {
"description": "Content",
"type": "string"
}
}
},
"AIChatResponse": {
"type": "object",
"properties": {
"chatId": {
"description": "Chat ID.",
"type": "string"
},
"content": {
"description": "Response text.",
"type": "string"
},
"querySummary": {
"description": "Query summary",
"type": "string"
},
"relatedQueries": {
"description": "Related queries.",
"type": "array",
"items": {
"type": "object"
}
},
"tickers": {
"description": "List of tickers mentioned.",
"type": "array",
"items": {
"type": "object"
}
},
"sources": {
"description": "Sources.",
"type": "array",
"items": {
"type": "object"
}
},
"widgets": {
"description": "Widgets.",
"type": "array",
"items": {
"type": "object"
}
}
}
},
"InFilingSearchBody": {
"type": "object",
"required": [
"query",
"filingId"
],
"properties": {
"query": {
"description": "Search query",
"type": "string"
},
"filingId": {
"description": "Filing Id to search",
"type": "string"
}
}
},
"SearchResponse": {
"type": "object",
"properties": {
"count": {
"description": "Total filing matched your search criteria.",
"type": "integer"
},
"took": {
"description": "Time took to execute your search query on our server, value in ms.",
"type": "integer"
},
"page": {
"description": "Current search page",
"type": "integer"
},
"filings": {
"description": "Filing match your search criteria.",
"type": "array",
"items": {
"$ref": "#/components/schemas/FilingResponse"
}
}
}
},
"FilingResponse": {
"type": "object",
"properties": {
"filingId": {
"description": "Filing Id in Alpharesearch platform",
"type": "string"
},
"title": {
"description": "Filing title",
"type": "string"
},
"filerId": {
"description": "Id of the entity submitted the filing",
"type": "string"
},
"symbol": {
"description": "List of symbol associate with this filing"
},
"name": {
"description": "Filer name",
"type": "string"
},
"acceptanceDate": {
"description": "Date the filing is submitted.",
"type": "string"
},
"filedDate": {
"description": "Date the filing is made available to the public",
"type": "string"
},
"reportDate": {
"description": "Date as which the filing is reported",
"type": "string"
},
"form": {
"description": "Filing Form",
"type": "string"
},
"amend": {
"description": "Amendment",
"type": "boolean"
},
"source": {
"description": "Filing Source",
"type": "string"
},
"pageCount": {
"description": "Estimate number of page when printing",
"type": "integer"
},
"documentCount": {
"description": "Number of document in this filing",
"type": "integer"
}
}
},
"InFilingResponse": {
"type": "object",
"properties": {
"filingId": {
"description": "Filing Id in Alpharesearch platform",
"type": "string"
},
"title": {
"description": "Filing title",
"type": "string"
},
"filerId": {
"description": "Id of the entity submitted the filing",
"type": "string"
},
"symbol": {
"description": "List of symbol associate with this filing"
},
"name": {
"description": "Filer name",
"type": "string"
},
"acceptanceDate": {
"description": "Date the filing is submitted.",
"type": "string"
},
"filedDate": {
"description": "Date the filing is make available to the public",
"type": "string"
},
"reportDate": {
"description": "Date as which the filing is reported",
"type": "string"
},
"form": {
"description": "Filing Form",
"type": "string"
},
"amend": {
"description": "Amendment",
"type": "boolean"
},
"source": {
"description": "Filing Source",
"type": "string"
},
"pageCount": {
"description": "Estimate number of page when printing",
"type": "integer"
},
"documentCount": {
"description": "Number of document in this filing",
"type": "integer"
},
"documents": {
"description": "Document for this filing.",
"type": "array",
"items": {
"$ref": "#/components/schemas/DocumentResponse"
}
}
}
},
"DocumentResponse": {
"type": "object",
"properties": {
"documentId": {
"description": "AlphaResearch internal document id.",
"type": "string"
},
"title": {
"description": "Title for this document.",
"type": "string"
},
"hits": {
"description": "Number of hit in this document",
"type": "string"
},
"url": {
"description": "Link to render this document",
"type": "string"
},
"format": {
"description": "Format of this document (can be html or pdf)",
"type": "string"
},
"excerpts": {
"description": "Highlighted excerpts for this document",
"type": "array",
"items": {
"$ref": "#/components/schemas/ExcerptResponse"
}
}
}
},
"ExcerptResponse": {
"type": "object",
"properties": {
"content": {
"description": "Highlighted content",
"type": "string"
},
"snippetId": {
"description": "Location of the content in the rendered document",
"type": "string"
},
"startOffset": {
"description": "Start offset of highlighted content",
"type": "string"
},
"endOffset": {
"description": "End offset of highlighted content",
"type": "string"
}
}
},
"SearchFilter": {
"type": "object",
"properties": {
"id": {
"description": "Filter id, use with respective field in search query body.",
"type": "string"
},
"name": {
"description": "Display name.",
"type": "string"
}
}
},
"StockSymbol": {
"type": "object",
"properties": {
"description": {
"description": "Symbol description",
"type": "string"
},
"displaySymbol": {
"description": "Display symbol name.",
"type": "string"
},
"symbol": {
"description": "Unique symbol used to identify this symbol used in <code>/stock/candle</code> endpoint.",
"type": "string"
},
"type": {
"description": "Security type.",
"type": "string"
},
"mic": {
"description": "Primary exchange's MIC.",
"type": "string"
},
"figi": {
"description": "FIGI identifier.",
"type": "string"
},
"shareClassFIGI": {
"description": "Global Share Class FIGI.",
"type": "string"
},
"currency": {
"description": "Price's currency. This might be different from the reporting currency of fundamental data.",
"type": "string"
},
"symbol2": {
"description": "Alternative ticker for exchanges with multiple tickers for 1 stock such as BSE.",
"type": "string"
},
"isin": {
"description": "ISIN. This field is only available for EU stocks and selected Asian markets. Entitlement from Finnhub is required to access this field.",
"type": "string"
}
}
},
"SymbolLookup": {
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SymbolLookupInfo"
},
"description": "Array of search results."
},
"count": {
"description": "Number of results.",
"type": "integer",
"format": "int64"
}
}
},
"SymbolLookupInfo": {
"type": "object",
"properties": {
"description": {
"description": "Symbol description",
"type": "string"
},
"displaySymbol": {
"description": "Display symbol name.",
"type": "string"
},
"symbol": {
"description": "Unique symbol used to identify this symbol used in <code>/stock/candle</code> endpoint.",
"type": "string"
},
"type": {
"description": "Security type.",
"type": "string"
}
}
},
"InstitutionalPortfolio": {
"type": "object",
"properties": {
"name": {
"description": "Investor's name.",
"type": "string"
},
"cik": {
"description": "CIK.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InstitutionalPortfolioGroup"
},
"description": "Array of positions."
}
}
},
"MarketStatus": {
"type": "object",
"properties": {
"exchange": {
"description": "Exchange.",
"type": "string"
},
"timezone": {
"description": "Timezone.",
"type": "string"
},
"session": {
"description": "Market session. Can be 1 of the following values: <code>pre-market</code>,<code>regular</code>,<code>post-market</code> or <code>null</code> if the market is closed.",
"type": "string"
},
"holiday": {
"description": "Holiday event.",
"type": "string"
},
"isOpen": {
"description": "Whether the market is open at the moment.",
"type": "boolean"
},
"t": {
"description": "Current timestamp.",
"type": "integer",
"format": "int64"
}
}
},
"MarketHolidayData": {
"type": "object",
"properties": {
"eventName": {
"description": "Holiday's name.",
"type": "string"
},
"atDate": {
"description": "Date.",
"type": "string"
},
"tradingHour": {
"description": "Trading hours for this day if the market is partially closed only.",
"type": "string"
}
}
},
"MarketHoliday": {
"type": "object",
"properties": {
"timezone": {
"description": "Timezone.",
"type": "string"
},
"exchange": {
"description": "Exchange.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MarketHolidayData"
},
"description": "Array of holidays."
}
}
},
"CompanyProfile": {
"type": "object",
"properties": {
"alias": {
"description": "Company name alias.",
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"description": "Address of company's headquarter.",
"type": "string"
},
"city": {
"description": "City of company's headquarter.",
"type": "string"
},
"country": {
"description": "Country of company's headquarter.",
"type": "string"
},
"currency": {
"description": "Currency used in company filings and financials.",
"type": "string"
},
"estimateCurrency": {
"description": "Currency used in Estimates data.",
"type": "string"
},
"marketCapCurrency": {
"description": "Currency used in market capitalization.",
"type": "string"
},
"cusip": {
"description": "CUSIP number.",
"type": "string"
},
"sedol": {
"description": "Sedol number.",
"type": "string"
},
"description": {
"description": "Company business summary.",
"type": "string"
},
"exchange": {
"description": "Listed exchange.",
"type": "string"
},
"ggroup": {
"description": "Industry group.",
"type": "string"
},
"gind": {
"description": "Industry.",
"type": "string"
},
"gsector": {
"description": "Sector.",
"type": "string"
},
"gsubind": {
"description": "Sub-industry.",
"type": "string"
},
"isin": {
"description": "ISIN number.",
"type": "string"
},
"lei": {
"description": "LEI number.",
"type": "string"
},
"irUrl": {
"description": "Investor relations website.",
"type": "string"
},
"naicsNationalIndustry": {
"description": "NAICS national industry.",
"type": "string"
},
"naics": {
"description": "NAICS industry.",
"type": "string"
},
"naicsSector": {
"description": "NAICS sector.",
"type": "string"
},
"naicsSubsector": {
"description": "NAICS subsector.",
"type": "string"
},
"name": {
"description": "Company name.",
"type": "string"
},
"phone": {
"description": "Company phone number.",
"type": "string"
},
"state": {
"description": "State of company's headquarter.",
"type": "string"
},
"ticker": {
"description": "Company symbol/ticker as used on the listed exchange.",
"type": "string"
},
"weburl": {
"description": "Company website.",
"type": "string"
},
"ipo": {
"description": "IPO date.",
"type": "string",
"format": "date"
},
"marketCapitalization": {
"description": "Market Capitalization.",
"type": "number",
"format": "float"
},
"shareOutstanding": {
"description": "Number of oustanding shares.",
"type": "number",
"format": "float"
},
"employeeTotal": {
"description": "Number of employee.",
"type": "number",
"format": "float"
},
"logo": {
"description": "Logo image.",
"type": "string"
},
"finnhubIndustry": {
"description": "Finnhub industry classification.",
"type": "string"
}
}
},
"CompanyProfile2": {
"type": "object",
"properties": {
"country": {
"description": "Country of company's headquarter.",
"type": "string"
},
"currency": {
"description": "Currency used in company filings.",
"type": "string"
},
"exchange": {
"description": "Listed exchange.",
"type": "string"
},
"name": {
"description": "Company name.",
"type": "string"
},
"ticker": {
"description": "Company symbol/ticker as used on the listed exchange.",
"type": "string"
},
"ipo": {
"description": "IPO date.",
"type": "string",
"format": "date"
},
"marketCapitalization": {
"description": "Market Capitalization.",
"type": "number",
"format": "float"
},
"shareOutstanding": {
"description": "Number of oustanding shares.",
"type": "number",
"format": "float"
},
"logo": {
"description": "Logo image.",
"type": "string"
},
"phone": {
"description": "Company phone number.",
"type": "string"
},
"weburl": {
"description": "Company website.",
"type": "string"
},
"finnhubIndustry": {
"description": "Finnhub industry classification.",
"type": "string"
}
}
},
"Company": {
"type": "object",
"properties": {
"name": {
"description": "Executive name",
"type": "string"
},
"age": {
"description": "Age",
"type": "integer",
"format": "int64"
},
"title": {
"description": "Title",
"type": "string"
},
"since": {
"description": "Year first appointed as executive/director of the company",
"type": "string"
},
"sex": {
"description": "Sex",
"type": "string"
},
"compensation": {
"description": "Total compensation",
"type": "integer",
"format": "int64"
},
"currency": {
"description": "Compensation currency",
"type": "string"
}
}
},
"CompanyExecutive": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"executive": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Company"
},
"description": "Array of company's executives and members of the Board."
}
}
},
"MarketNews": {
"type": "object",
"properties": {
"category": {
"description": "News category.",
"type": "string"
},
"datetime": {
"description": "Published time in UNIX timestamp.",
"type": "integer",
"format": "int64"
},
"headline": {
"description": "News headline.",
"type": "string"
},
"id": {
"description": "News ID. This value can be used for <code>minId</code> params to get the latest news only.",
"type": "integer",
"format": "int64"
},
"image": {
"description": "Thumbnail image URL.",
"type": "string"
},
"related": {
"description": "Related stocks and companies mentioned in the article.",
"type": "string"
},
"source": {
"description": "News source.",
"type": "string"
},
"summary": {
"description": "News summary.",
"type": "string"
},
"url": {
"description": "URL of the original article.",
"type": "string"
}
}
},
"CompanyNews": {
"type": "object",
"properties": {
"category": {
"description": "News category.",
"type": "string"
},
"datetime": {
"description": "Published time in UNIX timestamp.",
"type": "integer",
"format": "int64"
},
"headline": {
"description": "News headline.",
"type": "string"
},
"id": {
"description": "News ID. This value can be used for <code>minId</code> params to get the latest news only.",
"type": "integer",
"format": "int64"
},
"image": {
"description": "Thumbnail image URL.",
"type": "string"
},
"related": {
"description": "Related stocks and companies mentioned in the article.",
"type": "string"
},
"source": {
"description": "News source.",
"type": "string"
},
"summary": {
"description": "News summary.",
"type": "string"
},
"url": {
"description": "URL of the original article.",
"type": "string"
}
}
},
"Development": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"datetime": {
"description": "Published time in <code>YYYY-MM-DD HH:MM:SS</code> format.",
"type": "string",
"formatIgnore": "date-time"
},
"headline": {
"description": "Development headline.",
"type": "string"
},
"description": {
"description": "Development description.",
"type": "string"
},
"url": {
"description": "URL.",
"type": "string"
}
}
},
"PressRelease": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"majorDevelopment": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Development"
},
"description": "Array of major developments."
}
}
},
"NewsroomArticle": {
"type": "object",
"properties": {
"atDate": {
"description": "Published time in <code>YYYY-MM-DD HH:MM:SS</code> format (EST timezone).",
"type": "string",
"formatIgnore": "date-time"
},
"title": {
"description": "Title.",
"type": "string"
},
"fullText": {
"description": "URL to download the full text data.",
"type": "string"
},
"url": {
"description": "Original URL.",
"type": "string"
}
}
},
"Newsroom": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/NewsroomArticle"
},
"description": "Array of articles."
}
}
},
"CompanyNewsStatistics": {
"type": "object",
"properties": {
"articlesInLastWeek": {
"description": "",
"type": "integer",
"format": "int64"
},
"buzz": {
"description": "",
"type": "number",
"format": "float"
},
"weeklyAverage": {
"description": "",
"type": "number",
"format": "float"
}
}
},
"Sentiment": {
"type": "object",
"properties": {
"bearishPercent": {
"description": "",
"type": "number",
"format": "float"
},
"bullishPercent": {
"description": "",
"type": "number",
"format": "float"
}
}
},
"NewsSentiment": {
"type": "object",
"properties": {
"buzz": {
"type": "object",
"$ref": "#/components/schemas/CompanyNewsStatistics",
"description": "Statistics of company news in the past week."
},
"companyNewsScore": {
"description": "News score.",
"type": "number",
"format": "float"
},
"sectorAverageBullishPercent": {
"description": "Sector average bullish percent.",
"type": "number",
"format": "float"
},
"sectorAverageNewsScore": {
"description": "Sectore average score.",
"type": "number",
"format": "float"
},
"sentiment": {
"type": "object",
"$ref": "#/components/schemas/Sentiment",
"description": "News sentiment."
},
"symbol": {
"description": "Requested symbol.",
"type": "string"
}
}
},
"MetricSeriesMap": {
"type": "object"
},
"MetricMap": {
"type": "object"
},
"PriceMetricMap": {
"type": "object"
},
"BasicFinancials": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"metricType": {
"description": "Metric type.",
"type": "string"
},
"series": {
"type": "object",
"$ref": "#/components/schemas/MetricSeriesMap",
"description": "Map key-value pair of time-series ratios."
},
"metric": {
"type": "object",
"$ref": "#/components/schemas/MetricMap",
"description": "Map key-value pair of key ratios and metrics."
}
}
},
"PriceMetrics": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"atDate": {
"description": "Data date.",
"type": "string"
},
"data": {
"type": "object",
"$ref": "#/components/schemas/PriceMetricMap",
"description": "Map key-value pair of key ratios and metrics."
}
}
},
"CongressionalTransaction": {
"type": "object",
"properties": {
"amountFrom": {
"description": "Transaction amount from.",
"type": "number",
"format": "float"
},
"amountTo": {
"description": "Transaction amount to.",
"type": "number",
"format": "float"
},
"assetName": {
"description": "Asset name.",
"type": "string"
},
"filingDate": {
"description": "Filing date.",
"type": "string"
},
"name": {
"description": "Name of the representative.",
"type": "string"
},
"ownerType": {
"description": "Owner Type.",
"type": "string"
},
"position": {
"description": "Position.",
"type": "string"
},
"symbol": {
"description": "Symbol.",
"type": "string"
},
"transactionDate": {
"description": "Transaction date.",
"type": "string"
},
"transactionType": {
"description": "Transaction type <code>Sale</code> or <code>Purchase</code>.",
"type": "string"
}
}
},
"CongressionalTrading": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CongressionalTransaction"
},
"description": "Array of stock trades."
}
}
},
"IsinChangeInfo": {
"type": "object",
"properties": {
"atDate": {
"description": "Event's date.",
"type": "string"
},
"oldIsin": {
"description": "Old ISIN.",
"type": "string"
},
"newIsin": {
"description": "New ISIN.",
"type": "string"
}
}
},
"IsinChange": {
"type": "object",
"properties": {
"fromDate": {
"description": "From date.",
"type": "string"
},
"toDate": {
"description": "To date.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/IsinChangeInfo"
},
"description": "Array of ISIN change events."
}
}
},
"SymbolChangeInfo": {
"type": "object",
"properties": {
"atDate": {
"description": "Event's date.",
"type": "string"
},
"oldSymbol": {
"description": "Old symbol.",
"type": "string"
},
"newSymbol": {
"description": "New symbol.",
"type": "string"
}
}
},
"SymbolChange": {
"type": "object",
"properties": {
"fromDate": {
"description": "From date.",
"type": "string"
},
"toDate": {
"description": "To date.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SymbolChangeInfo"
},
"description": "Array of symbol change events."
}
}
},
"InstitutionalPortfolioInfo": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"cusip": {
"description": "CUSIP.",
"type": "string"
},
"name": {
"description": "Position's name.",
"type": "string"
},
"putCall": {
"description": "<code>put</code> or <code>call</code> for options.",
"type": "string"
},
"change": {
"description": "Number of shares change.",
"type": "number",
"format": "float"
},
"noVoting": {
"description": "Number of shares with no voting rights.",
"type": "number",
"format": "float"
},
"percentage": {
"description": "Percentage of portfolio.",
"type": "number",
"format": "float"
},
"share": {
"description": "Number of shares.",
"type": "number",
"format": "float"
},
"sharedVoting": {
"description": "Number of shares with shared voting rights.",
"type": "number",
"format": "float"
},
"soleVoting": {
"description": "Number of shares with sole voting rights.",
"type": "number",
"format": "float"
},
"value": {
"description": "Position value.",
"type": "number",
"format": "float"
}
}
},
"InstitutionalPortfolioGroup": {
"type": "object",
"properties": {
"reportDate": {
"description": "Report date.",
"type": "string"
},
"filingDate": {
"description": "Filing date.",
"type": "string"
},
"portfolio": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InstitutionalPortfolioInfo"
},
"description": "Array of positions."
}
}
},
"InstitutionalOwnershipInfo": {
"type": "object",
"properties": {
"cik": {
"description": "Investor's company CIK.",
"type": "string"
},
"name": {
"description": "Firm's name.",
"type": "string"
},
"putCall": {
"description": "<code>put</code> or <code>call</code> for options.",
"type": "string"
},
"change": {
"description": "Number of shares change.",
"type": "number",
"format": "float"
},
"noVoting": {
"description": "Number of shares with no voting rights.",
"type": "number",
"format": "float"
},
"percentage": {
"description": "Percentage of portfolio.",
"type": "number",
"format": "float"
},
"share": {
"description": "News score.",
"type": "number",
"format": "float"
},
"sharedVoting": {
"description": "Number of shares with shared voting rights.",
"type": "number",
"format": "float"
},
"soleVoting": {
"description": "Number of shares with sole voting rights.",
"type": "number",
"format": "float"
},
"value": {
"description": "Position value.",
"type": "number",
"format": "float"
}
}
},
"InstitutionalOwnershipGroup": {
"type": "object",
"properties": {
"reportDate": {
"description": "Report date.",
"type": "string"
},
"ownership": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InstitutionalOwnershipInfo"
},
"description": "Array of institutional investors."
}
}
},
"InstitutionalOwnership": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"cusip": {
"description": "Cusip.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InstitutionalOwnershipGroup"
},
"description": "Array of institutional investors."
}
}
},
"InstitutionalProfileInfo": {
"type": "object",
"properties": {
"cik": {
"description": "Investor's company CIK.",
"type": "string"
},
"firmType": {
"description": "Firm type.",
"type": "string"
},
"manager": {
"description": "Manager.",
"type": "string"
},
"philosophy": {
"description": "Investing philosophy.",
"type": "string"
},
"profile": {
"description": "Profile info.",
"type": "string"
},
"profileImg": {
"description": "Profile image.",
"type": "string"
}
}
},
"InstitutionalProfile": {
"type": "object",
"properties": {
"cik": {
"description": "CIK.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InstitutionalProfileInfo"
},
"description": "Array of investors."
}
}
},
"OwnershipInfo": {
"type": "object",
"properties": {
"name": {
"description": "Investor's name.",
"type": "string"
},
"share": {
"description": "Number of shares held by the investor.",
"type": "integer",
"format": "int64"
},
"change": {
"description": "Number of share changed (net buy or sell) from the last period.",
"type": "integer",
"format": "int64"
},
"filingDate": {
"description": "Filing date.",
"type": "string",
"format": "date"
}
}
},
"Ownership": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"ownership": {
"type": "array",
"items": {
"$ref": "#/components/schemas/OwnershipInfo"
},
"description": "Array of investors with detailed information about their holdings."
}
}
},
"FundOwnershipInfo": {
"type": "object",
"properties": {
"name": {
"description": "Investor's name.",
"type": "string"
},
"share": {
"description": "Number of shares held by the investor.",
"type": "integer",
"format": "int64"
},
"change": {
"description": "Number of share changed (net buy or sell) from the last period.",
"type": "integer",
"format": "int64"
},
"filingDate": {
"description": "Filing date.",
"type": "string",
"format": "date"
},
"portfolioPercent": {
"description": "Percent of the fund's portfolio comprised of the company's share.",
"type": "number",
"format": "float"
}
}
},
"FundOwnership": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"ownership": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FundOwnershipInfo"
},
"description": "Array of investors with detailed information about their holdings."
}
}
},
"Transactions": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"name": {
"description": "Insider's name.",
"type": "string"
},
"share": {
"description": "Number of shares held after the transaction.",
"type": "integer",
"format": "int64"
},
"change": {
"description": "Number of share changed from the last period. A positive value suggests a <code>BUY</code> transaction. A negative value suggests a <code>SELL</code> transaction.",
"type": "integer",
"format": "int64"
},
"filingDate": {
"description": "Filing date.",
"type": "string",
"format": "date"
},
"transactionDate": {
"description": "Transaction date.",
"type": "string",
"format": "date"
},
"transactionPrice": {
"description": "Average transaction price.",
"type": "number",
"format": "float"
},
"transactionCode": {
"description": "Transaction code. A list of codes and their meanings can be found <a href=\"https://www.sec.gov/about/forms/form4data.pdf\" target=\"_blank\" rel=\"noopener\">here</a>.",
"type": "string"
}
}
},
"InsiderTransactions": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Transactions"
},
"description": "Array of insider transactions."
}
}
},
"InsiderSentimentsData": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"year": {
"description": "Year.",
"type": "integer",
"format": "int64"
},
"month": {
"description": "Month.",
"type": "integer",
"format": "int64"
},
"change": {
"description": "Net buying/selling from all insiders' transactions.",
"type": "integer",
"format": "int64"
},
"mspr": {
"description": "Monthly share purchase ratio.",
"type": "number",
"format": "float"
}
}
},
"InsiderSentiments": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InsiderSentimentsData"
},
"description": "Array of sentiment data."
}
}
},
"FinancialMap": {
"type": "object"
},
"FinancialStatements": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol of the company.",
"type": "string"
},
"financials": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FinancialMap"
},
"description": "An array of map of key, value pairs containing the data for each period."
}
}
},
"ReportDataMap": {
"type": "object"
},
"Report": {
"type": "object",
"properties": {
"accessNumber": {
"description": "Access number.",
"type": "string"
},
"symbol": {
"description": "Symbol.",
"type": "string"
},
"cik": {
"description": "CIK.",
"type": "string"
},
"year": {
"description": "Year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Quarter.",
"type": "integer",
"format": "int64"
},
"form": {
"description": "Form type.",
"type": "string"
},
"startDate": {
"description": "Period start date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"endDate": {
"description": "Period end date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"filedDate": {
"description": "Filed date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"acceptedDate": {
"description": "Accepted date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"report": {
"type": "object",
"$ref": "#/components/schemas/ReportDataMap",
"description": "Report data."
}
}
},
"FinancialsAsReported": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"cik": {
"description": "CIK",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Report"
},
"description": "Array of filings."
}
}
},
"BreakdownItemMap": {
"type": "object"
},
"BreakdownItem": {
"type": "object",
"properties": {
"accessNumber": {
"description": "Access number of the report from which the data is sourced.",
"type": "string"
},
"breakdown": {
"type": "object",
"$ref": "#/components/schemas/BreakdownItemMap",
"description": "Revenue breakdown."
}
}
},
"RevenueBreakdown": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"cik": {
"description": "CIK",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BreakdownItem"
},
"description": "Array of revenue breakdown over multiple periods."
}
}
},
"RevenueBreakdown2": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"currency": {
"description": "currency",
"type": "string"
},
"data": {
"type": "object",
"description": "Revenue breakdown data."
}
}
},
"Filing": {
"type": "object",
"properties": {
"accessNumber": {
"description": "Access number.",
"type": "string"
},
"symbol": {
"description": "Symbol.",
"type": "string"
},
"cik": {
"description": "CIK.",
"type": "string"
},
"form": {
"description": "Form type.",
"type": "string"
},
"filedDate": {
"description": "Filed date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"acceptedDate": {
"description": "Accepted date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"reportUrl": {
"description": "Report's URL.",
"type": "string"
},
"filingUrl": {
"description": "Filing's URL.",
"type": "string"
}
}
},
"InternationalFiling": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"companyName": {
"description": "Company name.",
"type": "string"
},
"filedDate": {
"description": "Filed date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"category": {
"description": "Category.",
"type": "string"
},
"title": {
"description": "Document's title.",
"type": "string"
},
"description": {
"description": "Document's description.",
"type": "string"
},
"url": {
"description": "Url.",
"type": "string"
},
"language": {
"description": "Language.",
"type": "string"
},
"country": {
"description": "Country.",
"type": "string"
}
}
},
"FilingSentiment": {
"type": "object",
"properties": {
"negative": {
"description": "% of negative words in the filing.",
"type": "number",
"format": "float"
},
"positive": {
"description": "% of positive words in the filing.",
"type": "number",
"format": "float"
},
"polarity": {
"description": "% of polarity words in the filing.",
"type": "number",
"format": "float"
},
"litigious": {
"description": "% of litigious words in the filing.",
"type": "number",
"format": "float"
},
"uncertainty": {
"description": "% of uncertainty words in the filing.",
"type": "number",
"format": "float"
},
"constraining": {
"description": "% of constraining words in the filing.",
"type": "number",
"format": "float"
},
"modal-weak": {
"description": "% of modal-weak words in the filing.",
"type": "number",
"format": "float"
},
"modal-strong": {
"description": "% of modal-strong words in the filing.",
"type": "number",
"format": "float"
},
"modal-moderate": {
"description": "% of modal-moderate words in the filing.",
"type": "number",
"format": "float"
}
}
},
"SECSentimentAnalysis": {
"type": "object",
"properties": {
"accessNumber": {
"description": "Access number.",
"type": "string"
},
"symbol": {
"description": "Symbol.",
"type": "string"
},
"cik": {
"description": "CIK.",
"type": "string"
},
"sentiment": {
"type": "object",
"$ref": "#/components/schemas/FilingSentiment",
"description": "Filing Sentiment"
}
}
},
"SimilarityIndexInfo": {
"type": "object",
"properties": {
"cik": {
"description": "CIK.",
"type": "string"
},
"item1": {
"description": "Cosine similarity of Item 1 (Business). This number is only available for Annual reports.",
"type": "number",
"format": "float"
},
"item1a": {
"description": "Cosine similarity of Item 1A (Risk Factors). This number is available for both Annual and Quarterly reports.",
"type": "number",
"format": "float"
},
"item2": {
"description": "Cosine similarity of Item 2 (Management\u2019s Discussion and Analysis of Financial Condition and Results of Operations). This number is only available for Quarterly reports.",
"type": "number",
"format": "float"
},
"item7": {
"description": "Cosine similarity of Item 7 (Management\u2019s Discussion and Analysis of Financial Condition and Results of Operations). This number is only available for Annual reports.",
"type": "number",
"format": "float"
},
"item7a": {
"description": "Cosine similarity of Item 7A (Quantitative and Qualitative Disclosures About Market Risk). This number is only available for Annual reports.",
"type": "number",
"format": "float"
},
"accessNumber": {
"description": "Access number.",
"type": "string"
},
"form": {
"description": "Form type.",
"type": "string"
},
"filedDate": {
"description": "Filed date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"acceptedDate": {
"description": "Accepted date <code>%Y-%m-%d %H:%M:%S</code>.",
"type": "string",
"formatIgnore": "date-time"
},
"reportUrl": {
"description": "Report's URL.",
"type": "string"
},
"filingUrl": {
"description": "Filing's URL.",
"type": "string"
}
}
},
"SimilarityIndex": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"cik": {
"description": "CIK.",
"type": "string"
},
"similarity": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SimilarityIndexInfo"
},
"description": "Array of filings with its cosine similarity compared to the same report of the previous year."
}
}
},
"IPOEvent": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"date": {
"description": "IPO date.",
"type": "string",
"format": "date"
},
"exchange": {
"description": "Exchange.",
"type": "string"
},
"name": {
"description": "Company's name.",
"type": "string"
},
"status": {
"description": "IPO status. Can take 1 of the following values: <code>expected</code>,<code>priced</code>,<code>withdrawn</code>,<code>filed</code>",
"type": "string"
},
"price": {
"description": "Projected price or price range.",
"type": "string"
},
"numberOfShares": {
"description": "Number of shares offered during the IPO.",
"type": "number",
"format": "float"
},
"totalSharesValue": {
"description": "Total shares value.",
"type": "number",
"format": "float"
}
}
},
"IPOCalendar": {
"type": "object",
"properties": {
"ipoCalendar": {
"type": "array",
"items": {
"$ref": "#/components/schemas/IPOEvent"
},
"description": "Array of IPO events."
}
}
},
"Dividends": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"date": {
"description": "Ex-Dividend date.",
"type": "string",
"format": "date"
},
"amount": {
"description": "Amount in local currency.",
"type": "number",
"format": "float"
},
"adjustedAmount": {
"description": "Adjusted dividend.",
"type": "number",
"format": "float"
},
"payDate": {
"description": "Pay date.",
"type": "string",
"format": "date"
},
"recordDate": {
"description": "Record date.",
"type": "string",
"format": "date"
},
"declarationDate": {
"description": "Declaration date.",
"type": "string",
"format": "date"
},
"currency": {
"description": "Currency.",
"type": "string"
},
"freq": {
"description": "<p>Dividend frequency. Can be 1 of the following values:</p><ul>\n<li><code>0: Annually</code></li>\n<li><code>1: Monthly</code></li>\n<li><code>2: Quarterly</code></li>\n<li><code>3: Semi-annually</code></li>\n<li><code>4: Other/Unknown</code></li>\n<li><code>5: Bimonthly</code></li>\n<li><code>6: Trimesterly</code></li>\n<li><code>7: Weekly</code></li>\n</ul>",
"type": "string"
}
}
},
"Dividends2Info": {
"type": "object",
"properties": {
"exDate": {
"description": "Ex-Dividend date.",
"type": "string",
"format": "date"
},
"amount": {
"description": "Amount in local currency.",
"type": "number",
"format": "float"
}
}
},
"RecommendationTrend": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"buy": {
"description": "Number of recommendations that fall into the Buy category",
"type": "integer",
"format": "int64"
},
"hold": {
"description": "Number of recommendations that fall into the Hold category",
"type": "integer",
"format": "int64"
},
"period": {
"description": "Updated period",
"type": "string"
},
"sell": {
"description": "Number of recommendations that fall into the Sell category",
"type": "integer",
"format": "int64"
},
"strongBuy": {
"description": "Number of recommendations that fall into the Strong Buy category",
"type": "integer",
"format": "int64"
},
"strongSell": {
"description": "Number of recommendations that fall into the Strong Sell category",
"type": "integer",
"format": "int64"
}
}
},
"PriceTarget": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"targetHigh": {
"description": "Highes analysts' target.",
"type": "number",
"format": "float"
},
"targetLow": {
"description": "Lowest analysts' target.",
"type": "number",
"format": "float"
},
"targetMean": {
"description": "Mean of all analysts' targets.",
"type": "number",
"format": "float"
},
"targetMedian": {
"description": "Median of all analysts' targets.",
"type": "number",
"format": "float"
},
"numberAnalysts": {
"description": "Number of Analysts.",
"type": "integer",
"format": "int64"
},
"lastUpdated": {
"description": "Updated time of the data",
"type": "string",
"formatIgnore": "date-time"
}
}
},
"UpgradeDowngrade": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"gradeTime": {
"description": "Upgrade/downgrade time in UNIX timestamp.",
"type": "integer",
"format": "int64"
},
"fromGrade": {
"description": "From grade.",
"type": "string"
},
"toGrade": {
"description": "To grade.",
"type": "string"
},
"company": {
"description": "Company/analyst who did the upgrade/downgrade.",
"type": "string"
},
"action": {
"description": "Action can take any of the following values: <code>up(upgrade), down(downgrade), main(maintains), init(initiate), reit(reiterate)</code>.",
"type": "string"
}
}
},
"RevenueEstimatesInfo": {
"type": "object",
"properties": {
"revenueAvg": {
"description": "Average revenue estimates including Finnhub's proprietary estimates.",
"type": "number",
"format": "float"
},
"revenueHigh": {
"description": "Highest estimate.",
"type": "number",
"format": "float"
},
"revenueLow": {
"description": "Lowest estimate.",
"type": "number",
"format": "float"
},
"numberAnalysts": {
"description": "Number of Analysts.",
"type": "integer",
"format": "int64"
},
"period": {
"description": "Period.",
"type": "string",
"format": "date"
},
"year": {
"description": "Fiscal year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Fiscal quarter.",
"type": "integer",
"format": "int64"
}
}
},
"RevenueEstimates": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RevenueEstimatesInfo"
},
"description": "List of estimates"
},
"freq": {
"description": "Frequency: annual or quarterly.",
"type": "string"
},
"symbol": {
"description": "Company symbol.",
"type": "string"
}
}
},
"EbitdaEstimatesInfo": {
"type": "object",
"properties": {
"ebitdaAvg": {
"description": "Average EBITDA estimates including Finnhub's proprietary estimates.",
"type": "number",
"format": "float"
},
"ebitdaHigh": {
"description": "Highest estimate.",
"type": "number",
"format": "float"
},
"ebitdaLow": {
"description": "Lowest estimate.",
"type": "number",
"format": "float"
},
"numberAnalysts": {
"description": "Number of Analysts.",
"type": "integer",
"format": "int64"
},
"period": {
"description": "Period.",
"type": "string",
"format": "date"
},
"year": {
"description": "Fiscal year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Fiscal quarter.",
"type": "integer",
"format": "int64"
}
}
},
"EbitdaEstimates": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EbitdaEstimatesInfo"
},
"description": "List of estimates"
},
"freq": {
"description": "Frequency: annual or quarterly.",
"type": "string"
},
"symbol": {
"description": "Company symbol.",
"type": "string"
}
}
},
"EbitEstimatesInfo": {
"type": "object",
"properties": {
"ebitAvg": {
"description": "Average EBIT estimates including Finnhub's proprietary estimates.",
"type": "number",
"format": "float"
},
"ebitHigh": {
"description": "Highest estimate.",
"type": "number",
"format": "float"
},
"ebitLow": {
"description": "Lowest estimate.",
"type": "number",
"format": "float"
},
"numberAnalysts": {
"description": "Number of Analysts.",
"type": "integer",
"format": "int64"
},
"period": {
"description": "Period.",
"type": "string",
"format": "date"
},
"year": {
"description": "Fiscal year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Fiscal quarter.",
"type": "integer",
"format": "int64"
}
}
},
"EbitEstimates": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EbitEstimatesInfo"
},
"description": "List of estimates"
},
"freq": {
"description": "Frequency: annual or quarterly.",
"type": "string"
},
"symbol": {
"description": "Company symbol.",
"type": "string"
}
}
},
"EarningsEstimatesInfo": {
"type": "object",
"properties": {
"epsAvg": {
"description": "Average EPS estimates including Finnhub's proprietary estimates.",
"type": "number",
"format": "float"
},
"epsHigh": {
"description": "Highest estimate.",
"type": "number",
"format": "float"
},
"epsLow": {
"description": "Lowest estimate.",
"type": "number",
"format": "float"
},
"numberAnalysts": {
"description": "Number of Analysts.",
"type": "integer",
"format": "int64"
},
"period": {
"description": "Period.",
"type": "string",
"format": "date"
},
"year": {
"description": "Fiscal year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Fiscal quarter.",
"type": "integer",
"format": "int64"
}
}
},
"EarningsEstimates": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EarningsEstimatesInfo"
},
"description": "List of estimates"
},
"freq": {
"description": "Frequency: annual or quarterly.",
"type": "string"
},
"symbol": {
"description": "Company symbol.",
"type": "string"
}
}
},
"EarningResult": {
"type": "object",
"properties": {
"actual": {
"description": "Actual earning result.",
"type": "number",
"format": "float"
},
"estimate": {
"description": "Estimated earning.",
"type": "number",
"format": "float"
},
"surprise": {
"description": "Surprise - The difference between actual and estimate.",
"type": "number",
"format": "float"
},
"surprisePercent": {
"description": "Surprise percent.",
"type": "number",
"format": "float"
},
"period": {
"description": "Reported period.",
"type": "string",
"format": "date"
},
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"year": {
"description": "Fiscal year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Fiscal quarter.",
"type": "integer",
"format": "int64"
}
}
},
"EarningRelease": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"date": {
"description": "Date.",
"type": "string",
"format": "date"
},
"hour": {
"description": "Indicates whether the earnings is announced before market open(<code>bmo</code>), after market close(<code>amc</code>), or during market hour(<code>dmh</code>).",
"type": "string"
},
"year": {
"description": "Earnings year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Earnings quarter.",
"type": "integer",
"format": "int64"
},
"epsEstimate": {
"description": "EPS estimate.",
"type": "number",
"format": "float"
},
"epsActual": {
"description": "EPS actual.",
"type": "number",
"format": "float"
},
"revenueEstimate": {
"description": "Revenue estimate including Finnhub's proprietary estimates.",
"type": "number",
"format": "float"
},
"revenueActual": {
"description": "Revenue actual.",
"type": "number",
"format": "float"
}
}
},
"EarningsCalendar": {
"type": "object",
"properties": {
"earningsCalendar": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EarningRelease"
},
"description": "Array of earnings release."
}
}
},
"EarningsCallLiveResult": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"event": {
"description": "Event name.",
"type": "string"
},
"time": {
"description": "Date time in UTC.",
"type": "string",
"format": "datetime"
},
"year": {
"description": "Earnings year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Earnings quarter.",
"type": "integer",
"format": "int64"
},
"liveAudio": {
"description": "Live audio streaming file.",
"type": "string"
},
"recording": {
"description": "Recoding in mp3 format.",
"type": "string"
}
}
},
"EarningsCallLive": {
"type": "object",
"properties": {
"event": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EarningsCallLiveResult"
},
"description": "Array of earnings call events that support live streaming."
}
}
},
"Quote": {
"type": "object",
"properties": {
"o": {
"description": "Open price of the day",
"type": "number",
"format": "float"
},
"h": {
"description": "High price of the day",
"type": "number",
"format": "float"
},
"l": {
"description": "Low price of the day",
"type": "number",
"format": "float"
},
"c": {
"description": "Current price",
"type": "number",
"format": "float"
},
"pc": {
"description": "Previous close price",
"type": "number",
"format": "float"
},
"d": {
"description": "Change",
"type": "number",
"format": "float"
},
"dp": {
"description": "Percent change",
"type": "number",
"format": "float"
}
}
},
"StockCandles": {
"type": "object",
"properties": {
"o": {
"type": "array",
"description": "List of open prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"h": {
"type": "array",
"description": "List of high prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"l": {
"type": "array",
"description": "List of low prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"c": {
"type": "array",
"description": "List of close prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"v": {
"type": "array",
"description": "List of volume data for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"t": {
"type": "array",
"description": "List of timestamp for returned candles.",
"items": {
"type": "integer",
"format": "int64"
}
},
"s": {
"description": "Status of the response. This field can either be ok or no_data.",
"type": "string"
}
}
},
"TickData": {
"type": "object",
"properties": {
"s": {
"description": "Symbol.",
"type": "string"
},
"skip": {
"description": "Number of ticks skipped.",
"type": "integer",
"format": "int64"
},
"count": {
"description": "Number of ticks returned. If <code>count</code> < <code>limit</code>, all data for that date has been returned.",
"type": "integer",
"format": "int64"
},
"total": {
"description": "Total number of ticks for that date.",
"type": "integer",
"format": "int64"
},
"v": {
"type": "array",
"description": "List of volume data.",
"items": {
"type": "number",
"format": "float"
}
},
"p": {
"type": "array",
"description": "List of price data.",
"items": {
"type": "number",
"format": "float"
}
},
"t": {
"type": "array",
"description": "List of timestamp in UNIX ms.",
"items": {
"type": "integer",
"format": "int64"
}
},
"x": {
"type": "array",
"description": "List of venues/exchanges. A list of exchange codes can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1Tj53M1svmr-hfEtbk6_NpVR1yAyGLMaH6ByYU6CG0ZY/edit?usp=sharing\",>here</a>",
"items": {
"type": "string"
}
},
"c": {
"type": "array",
"description": "List of trade conditions. A comprehensive list of trade conditions code can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1PUxiSWPHSODbaTaoL2Vef6DgU-yFtlRGZf19oBb9Hp0/edit?usp=sharing\">here</a>",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"BondTickData": {
"type": "object",
"properties": {
"skip": {
"description": "Number of ticks skipped.",
"type": "integer",
"format": "int64"
},
"count": {
"description": "Number of ticks returned. If <code>count</code> < <code>limit</code>, all data for that date has been returned.",
"type": "integer",
"format": "int64"
},
"total": {
"description": "Total number of ticks for that date.",
"type": "integer",
"format": "int64"
},
"v": {
"type": "array",
"description": "List of volume data.",
"items": {
"type": "number",
"format": "float"
}
},
"p": {
"type": "array",
"description": "List of price data.",
"items": {
"type": "number",
"format": "float"
}
},
"y": {
"type": "array",
"description": "List of yield data.",
"items": {
"type": "number",
"format": "float"
}
},
"t": {
"type": "array",
"description": "List of timestamp in UNIX ms.",
"items": {
"type": "integer",
"format": "int64"
}
},
"si": {
"type": "array",
"description": "List of values showing the side (Buy/sell) of each trade. List of supported values: <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1O3aueXSPOqo7Iuyz4PqDG6yZunHsX8BTefZ2kFk5pz4/edit?usp=sharing\",>here</a>",
"items": {
"type": "string"
}
},
"cp": {
"type": "array",
"description": "List of values showing the counterparty of each trade. List of supported values: <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1O3aueXSPOqo7Iuyz4PqDG6yZunHsX8BTefZ2kFk5pz4/edit?usp=sharing\",>here</a>",
"items": {
"type": "string"
}
},
"rp": {
"type": "array",
"description": "List of values showing the reporting party of each trade. List of supported values: <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1O3aueXSPOqo7Iuyz4PqDG6yZunHsX8BTefZ2kFk5pz4/edit?usp=sharing\",>here</a>",
"items": {
"type": "string"
}
},
"ats": {
"type": "array",
"description": "ATS flag. Y or empty",
"items": {
"type": "string"
}
},
"c": {
"type": "array",
"description": "List of trade conditions. A comprehensive list of trade conditions code can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1O3aueXSPOqo7Iuyz4PqDG6yZunHsX8BTefZ2kFk5pz4/edit?usp=sharing\">here</a>",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"HistoricalNBBO": {
"type": "object",
"properties": {
"s": {
"description": "Symbol.",
"type": "string"
},
"skip": {
"description": "Number of ticks skipped.",
"type": "integer",
"format": "int64"
},
"count": {
"description": "Number of ticks returned. If <code>count</code> < <code>limit</code>, all data for that date has been returned.",
"type": "integer",
"format": "int64"
},
"total": {
"description": "Total number of ticks for that date.",
"type": "integer",
"format": "int64"
},
"av": {
"type": "array",
"description": "List of Ask volume data.",
"items": {
"type": "number",
"format": "float"
}
},
"a": {
"type": "array",
"description": "List of Ask price data.",
"items": {
"type": "number",
"format": "float"
}
},
"ax": {
"type": "array",
"description": "List of venues/exchanges - Ask price. A list of exchange codes can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1Tj53M1svmr-hfEtbk6_NpVR1yAyGLMaH6ByYU6CG0ZY/edit?usp=sharing\",>here</a>",
"items": {
"type": "string"
}
},
"bv": {
"type": "array",
"description": "List of Bid volume data.",
"items": {
"type": "number",
"format": "float"
}
},
"b": {
"type": "array",
"description": "List of Bid price data.",
"items": {
"type": "number",
"format": "float"
}
},
"bx": {
"type": "array",
"description": "List of venues/exchanges - Bid price. A list of exchange codes can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1Tj53M1svmr-hfEtbk6_NpVR1yAyGLMaH6ByYU6CG0ZY/edit?usp=sharing\",>here</a>",
"items": {
"type": "string"
}
},
"t": {
"type": "array",
"description": "List of timestamp in UNIX ms.",
"items": {
"type": "integer",
"format": "int64"
}
},
"c": {
"type": "array",
"description": "List of quote conditions. A comprehensive list of quote conditions code can be found <a target=\"_blank\" href=\"https://docs.google.com/spreadsheets/d/1iiA6e7Osdtai0oPMOUzgAIKXCsay89dFDmsegz6OpEg/edit?usp=sharing\">here</a>",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"LastBid-Ask": {
"type": "object",
"properties": {
"b": {
"description": "Bid price.",
"type": "number",
"format": "float"
},
"a": {
"description": "Ask price.",
"type": "number",
"format": "float"
},
"bv": {
"description": "Bid volume.",
"type": "number",
"format": "float"
},
"av": {
"description": "Ask volume.",
"type": "number",
"format": "float"
},
"t": {
"description": "Reference UNIX timestamp in ms.",
"type": "integer",
"format": "int64"
}
}
},
"Split": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"date": {
"description": "Split date.",
"type": "string",
"format": "date"
},
"fromFactor": {
"description": "From factor.",
"type": "number",
"format": "float"
},
"toFactor": {
"description": "To factor.",
"type": "number",
"format": "float"
}
}
},
"Dividends2": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Dividends2Info"
},
"description": ""
}
}
},
"IndicesConstituents": {
"type": "object",
"properties": {
"symbol": {
"description": "Index's symbol.",
"type": "string"
},
"constituents": {
"type": "array",
"description": "Array of constituents.",
"items": {
"type": "string"
}
},
"constituentsBreakdown": {
"type": "array",
"items": {
"$ref": "#/components/schemas/IndicesConstituentsBreakdown"
},
"description": "Array of constituents' details."
}
}
},
"IndicesConstituentsBreakdown": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"name": {
"description": "Name.",
"type": "string"
},
"isin": {
"description": "ISIN.",
"type": "string"
},
"cusip": {
"description": "Cusip.",
"type": "string"
},
"shareClassFIGI": {
"description": "Global Share Class FIGI.",
"type": "string"
},
"weight": {
"description": "Weight.",
"type": "number",
"format": "float"
}
}
},
"IndexHistoricalConstituent": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"action": {
"description": "<code>add</code> or <code>remove</code>.",
"type": "string"
},
"date": {
"description": "Date of joining or leaving the index.",
"type": "string",
"format": "date"
}
}
},
"IndicesHistoricalConstituents": {
"type": "object",
"properties": {
"symbol": {
"description": "Index's symbol.",
"type": "string"
},
"historicalConstituents": {
"type": "array",
"items": {
"$ref": "#/components/schemas/IndexHistoricalConstituent"
},
"description": "Array of historical constituents."
}
}
},
"ETFProfileData": {
"type": "object",
"properties": {
"name": {
"description": "Name",
"type": "string"
},
"assetClass": {
"description": "Asset Class.",
"type": "string"
},
"investmentSegment": {
"description": "Investment Segment.",
"type": "string"
},
"aum": {
"description": "AUM.",
"type": "number",
"format": "float"
},
"nav": {
"description": "NAV.",
"type": "number",
"format": "float"
},
"navCurrency": {
"description": "NAV currency.",
"type": "string"
},
"expenseRatio": {
"description": "Expense ratio. For non-US funds, this is the <a href=\"https://www.esma.europa.eu/sites/default/files/library/2015/11/09_1028_final_kid_ongoing_charges_methodology_for_publication_u_2_.pdf\" target=\"_blank\">KID ongoing charges<a/>.",
"type": "number",
"format": "float"
},
"trackingIndex": {
"description": "Tracking Index.",
"type": "string"
},
"etfCompany": {
"description": "ETF issuer.",
"type": "string"
},
"domicile": {
"description": "ETF domicile.",
"type": "string"
},
"inceptionDate": {
"description": "Inception date.",
"type": "string",
"format": "date"
},
"website": {
"description": "ETF's website.",
"type": "string"
},
"logo": {
"description": "Logo.",
"type": "string"
},
"isin": {
"description": "ISIN.",
"type": "string"
},
"cusip": {
"description": "CUSIP.",
"type": "string"
},
"priceToEarnings": {
"description": "P/E.",
"type": "number",
"format": "float"
},
"priceToBook": {
"description": "P/B.",
"type": "number",
"format": "float"
},
"avgVolume": {
"description": "30-day average volume.",
"type": "number",
"format": "float"
},
"description": {
"description": "ETF's description.",
"type": "string"
},
"isInverse": {
"description": "Whether the ETF is inverse",
"type": "boolean"
},
"isLeveraged": {
"description": "Whether the ETF is leveraged",
"type": "boolean"
},
"leverageFactor": {
"description": "Leverage factor.",
"type": "number",
"format": "float"
},
"dividendYield": {
"description": "Dividend yield.",
"type": "number",
"format": "float"
}
}
},
"ETFsProfile": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"profile": {
"type": "object",
"$ref": "#/components/schemas/ETFProfileData",
"description": "Profile data."
}
}
},
"ETFHoldingsData": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol description",
"type": "string"
},
"name": {
"description": "Security name",
"type": "string"
},
"isin": {
"description": "ISIN.",
"type": "string"
},
"cusip": {
"description": "CUSIP.",
"type": "string"
},
"share": {
"description": "Number of shares owned by the ETF.",
"type": "number",
"format": "float"
},
"percent": {
"description": "Portfolio's percent",
"type": "number",
"format": "float"
},
"value": {
"description": "Market value",
"type": "number",
"format": "float"
},
"assetType": {
"description": "Asset type. Can be 1 of the following values: <code>Equity</code>, <code>ETP</code>, <code>Fund</code>, <code>Bond</code>, <code>Other</code> or empty.",
"type": "string"
}
}
},
"ETFsHoldings": {
"type": "object",
"properties": {
"symbol": {
"description": "ETF symbol.",
"type": "string"
},
"atDate": {
"description": "Holdings update date.",
"type": "string",
"format": "date"
},
"numberOfHoldings": {
"description": "Number of holdings.",
"type": "integer",
"format": "int64"
},
"holdings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ETFHoldingsData"
},
"description": "Array of holdings."
}
}
},
"ETFSectorExposureData": {
"type": "object",
"properties": {
"industry": {
"description": "Industry",
"type": "string"
},
"exposure": {
"description": "Percent of exposure.",
"type": "number",
"format": "float"
}
}
},
"ETFsSectorExposure": {
"type": "object",
"properties": {
"symbol": {
"description": "ETF symbol.",
"type": "string"
},
"sectorExposure": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ETFSectorExposureData"
},
"description": "Array of industries and exposure levels."
}
}
},
"ETFCountryExposureData": {
"type": "object",
"properties": {
"country": {
"description": "Country",
"type": "string"
},
"exposure": {
"description": "Percent of exposure.",
"type": "number",
"format": "float"
}
}
},
"ETFsCountryExposure": {
"type": "object",
"properties": {
"symbol": {
"description": "ETF symbol.",
"type": "string"
},
"countryExposure": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ETFCountryExposureData"
},
"description": "Array of countries and and exposure levels."
}
}
},
"ETFAllocationData": {
"type": "object",
"properties": {
"largeBlend": {
"description": "Percentage of stocks classified as Large Blend.",
"type": "number",
"format": "float"
},
"largeGrowth": {
"description": "Percentage of stocks classified as Large Growth.",
"type": "number",
"format": "float"
},
"largeValue": {
"description": "Percentage of stocks classified as Large Value.",
"type": "number",
"format": "float"
},
"midBlend": {
"description": "Percentage of stocks classified as Mid-cap Blend.",
"type": "number",
"format": "float"
},
"midGrowth": {
"description": "Percentage of stocks classified as Mid-cap Growth.",
"type": "number",
"format": "float"
},
"midValue": {
"description": "Percentage of stocks classified as Mid-cap Value.",
"type": "number",
"format": "float"
},
"smallBlend": {
"description": "Percentage of stocks classified as Small-cap Blend.",
"type": "number",
"format": "float"
},
"smallGrowth": {
"description": "Percentage of stocks classified as Small-cap Growth.",
"type": "number",
"format": "float"
},
"smallValue": {
"description": "Percentage of stocks classified as Small-cap Value.",
"type": "number",
"format": "float"
}
}
},
"ETFsAllocation": {
"type": "object",
"properties": {
"symbol": {
"description": "ETF symbol.",
"type": "string"
},
"data": {
"type": "object",
"$ref": "#/components/schemas/ETFAllocationData",
"description": "ETF allocation."
}
}
},
"MutualFundProfileData": {
"type": "object",
"properties": {
"name": {
"description": "Name",
"type": "string"
},
"category": {
"description": "Fund's category.",
"type": "string"
},
"investmentSegment": {
"description": "Investment Segment.",
"type": "string"
},
"totalNav": {
"description": "NAV.",
"type": "number",
"format": "float"
},
"expenseRatio": {
"description": "Expense ratio.",
"type": "number",
"format": "float"
},
"benchmark": {
"description": "Index benchmark.",
"type": "string"
},
"inceptionDate": {
"description": "Inception date.",
"type": "string",
"format": "date"
},
"description": {
"description": "Fund's description.",
"type": "string"
},
"fundFamily": {
"description": "Fund Family.",
"type": "string"
},
"fundCompany": {
"description": "Fund Company.",
"type": "string"
},
"manager": {
"description": "Fund's managers.",
"type": "string"
},
"status": {
"description": "Status.",
"type": "string"
},
"beta": {
"description": "Beta.",
"type": "number",
"format": "float"
},
"deferredLoad": {
"description": "Deferred load.",
"type": "number",
"format": "float"
},
"fee12b1": {
"description": "12B-1 fee.",
"type": "number",
"format": "float"
},
"frontLoad": {
"description": "Front Load.",
"type": "number",
"format": "float"
},
"iraMinInvestment": {
"description": "IRA minimum investment.",
"type": "number",
"format": "float"
},
"isin": {
"description": "ISIN.",
"type": "string"
},
"cusip": {
"description": "CUSIP.",
"type": "string"
},
"maxRedemptionFee": {
"description": "Max redemption fee.",
"type": "number",
"format": "float"
},
"standardMinInvestment": {
"description": "Minimum investment for standard accounts.",
"type": "number",
"format": "float"
},
"turnover": {
"description": "Turnover.",
"type": "number",
"format": "float"
},
"seriesId": {
"description": "Fund's series ID. This field can be used to group multiple share classes into 1 unique fund.",
"type": "string"
},
"seriesName": {
"description": "Fund's series name.",
"type": "string"
},
"classId": {
"description": "Class ID.",
"type": "string"
},
"className": {
"description": "Class name.",
"type": "string"
},
"sfdrClassification": {
"description": "SFDR classification for EU funds. Under the new classifications, a fund's strategy will labeled under either Article 6, 8 or 9. Article 6 covers funds which do not integrate any kind of sustainability into the investment process. Article 8, also known as \u2018environmental and socially promoting\u2019, applies \u201c\u2026 where a financial product promotes, among other characteristics, environmental or social characteristics, or a combination of those characteristics, provided that the companies in which the investments are made follow good governance practices.\u201d. Article 9, also known as \u2018products targeting sustainable investments\u2019, covers products targeting bespoke sustainable investments and applies \u201c\u2026 where a financial product has sustainable investment as its objective and an index has been designated as a reference benchmark.\u201d",
"type": "string"
},
"currency": {
"description": "Fund's currency",
"type": "string"
}
}
},
"MutualFundProfile": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"profile": {
"type": "object",
"$ref": "#/components/schemas/MutualFundProfileData",
"description": "Profile data."
}
}
},
"MutualFundHoldingsData": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol description",
"type": "string"
},
"name": {
"description": "Security name",
"type": "string"
},
"isin": {
"description": "ISIN.",
"type": "string"
},
"cusip": {
"description": "CUSIP.",
"type": "string"
},
"share": {
"description": "Number of shares.",
"type": "number",
"format": "float"
},
"percent": {
"description": "Portfolio's percent",
"type": "number",
"format": "float"
},
"value": {
"description": "Market value",
"type": "number",
"format": "float"
},
"assetType": {
"description": "Asset type. Can be 1 of the following values: <code>Equity</code>, <code>ETP</code>, <code>Fund</code>, <code>Bond</code>, <code>Other</code> or empty.",
"type": "string"
}
}
},
"MutualFundHoldings": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"atDate": {
"description": "Holdings update date.",
"type": "string",
"format": "date"
},
"numberOfHoldings": {
"description": "Number of holdings.",
"type": "integer",
"format": "int64"
},
"holdings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MutualFundHoldingsData"
},
"description": "Array of holdings."
}
}
},
"MutualFundSectorExposureData": {
"type": "object",
"properties": {
"sector": {
"description": "Sector",
"type": "string"
},
"exposure": {
"description": "Percent of exposure.",
"type": "number",
"format": "float"
}
}
},
"MutualFundSectorExposure": {
"type": "object",
"properties": {
"symbol": {
"description": "Mutual symbol.",
"type": "string"
},
"sectorExposure": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MutualFundSectorExposureData"
},
"description": "Array of sector and exposure levels."
}
}
},
"MutualFundCountryExposureData": {
"type": "object",
"properties": {
"country": {
"description": "Country",
"type": "string"
},
"exposure": {
"description": "Percent of exposure.",
"type": "number",
"format": "float"
}
}
},
"MutualFundCountryExposure": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"countryExposure": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MutualFundCountryExposureData"
},
"description": "Array of countries and and exposure levels."
}
}
},
"MutualFundEetData": {
"type": "object"
},
"MutualFundEet": {
"type": "object",
"properties": {
"isin": {
"description": "ISIN.",
"type": "string"
},
"data": {
"type": "object",
"$ref": "#/components/schemas/MutualFundEetData",
"description": "EET data."
}
}
},
"MutualFundEetPaiData": {
"type": "object"
},
"MutualFundEetPai": {
"type": "object",
"properties": {
"isin": {
"description": "ISIN.",
"type": "string"
},
"data": {
"type": "object",
"$ref": "#/components/schemas/MutualFundEetPaiData",
"description": "EET data."
}
}
},
"ForexSymbol": {
"type": "object",
"properties": {
"description": {
"description": "Symbol description",
"type": "string"
},
"displaySymbol": {
"description": "Display symbol name.",
"type": "string"
},
"symbol": {
"description": "Unique symbol used to identify this symbol used in <code>/forex/candle</code> endpoint.",
"type": "string"
}
}
},
"ForexCandles": {
"type": "object",
"properties": {
"o": {
"type": "array",
"description": "List of open prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"h": {
"type": "array",
"description": "List of high prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"l": {
"type": "array",
"description": "List of low prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"c": {
"type": "array",
"description": "List of close prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"v": {
"type": "array",
"description": "List of volume data for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"t": {
"type": "array",
"description": "List of timestamp for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"s": {
"description": "Status of the response. This field can either be ok or no_data.",
"type": "string"
}
}
},
"ForexRate": {
"type": "object"
},
"Forexrates": {
"type": "object",
"properties": {
"base": {
"description": "Base currency.",
"type": "string"
},
"quote": {
"type": "object",
"$ref": "#/components/schemas/ForexRate",
"description": "A map of base/quote rates for all currency pair."
}
}
},
"CryptoSymbol": {
"type": "object",
"properties": {
"description": {
"description": "Symbol description",
"type": "string"
},
"displaySymbol": {
"description": "Display symbol name.",
"type": "string"
},
"symbol": {
"description": "Unique symbol used to identify this symbol used in <code>/crypto/candle</code> endpoint.",
"type": "string"
}
}
},
"CryptoProfile": {
"type": "object",
"properties": {
"longName": {
"description": "Long name.",
"type": "string"
},
"name": {
"description": "Name.",
"type": "string"
},
"description": {
"description": "Description.",
"type": "string"
},
"website": {
"description": "Project's website.",
"type": "string"
},
"marketCap": {
"description": "Market capitalization.",
"type": "number",
"format": "float"
},
"totalSupply": {
"description": "Total supply.",
"type": "number",
"format": "float"
},
"maxSupply": {
"description": "Max supply.",
"type": "number",
"format": "float"
},
"circulatingSupply": {
"description": "Circulating supply.",
"type": "number",
"format": "float"
},
"logo": {
"description": "Logo image.",
"type": "string"
},
"launchDate": {
"description": "Launch date.",
"type": "string"
},
"proofType": {
"description": "Proof type.",
"type": "string"
}
}
},
"CryptoCandles": {
"type": "object",
"properties": {
"o": {
"type": "array",
"description": "List of open prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"h": {
"type": "array",
"description": "List of high prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"l": {
"type": "array",
"description": "List of low prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"c": {
"type": "array",
"description": "List of close prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"v": {
"type": "array",
"description": "List of volume data for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"t": {
"type": "array",
"description": "List of timestamp for returned candles.",
"items": {
"type": "integer",
"format": "int64"
}
},
"s": {
"description": "Status of the response. This field can either be ok or no_data.",
"type": "string"
}
}
},
"ScanPattern": {
"type": "object"
},
"PatternRecognition": {
"type": "object",
"properties": {
"points": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ScanPattern"
},
"description": "Array of patterns."
}
}
},
"SupportResistance": {
"type": "object",
"properties": {
"levels": {
"type": "array",
"description": "Array of support and resistance levels.",
"items": {
"type": "number",
"format": "float"
}
}
}
},
"Indicator": {
"type": "object",
"properties": {
"buy": {
"description": "Number of buy signals",
"type": "integer",
"format": "int64"
},
"neutral": {
"description": "Number of neutral signals",
"type": "integer",
"format": "int64"
},
"sell": {
"description": "Number of sell signals",
"type": "integer",
"format": "int64"
}
}
},
"TechnicalAnalysis": {
"type": "object",
"properties": {
"count": {
"type": "object",
"$ref": "#/components/schemas/Indicator",
"description": "Number of indicators for each signal"
},
"signal": {
"description": "Aggregate Signal",
"type": "string"
}
}
},
"Trend": {
"type": "object",
"properties": {
"adx": {
"description": "ADX reading",
"type": "number",
"format": "float"
},
"trending": {
"description": "Whether market is trending or going sideway",
"type": "boolean"
}
}
},
"AggregateIndicators": {
"type": "object",
"properties": {
"technicalAnalysis": {
"type": "object",
"$ref": "#/components/schemas/TechnicalAnalysis",
"description": "Number of indicator signals strong buy, buy, neutral, sell, strong sell signals."
},
"trend": {
"type": "object",
"$ref": "#/components/schemas/Trend",
"description": "Whether the market is trending."
}
}
},
"TechnicalIndicator": {
"type": "object"
},
"IndicatorFields": {
"type": "object"
},
"StockTranscripts": {
"type": "object",
"properties": {
"id": {
"description": "Transcript's ID used to get the <a href=\"#transcripts\">full transcript</a>.",
"type": "string"
},
"title": {
"description": "Title.",
"type": "string"
},
"time": {
"description": "Time of the event.",
"type": "string",
"formatIgnore": "date-time"
},
"year": {
"description": "Year of earnings result in the case of earnings call transcript.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Quarter of earnings result in the case of earnings call transcript.",
"type": "integer",
"format": "int64"
}
}
},
"EarningsCallTranscriptsList": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"transcripts": {
"type": "array",
"items": {
"$ref": "#/components/schemas/StockTranscripts"
},
"description": "Array of transcripts' metadata"
}
}
},
"TranscriptContent": {
"type": "object",
"properties": {
"name": {
"description": "Speaker's name",
"type": "string"
},
"speech": {
"type": "array",
"description": "Speaker's speech",
"items": {
"type": "string"
}
},
"session": {
"description": "Earnings calls section (management discussion or Q&A)",
"type": "string"
}
}
},
"TranscriptParticipant": {
"type": "object",
"properties": {
"name": {
"description": "Participant's name",
"type": "string"
},
"description": {
"description": "Participant's description",
"type": "string"
},
"role": {
"description": "Whether the speak is a company's executive or an analyst",
"type": "string"
}
}
},
"EarningsCallTranscripts": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"transcript": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TranscriptContent"
},
"description": "Transcript content."
},
"participant": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TranscriptParticipant"
},
"description": "Participant list"
},
"audio": {
"description": "Audio link.",
"type": "string"
},
"id": {
"description": "Transcript's ID.",
"type": "string"
},
"title": {
"description": "Title.",
"type": "string"
},
"time": {
"description": "Time of the event.",
"type": "string",
"formatIgnore": "date-time"
},
"year": {
"description": "Year of earnings result in the case of earnings call transcript.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Quarter of earnings result in the case of earnings call transcript.",
"type": "integer",
"format": "int64"
}
}
},
"PresentationData": {
"type": "object",
"properties": {
"quarter": {
"description": "Quarter",
"type": "integer",
"format": "int64"
},
"year": {
"description": "Year",
"type": "integer",
"format": "int64"
},
"url": {
"description": "Presentation url",
"type": "string"
},
"title": {
"description": "Title",
"type": "string"
},
"atTime": {
"description": "At Time.",
"type": "string",
"formatIgnore": "date-time"
}
}
},
"StockPresentation": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"res": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PresentationData"
},
"description": "Presentation data."
}
}
},
"SentimentContent": {
"type": "object",
"properties": {
"mention": {
"description": "Number of mentions",
"type": "integer",
"format": "int64"
},
"positiveMention": {
"description": "Number of positive mentions",
"type": "integer",
"format": "int64"
},
"negativeMention": {
"description": "Number of negative mentions",
"type": "integer",
"format": "int64"
},
"positiveScore": {
"description": "Positive score. Range 0-1",
"type": "number",
"format": "float"
},
"negativeScore": {
"description": "Negative score. Range 0-1",
"type": "number",
"format": "float"
},
"score": {
"description": "Final score. Range: -1 to 1 with 1 is very positive and -1 is very negative",
"type": "number",
"format": "float"
},
"atTime": {
"description": "Period.",
"type": "string",
"formatIgnore": "date-time"
}
}
},
"SocialSentiment": {
"type": "object",
"properties": {
"symbol": {
"description": "Company symbol.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SentimentContent"
},
"description": "Sentiment data."
}
}
},
"InvestmentThemePortfolio": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
}
}
},
"InvestmentThemes": {
"type": "object",
"properties": {
"theme": {
"description": "Investment theme",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InvestmentThemePortfolio"
},
"description": "Investment theme portfolio."
}
}
},
"SectorMetric": {
"type": "object",
"properties": {
"region": {
"description": "Region.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SectorMetricData"
},
"description": "Metrics for each sector."
}
}
},
"SectorMetricData": {
"type": "object",
"properties": {
"sector": {
"description": "Sector",
"type": "string"
},
"metrics": {
"description": "Metrics data in key-value format. <code>a</code> and <code>m</code> fields are for average and median respectively.",
"type": "object"
}
}
},
"KeyCustomersSuppliers": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"name": {
"description": "Name",
"type": "string"
},
"country": {
"description": "Country",
"type": "string"
},
"industry": {
"description": "Industry",
"type": "string"
},
"customer": {
"description": "Whether the company is a customer.",
"type": "boolean"
},
"supplier": {
"description": "Whether the company is a supplier",
"type": "boolean"
},
"oneMonthCorrelation": {
"description": "1-month price correlation",
"type": "number",
"format": "float"
},
"oneYearCorrelation": {
"description": "1-year price correlation",
"type": "number",
"format": "float"
},
"sixMonthCorrelation": {
"description": "6-month price correlation",
"type": "number",
"format": "float"
},
"threeMonthCorrelation": {
"description": "3-month price correlation",
"type": "number",
"format": "float"
},
"twoWeekCorrelation": {
"description": "2-week price correlation",
"type": "number",
"format": "float"
},
"twoYearCorrelation": {
"description": "2-year price correlation",
"type": "number",
"format": "float"
}
}
},
"SupplyChainRelationships": {
"type": "object",
"properties": {
"symbol": {
"description": "symbol",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/KeyCustomersSuppliers"
},
"description": "Key customers and suppliers."
}
}
},
"HistoricalCompanyESG": {
"type": "object",
"properties": {
"symbol": {
"description": "symbol",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CompanyESG2"
},
"description": "Historical ESG data points."
}
}
},
"CompanyESG2": {
"type": "object",
"properties": {
"totalESGScore": {
"description": "Total ESG Score",
"type": "number",
"format": "float"
},
"environmentScore": {
"description": "Environment Score",
"type": "number",
"format": "float"
},
"governanceScore": {
"description": "Governance Score",
"type": "number",
"format": "float"
},
"socialScore": {
"description": "Social Score",
"type": "number",
"format": "float"
},
"data": {
"type": "object",
"$ref": "#/components/schemas/CompanyESGMap",
"description": "Map key-value pair of key ESG data points."
},
"period": {
"description": "Period",
"type": "string"
}
}
},
"CompanyESG": {
"type": "object",
"properties": {
"symbol": {
"description": "symbol",
"type": "string"
},
"totalESGScore": {
"description": "Total ESG Score",
"type": "number",
"format": "float"
},
"environmentScore": {
"description": "Environment Score",
"type": "number",
"format": "float"
},
"governanceScore": {
"description": "Governance Score",
"type": "number",
"format": "float"
},
"socialScore": {
"description": "Social Score",
"type": "number",
"format": "float"
},
"data": {
"type": "object",
"$ref": "#/components/schemas/CompanyESGMap",
"description": "Map key-value pair of key ESG data points."
}
}
},
"CompanyESGMap": {
"type": "object"
},
"CompanyEarningsQualityScore": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol",
"type": "string"
},
"freq": {
"description": "Frequency",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CompanyEarningsQualityScoreData"
},
"description": "Array of earnings quality score."
}
}
},
"CompanyEarningsQualityScoreData": {
"type": "object",
"properties": {
"period": {
"description": "Period",
"type": "string"
},
"growth": {
"description": "Growth Score",
"type": "number",
"format": "float"
},
"profitability": {
"description": "Profitability Score",
"type": "number",
"format": "float"
},
"cashGenerationCapitalAllocation": {
"description": "Cash Generation and Capital Allocation",
"type": "number",
"format": "float"
},
"leverage": {
"description": "Leverage Score",
"type": "number",
"format": "float"
},
"score": {
"description": "Total Score",
"type": "number",
"format": "float"
},
"letterScore": {
"description": "Letter Score",
"type": "string"
}
}
},
"CovidInfo": {
"type": "object",
"properties": {
"state": {
"description": "State.",
"type": "string"
},
"case": {
"description": "Number of confirmed cases.",
"type": "number",
"format": "float"
},
"death": {
"description": "Number of confirmed deaths.",
"type": "number",
"format": "float"
},
"updated": {
"description": "Updated time.",
"type": "string",
"formatIgnore": "date-time"
}
}
},
"FDAComitteeMeeting": {
"type": "object",
"properties": {
"fromDate": {
"description": "Start time of the event in EST.",
"type": "string",
"formatIgnore": "date-time"
},
"toDate": {
"description": "End time of the event in EST.",
"type": "string",
"formatIgnore": "date-time"
},
"eventDescription": {
"description": "Event's description.",
"type": "string"
},
"url": {
"description": "URL.",
"type": "string"
}
}
},
"CountryMetadata": {
"type": "object",
"properties": {
"country": {
"description": "Country name",
"type": "string"
},
"code2": {
"description": "Alpha 2 code",
"type": "string"
},
"code3": {
"description": "Alpha 3 code",
"type": "string"
},
"codeNo": {
"description": "UN code",
"type": "string"
},
"currency": {
"description": "Currency name",
"type": "string"
},
"currencyCode": {
"description": "Currency code",
"type": "string"
},
"region": {
"description": "Region",
"type": "string"
},
"subRegion": {
"description": "Sub-Region",
"type": "string"
},
"rating": {
"description": "Moody's credit risk rating.",
"type": "string"
},
"defaultSpread": {
"description": "Default spread",
"type": "number",
"format": "float"
},
"countryRiskPremium": {
"description": "Country risk premium",
"type": "number",
"format": "float"
},
"equityRiskPremium": {
"description": "Equity risk premium",
"type": "number",
"format": "float"
}
}
},
"Economic event": {
"type": "object",
"properties": {
"actual": {
"description": "Actual release",
"type": "number",
"format": "float"
},
"prev": {
"description": "Previous release",
"type": "number",
"format": "float"
},
"country": {
"description": "Country",
"type": "string"
},
"unit": {
"description": "Unit",
"type": "string"
},
"estimate": {
"description": "Estimate",
"type": "number",
"format": "float"
},
"event": {
"description": "Event",
"type": "string"
},
"impact": {
"description": "Impact level",
"type": "string"
},
"time": {
"description": "Release time",
"type": "string"
}
}
},
"EconomicCalendar": {
"type": "object",
"properties": {
"economicCalendar": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Economic event"
},
"description": "Array of economic events."
}
}
},
"EconomicCode": {
"type": "object",
"properties": {
"code": {
"description": "Finnhub economic code used to get historical data",
"type": "string"
},
"country": {
"description": "Country",
"type": "string"
},
"name": {
"description": "Indicator name",
"type": "string"
},
"unit": {
"description": "Unit",
"type": "string"
}
}
},
"EconomicDataInfo": {
"type": "object",
"properties": {
"date": {
"description": "Date of the reading",
"type": "string"
},
"value": {
"description": "Value",
"type": "number",
"format": "float"
}
}
},
"EconomicData": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EconomicDataInfo"
},
"description": "Array of economic data for requested code."
},
"code": {
"description": "Finnhub economic code",
"type": "string"
}
}
},
"MarketCapData": {
"type": "object",
"properties": {
"atDate": {
"description": "Date of the reading",
"type": "string"
},
"marketCapitalization": {
"description": "Value",
"type": "number",
"format": "float"
}
}
},
"HistoricalMarketCapData": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MarketCapData"
},
"description": "Array of market data."
},
"symbol": {
"description": "Symbol",
"type": "string"
},
"currency": {
"description": "Currency",
"type": "string"
}
}
},
"EmployeeCount": {
"type": "object",
"properties": {
"atDate": {
"description": "Date of the reading",
"type": "string"
},
"employee": {
"description": "Value",
"type": "number",
"format": "float"
}
}
},
"HistoricalEmployeeCount": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmployeeCount"
},
"description": "Array of market data."
},
"symbol": {
"description": "Symbol",
"type": "string"
}
}
},
"AirlinePriceIndex": {
"type": "object",
"properties": {
"date": {
"description": "Date",
"type": "string"
},
"priceIndex": {
"description": "Price Index",
"type": "number",
"format": "float"
},
"dailyAvgPrice": {
"description": "Daily average ticket price.",
"type": "number",
"format": "float"
}
}
},
"AirlinePriceIndexData": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AirlinePriceIndex"
},
"description": "Array of price index."
},
"airline": {
"description": "Airline name",
"type": "string"
},
"from": {
"description": "From date",
"type": "string"
},
"to": {
"description": "To date",
"type": "string"
}
}
},
"BankBranchRes": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BankBranchData"
},
"description": "Array of branches."
},
"symbol": {
"description": "Symbol",
"type": "string"
}
}
},
"BankBranchData": {
"type": "object",
"properties": {
"branchId": {
"type": "string",
"description": "Branch ID"
},
"address": {
"type": "string",
"description": "Branch address"
},
"state": {
"type": "string",
"description": "State"
},
"zipCode": {
"type": "string",
"description": " Zip code"
},
"date": {
"type": "string",
"description": "Date opened"
}
}
},
"BondYieldCurveInfo": {
"type": "object",
"properties": {
"d": {
"description": "Date of the reading",
"type": "string"
},
"v": {
"description": "Value",
"type": "number",
"format": "float"
}
}
},
"BondYieldCurve": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BondYieldCurveInfo"
},
"description": "Array of data."
},
"code": {
"description": "Bond's code",
"type": "string"
}
}
},
"UsptoPatentResult": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UsptoPatent"
},
"description": "Array of patents."
}
}
},
"UsptoPatent": {
"type": "object",
"properties": {
"applicationNumber": {
"description": "Application Number.",
"type": "string"
},
"companyFilingName": {
"type": "array",
"description": "Array of companies' name on the patent.",
"items": {
"type": "string"
}
},
"filingDate": {
"description": "Filing date.",
"type": "string"
},
"description": {
"description": "Description.",
"type": "string"
},
"filingStatus": {
"description": "Filing status.",
"type": "string"
},
"patentNumber": {
"description": "Patent number.",
"type": "string"
},
"publicationDate": {
"description": "Publication date.",
"type": "string"
},
"patentType": {
"description": "Patent's type.",
"type": "string"
},
"url": {
"description": "URL of the original article.",
"type": "string"
}
}
},
"VisaApplicationResult": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/VisaApplication"
},
"description": "Array of H1b and Permanent visa applications."
}
}
},
"LobbyingResult": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LobbyingData"
},
"description": "Array of lobbying activities."
}
}
},
"UsaSpendingResult": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UsaSpending"
},
"description": "Array of government's spending data points."
}
}
},
"UsaSpending": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"recipientName": {
"description": "Company's name.",
"type": "string"
},
"recipientParentName": {
"description": "Company's name.",
"type": "string"
},
"awardDescription": {
"description": "Description.",
"type": "string"
},
"country": {
"description": "Recipient's country.",
"type": "string"
},
"actionDate": {
"description": "Period.",
"type": "string"
},
"totalValue": {
"description": "Income reported by lobbying firms.",
"type": "number",
"format": "float"
},
"performanceStartDate": {
"description": "Performance start date.",
"type": "string"
},
"performanceEndDate": {
"description": "Performance end date.",
"type": "string"
},
"awardingAgencyName": {
"description": "Award agency.",
"type": "string"
},
"awardingSubAgencyName": {
"description": "Award sub-agency.",
"type": "string"
},
"awardingOfficeName": {
"description": "Award office name.",
"type": "string"
},
"performanceCountry": {
"description": "Performance country.",
"type": "string"
},
"performanceCity": {
"description": "Performance city.",
"type": "string"
},
"performanceCounty": {
"description": "Performance county.",
"type": "string"
},
"performanceState": {
"description": "Performance state.",
"type": "string"
},
"performanceZipCode": {
"description": "Performance zip code.",
"type": "string"
},
"performanceCongressionalDistrict": {
"description": "Performance congressional district.",
"type": "string"
},
"naicsCode": {
"description": "NAICS code.",
"type": "string"
},
"permalink": {
"description": "Permalink.",
"type": "string"
}
}
},
"LobbyingData": {
"type": "object",
"properties": {
"symbol": {
"description": "Symbol.",
"type": "string"
},
"name": {
"description": "Company's name.",
"type": "string"
},
"description": {
"description": "Description.",
"type": "string"
},
"country": {
"description": "Country.",
"type": "string"
},
"year": {
"description": "Year.",
"type": "integer",
"format": "int64"
},
"period": {
"description": "Period.",
"type": "string"
},
"income": {
"description": "Income reported by lobbying firms.",
"type": "number",
"format": "float"
},
"expenses": {
"description": "Expenses reported by the company.",
"type": "number",
"format": "float"
},
"documentUrl": {
"description": "Document's URL.",
"type": "string"
},
"postedName": {
"description": "Posted name.",
"type": "string"
},
"date": {
"description": "Date.",
"type": "string"
},
"clientId": {
"description": "Client ID.",
"type": "string"
},
"registrantId": {
"description": "Registrant ID.",
"type": "string"
},
"senateId": {
"description": "Senate ID.",
"type": "string"
},
"houseregistrantId": {
"description": "House registrant ID.",
"type": "string"
}
}
},
"BondProfile": {
"type": "object",
"properties": {
"isin": {
"description": "ISIN.",
"type": "string"
},
"cusip": {
"description": "Cusip.",
"type": "string"
},
"figi": {
"description": "FIGI.",
"type": "string"
},
"coupon": {
"description": "Coupon.",
"type": "number",
"format": "float"
},
"maturityDate": {
"description": "Period.",
"type": "string"
},
"offeringPrice": {
"description": "Offering price.",
"type": "number",
"format": "float"
},
"issueDate": {
"description": "Issue date.",
"type": "string"
},
"bondType": {
"description": "Bond type.",
"type": "string"
},
"debtType": {
"description": "Bond type.",
"type": "string"
},
"industryGroup": {
"description": "Industry.",
"type": "string"
},
"industrySubGroup": {
"description": "Sub-Industry.",
"type": "string"
},
"asset": {
"description": "Asset.",
"type": "string"
},
"assetType": {
"description": "Asset.",
"type": "string"
},
"datedDate": {
"description": "Dated date.",
"type": "string"
},
"firstCouponDate": {
"description": "First coupon date.",
"type": "string"
},
"originalOffering": {
"description": "Offering amount.",
"type": "number",
"format": "float"
},
"amountOutstanding": {
"description": "Outstanding amount.",
"type": "number",
"format": "float"
},
"paymentFrequency": {
"description": "Payment frequency.",
"type": "string"
},
"securityLevel": {
"description": "Security level.",
"type": "string"
},
"callable": {
"description": "Callable.",
"type": "boolean"
},
"couponType": {
"description": "Coupon type.",
"type": "string"
}
}
},
"BondCandles": {
"type": "object",
"properties": {
"c": {
"type": "array",
"description": "List of close prices for returned candles.",
"items": {
"type": "number",
"format": "float"
}
},
"t": {
"type": "array",
"description": "List of timestamp for returned candles.",
"items": {
"type": "integer",
"format": "int64"
}
},
"s": {
"description": "Status of the response. This field can either be ok or no_data.",
"type": "string"
}
}
},
"VisaApplication": {
"type": "object",
"properties": {
"year": {
"description": "Year.",
"type": "integer",
"format": "int64"
},
"quarter": {
"description": "Quarter.",
"type": "integer",
"format": "int64"
},
"symbol": {
"description": "Symbol.",
"type": "string"
},
"caseNumber": {
"description": "Case number.",
"type": "string"
},
"caseStatus": {
"description": "Case status.",
"type": "string"
},
"receivedDate": {
"description": "Received date.",
"type": "string"
},
"visaClass": {
"description": "Visa class.",
"type": "string"
},
"jobTitle": {
"description": "Job Title.",
"type": "string"
},
"socCode": {
"description": "SOC Code. A list of SOC code can be found <a href=\"https://www.bls.gov/oes/current/oes_stru.htm\" target=\"_blank\">here</a>.",
"type": "string"
},
"fullTimePosition": {
"description": "Full-time position flag.",
"type": "string"
},
"beginDate": {
"description": "Job's start date.",
"type": "string"
},
"endDate": {
"description": "Job's end date.",
"type": "string"
},
"employerName": {
"description": "Company's name.",
"type": "string"
},
"worksiteAddress": {
"description": "Worksite address.",
"type": "string"
},
"worksiteCity": {
"description": "Worksite city.",
"type": "string"
},
"worksiteCounty": {
"description": "Worksite county.",
"type": "string"
},
"worksiteState": {
"description": "Worksite state.",
"type": "string"
},
"worksitePostalCode": {
"description": "Worksite postal code.",
"type": "string"
},
"wageRangeFrom": {
"description": "Wage range from.",
"type": "number",
"format": "float"
},
"wageRangeTo": {
"description": "Wage range to.",
"type": "number",
"format": "float"
},
"wageUnitOfPay": {
"description": "Wage unit of pay.",
"type": "string"
},
"wageLevel": {
"description": "Wage level.",
"type": "string"
},
"h1bDependent": {
"description": "H1B dependent flag.",
"type": "string"
}
}
}
},
"securitySchemes": {
"api_key": {
"type": "apiKey",
"in": "query",
"name": "token"
}
}
},
"servers": [
{
"url": "https://finnhub.io/api/v1"
}
]
}