In-depth company and fund financials—income statements, balance sheets, cash flows, profiles, corporate events, and key ratios. Unlock comprehensive datasets for valuation, screening, and fundamental research.
The logo endpoint provides the official logo image for a specified company, cryptocurrency, or forex pair. This endpoint is useful for integrating visual branding elements into financial applications, websites, or reports, ensuring that users can easily identify and associate the correct logo with the respective financial asset.
Route
/logoAPI credits cost
1 per symbol
✱ symbol
stringThe ticker symbol of an instrument for which data is requested, e.g., AAPL, BTC/USD, EUR/USD.
Example:
BTC/USD
exchange
stringThe exchange name where the instrument is traded, e.g., NASDAQ, NSE
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON
Example:
XNAS
country
stringThe country where the instrument is traded, e.g., United States or US
Example:
United States
Request example
Response
{
"meta": {
"symbol": "BTC/USD",
"exchange": "Coinbase Pro"
},
"url": "https://api.twelvedata.com/logo/apple.com",
"logo_base": "https://logo.twelvedata.com/crypto/btc.png",
"logo_quote": "https://logo.twelvedata.com/crypto/usd.png"
}The profile endpoint provides detailed company information, including the company's name, industry, sector, CEO, and headquarters location. This data is useful for obtaining a comprehensive overview of a company's business and financial standing.
Route
/profileAPI credits cost
10 per symbol
symbol
stringSymbol ticker of instrument. For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
Request example
Response
{
"symbol": "AAPL",
"name": "Apple Inc",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"sector": "Technology",
"industry": "Consumer Electronics",
"employees": 147000,
"website": "http://www.apple.com",
"description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and...",
"type": "Common Stock",
"CEO": "Mr. Timothy D. Cook",
"address": "One Apple Park Way",
"address2": "Cupertino, CA 95014",
"city": "Cupertino",
"zip": "95014",
"state": "CA",
"country": "US",
"phone": "408-996-1010"
}The dividends endpoint provides historical dividend data for a specified stock, in many cases covering over a decade. It returns information on dividend payouts, including the ex-date, amount, and frequency. This endpoint is ideal for users tracking dividend histories or evaluating the income potential of stocks.
Route
/dividendsAPI credits cost
20 per symbol
symbol
stringSymbol ticker of instrument. For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
US
range
stringSpecifies the time range for which to retrieve dividend data.
Accepts values such as last (most recent dividend), next (upcoming dividend),
1m - 5y for respective periods, or full for all available data.
If provided together with start_date and/or end_date, this parameter takes precedence.
Supports: last, next, 1m, 3m, 6m, ytd, 1y, 2y, 5y, full
Default:
last
start_date
stringStart date for the dividend data query. Only dividends with dates on or after this date will be returned. Format 2006-01-02.
If provided together with range parameter, range will take precedence.
Example:
2024-01-01
end_date
stringEnd date for the dividend data query. Only dividends with dates on or before this date will be returned. Format 2006-01-02.
If provided together with range parameter, range will take precedence.
Example:
2024-12-31
adjust
booleanSpecifies if there should be an adjustment
Default:
true
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"dividends": [
{
"ex_date": "2021-08-06",
"amount": 0.22
}
]
}The dividends calendar endpoint provides a detailed schedule of upcoming and past dividend events for specified date ranges. By using the start_date and end_date parameters, users can retrieve a list of companies issuing dividends, including the ex-dividend date and dividend amount. This endpoint is ideal for tracking dividend payouts and planning investment strategies based on dividend schedules.
Route
/dividends_calendarAPI credits cost
40 per symbol
symbol
stringSymbol ticker of instrument. For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
US
start_date
stringStart date for the dividends calendar query. Only dividends with ex-dates on or after this date will be returned. Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for the dividends calendar query. Only dividends with ex-dates on or before this date will be returned. Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of data points to retrieve.
Supports values in the range from 1 to 500.
Default 100 when no date parameters are set, otherwise set to maximum
Default:
100
page
integerPage number
Default:
1
Response
[
{
"symbol": "MSFT",
"mic_code": "XNGS",
"exchange": "NASDAQ",
"ex_date": "2024-02-14",
"amount": 0.75
}
]The splits endpoint provides historical data on stock split events for a specified company. It returns details including the date of each split and the corresponding split factor.
Route
/splitsAPI credits cost
20 per symbol
symbol
stringSymbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
range
stringRange of data to be returned
Supports: last, 1m, 3m, 6m, ytd, 1y, 2y, 5y, full
Default:
last
start_date
stringThe starting date for data selection. Format 2006-01-02
Example:
2020-01-01
end_date
stringThe ending date for data selection. Format 2006-01-02
Example:
2020-12-31
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"splits": [
{
"date": "2020-08-31",
"description": "4-for-1 split",
"ratio": 0.25,
"from_factor": 4,
"to_factor": 1
}
]
}The splits calendar endpoint provides a detailed calendar of stock split events within a specified date range. By setting the start_date and end_date parameters, users can retrieve a list of upcoming or past stock splits, including the company name, split ratio, and effective date. This endpoint is useful for tracking changes in stock structure and planning investment strategies around these events.
Route
/splits_calendarAPI credits cost
40 per symbol
symbol
stringSymbol ticker of instrument. For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
start_date
stringThe starting date (inclusive) for filtering split events in the calendar. Format 2006-01-02
Example:
2024-01-01
end_date
stringThe ending date (inclusive) for filtering split events in the calendar. Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of data points to retrieve. Supports values in the range from 1 to 500. Default 100 when no date parameters are set, otherwise set to maximum
Default:
100
page
stringPage number
Default:
1
Request example
Response
[
{
"date": "1987-06-16",
"symbol": "AAPL",
"mic_code": "XNGS",
"exchange": "NASDAQ",
"description": "2-for-1 split",
"ratio": 0.5,
"from_factor": 2,
"to_factor": 1
}
]The earnings endpoint provides comprehensive earnings data for a specified company, including both the estimated and actual Earnings Per Share (EPS) figures. This endpoint delivers historical earnings information, allowing users to track a company's financial performance over time.
Route
/earningsAPI credits cost
20 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
Common Stock
period
stringType of earning, returns only 1 record. When is not empty, dates and outputsize parameters are ignored
Supports: latest, next
outputsize
integerNumber of data points to retrieve.
Supports values in the range from 1 to 1000.
Default 10 when no date parameters are set, otherwise set to maximum
Default:
10
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
dp
integerThe number of decimal places in the response data. Should be in range [0,11] inclusive
Default:
2
start_date
stringThe date from which the data is requested. The date format is YYYY-MM-DD.
Example:
2024-04-01
end_date
stringThe date to which the data is requested. The date format is YYYY-MM-DD.
Example:
2024-04-30
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"earnings": [
{
"date": "2020-04-30",
"time": "After Hours",
"eps_estimate": 2.09,
"eps_actual": 2.55,
"difference": 0.46,
"surprise_prc": 22.01
}
],
"status": "ok"
}The earnings calendar endpoint provides a schedule of company earnings announcements for a specified date range. By default, it returns earnings data for the current day. Users can customize the date range using the start_date and end_date parameters to retrieve earnings information for specific periods. This endpoint is useful for tracking upcoming earnings reports and planning around key financial announcements.
Route
/earnings_calendarAPI credits cost
40 per request
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
format
stringValue can be JSON or CSV
Supports: JSON, CSV
Default:
JSON
delimiter
stringSpecify the delimiter used when downloading the CSV file
Default:
;
dp
integerSpecifies the number of decimal places for floating values. Should be in range [0,11] inclusive
Default:
2
start_date
stringCan be used separately and together with end_date.
Format 2006-01-02 or 2006-01-02T15:04:05
Example:
2024-04-01
end_date
stringCan be used separately and together with start_date.
Format 2006-01-02 or 2006-01-02T15:04:05
Example:
2024-04-30
Request example
Response
{
"earnings": {
"2020-04-30": [
{
"symbol": "BR",
"name": "Broadridge Financial Solutions Inc",
"currency": "USD",
"exchange": "NYSE",
"mic_code": "XNYS",
"country": "United States",
"time": "Time Not Supplied",
"eps_estimate": 1.72,
"eps_actual": 1.67,
"difference": -0.05,
"surprise_prc": -2.9
}
]
},
"status": "ok"
}The IPO Calendar endpoint provides detailed information on initial public offerings (IPOs), including those that have occurred in the past, are happening today, or are scheduled for the future. Users can access data such as company names, IPO dates, and offering details, allowing them to track and monitor IPO activity efficiently.
Route
/ipo_calendarAPI credits cost
40 per request
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
start_date
stringThe earliest IPO date to include in the results. Format: 2006-01-02
Example:
2021-01-01
end_date
stringThe latest IPO date to include in the results. Format: 2006-01-02
Example:
2021-12-31
Request example
Response
{
"2025-07-16": [
{
"symbol": "DWACU",
"name": "Digital World Acquisition Corp.",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"price_range_low": 10,
"price_range_high": 10,
"offer_price": 0,
"currency": "USD",
"shares": 0
}
]
}The statistics endpoint provides a comprehensive snapshot of a company's key financial statistics, including valuation metrics, revenue figures, profit margins, and other essential financial data. This endpoint is ideal for users seeking detailed insights into a company's financial health and performance metrics.
Route
/statisticsAPI credits cost
50 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"statistics": {
"valuations_metrics": {
"market_capitalization": 2546807865344,
"enterprise_value": 2620597731328,
"trailing_pe": 30.162493,
"forward_pe": 26.982489,
"peg_ratio": 1.4,
"price_to_sales_ttm": 7.336227,
"price_to_book_mrq": 39.68831,
"enterprise_to_revenue": 7.549,
"enterprise_to_ebitda": 23.623
},
"financials": {
"fiscal_year_ends": "2020-09-26",
"most_recent_quarter": "2021-06-26",
"gross_margin": 46.57807,
"profit_margin": 0.25004,
"operating_margin": 0.28788,
"return_on_assets_ttm": 0.19302,
"return_on_equity_ttm": 1.27125,
"income_statement": {
"revenue_ttm": 347155005440,
"revenue_per_share_ttm": 20.61,
"quarterly_revenue_growth": 0.364,
"gross_profit_ttm": 104956000000,
"ebitda": 110934999040,
"net_income_to_common_ttm": 86801997824,
"diluted_eps_ttm": 5.108,
"quarterly_earnings_growth_yoy": 0.932
},
"balance_sheet": {
"total_cash_mrq": 61696000000,
"total_cash_per_share_mrq": 3.732,
"total_debt_mrq": 135491002368,
"total_debt_to_equity_mrq": 210.782,
"current_ratio_mrq": 1.062,
"book_value_per_share_mrq": 3.882
},
"cash_flow": {
"operating_cash_flow_ttm": 104414003200,
"levered_free_cash_flow_ttm": 80625876992
}
},
"stock_statistics": {
"shares_outstanding": 16530199552,
"float_shares": 16513305231,
"avg_10_volume": 72804757,
"avg_90_volume": 77013078,
"shares_short": 93105968,
"short_ratio": 1.19,
"short_percent_of_shares_outstanding": 0.0056,
"percent_held_by_insiders": 0.00071000005,
"percent_held_by_institutions": 0.58474
},
"stock_price_summary": {
"fifty_two_week_low": 103.1,
"fifty_two_week_high": 157.26,
"fifty_two_week_change": 0.375625,
"beta": 1.201965,
"day_50_ma": 148.96686,
"day_200_ma": 134.42506
},
"dividends_and_splits": {
"forward_annual_dividend_rate": 0.88,
"forward_annual_dividend_yield": 0.0057,
"trailing_annual_dividend_rate": 0.835,
"trailing_annual_dividend_yield": 0.0053832764,
"5_year_average_dividend_yield": 1.27,
"payout_ratio": 0.16309999,
"dividend_frequency": "Quarterly",
"dividend_date": "2021-08-12",
"ex_dividend_date": "2021-08-06",
"last_split_factor": "4-for-1 split",
"last_split_date": "2020-08-31"
}
}
}The press releases endpoint offers structured, real-time access to official company press releases and corporate announcements from public entities across global markets.
Route
/press_releasesAPI credits cost
1 per request
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
start_date
stringBegin date for filtering items.
Returns press releases with release date on or after this date. Format 2025-12-24T02:07:00
Example:
2025-12-01T00:00:00
end_date
stringEnd date for filtering items.
Returns press releases with release date on or before this date. Format 2025-12-24T02:07:00
Example:
2025-12-31T23:59:00
language
stringComma-separated list of languages to filter press releases by language.
Example:
en,en-US
timezone
stringTime zone for date filtering. Default is the identifier time zone.
Example:
America/New_York
outputsize
integerNumber of press releases returned per page. Default is 2, maximum is 10.
type: number
Default:
2
page
integerPage number to return, starting at 1. Use it together with outputsize to walk the result set.
type: number
Default:
1
Response
{
"press_releases": [
{
"id": "20251201SF35699",
"datetime": "2021-11-12T11:21:00+01:00",
"title": "NVIDIA and Synopsys Announce Strategic Partnership to Revolutionize Engineering and Design",
"body": "<b>Key Highlights</b><ul><li>Multi-year collaboration spans NVIDIA CUDA accelerated computing, agentic and physical AI, and Omniverse digital twins to achieve simulation speed and scale previously unattainable through traditional CPU computing \u2013 opening new market opportunities across engineering.</li><li>To further adoption of GPU-accelerated engineering solutions, the companies will collaborate in engineering and marketing activities.</li><li>NVIDIA invested $2 billion in Synopsys common stock.</li></ul>...",
"style": "/* Style Definitions */ ...",
"language": [
"en",
"en-US"
]
}
],
"status": "ok",
"pagination": {
"current_page": 1,
"per_page": 10
}
}The income statement endpoint provides detailed financial data on a company's income statement, including revenues, expenses, and net income for specified periods, either annually or quarterly. This endpoint is essential for retrieving comprehensive financial performance metrics of a company, allowing users to access historical and current financial results.
Route
/income_statementAPI credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the income statement data
Supports: annual, quarterly
Example:
annual
start_date
stringBegin date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or after this date.
Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or before this date.
Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of records in response
Default:
6
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York",
"period": "Quarterly"
},
"income_statement": [
{
"fiscal_date": "2021-12-31",
"quarter": 1,
"year": 2022,
"sales": 123945000000,
"cost_of_goods": 69702000000,
"gross_profit": 54243000000,
"operating_expense": {
"research_and_development": 6306000000,
"selling_general_and_administrative": 6449000000,
"other_operating_expenses": 0
},
"operating_income": 41488000000,
"non_operating_interest": {
"income": 650000000,
"expense": 694000000
},
"other_income_expense": -203000000,
"pretax_income": 41241000000,
"income_tax": 6611000000,
"net_income": 34630000000,
"eps_basic": 2.11,
"eps_diluted": 2.1,
"basic_shares_outstanding": 16391724000,
"diluted_shares_outstanding": 16391724000,
"ebit": 41488000000,
"ebitda": 44632000000,
"net_income_continuous_operations": 0,
"minority_interests": 0,
"preferred_stock_dividends": 0
}
]
}The income statement consolidated endpoint provides a company's raw income statement, detailing revenue, expenses, and net income for specified periods, either annually or quarterly. This data is essential for evaluating a company's financial performance over time, allowing users to access comprehensive financial results in a structured format.
Route
/income_statement/consolidatedAPI credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the income statement data
Supports: annual, quarterly
start_date
stringBegin date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or after this date.
Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or before this date.
Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of records in response
Default:
6
Response
{
"income_statement": [
{
"fiscal_date": "2023-09-30",
"year": 2022,
"revenue": {
"total_revenue": 383285000000,
"operating_revenue": 383285000000
},
"gross_profit": {
"gross_profit_value": 169148000000,
"cost_of_revenue": {
"cost_of_revenue_value": 214137000000,
"excise_taxes": 214137000000,
"reconciled_cost_of_revenue": 214137000000
}
},
"operating_income": {
"operating_income_value": 114301000000,
"total_operating_income_as_reported": 114301000000,
"operating_expense": 54847000000,
"other_operating_expenses": 114301000000,
"total_expenses": 268984000000
},
"net_income": {
"net_income_value": 96995000000,
"net_income_common_stockholders": 96995000000,
"net_income_including_noncontrolling_interests": 96995000000,
"net_income_from_tax_loss_carryforward": 96995000000,
"net_income_extraordinary": 96995000000,
"net_income_discontinuous_operations": 96995000000,
"net_income_continuous_operations": 96995000000,
"net_income_from_continuing_operation_net_minority_interest": 96995000000,
"net_income_from_continuing_and_discontinued_operation": 96995000000,
"normalized_income": 96995000000,
"minority_interests": 96995000000
},
"earnings_per_share": {
"diluted_eps": 6.13,
"basic_eps": 6.16,
"continuing_and_discontinued_diluted_eps": 6.16,
"continuing_and_discontinued_basic_eps": 6.16,
"normalized_diluted_eps": 6.16,
"normalized_basic_eps": 6.16,
"reported_normalized_diluted_eps": 6.16,
"reported_normalized_basic_eps": 6.16,
"diluted_eps_other_gains_losses": 6.16,
"tax_loss_carryforward_diluted_eps": 6.16,
"diluted_accounting_change": 6.16,
"diluted_extraordinary": 6.16,
"diluted_discontinuous_operations": 6.16,
"diluted_continuous_operations": 6.16,
"basic_eps_other_gains_losses": 6.16,
"tax_loss_carryforward_basic_eps": 6.16,
"basic_accounting_change": 6.16,
"basic_extraordinary": 6.16,
"basic_discontinuous_operations": 6.16,
"basic_continuous_operations": 6.16,
"diluted_ni_avail_to_common_stockholders": 96995000000,
"average_dilution_earnings": 96995000000
},
"expenses": {
"total_expenses": 268984000000,
"selling_general_and_administration_expense": 24932000000,
"selling_and_marketing_expense": 24932000000,
"general_and_administrative_expense": 24932000000,
"other_general_and_administrative_expense": 24932000000,
"depreciation_amortization_depletion_income_statement": 29915000000,
"research_and_development_expense": 29915000000,
"insurance_and_claims_expense": 29915000000,
"rent_and_landing_fees": 29915000000,
"salaries_and_wages_expense": 29915000000,
"rent_expense_supplemental": 29915000000,
"provision_for_doubtful_accounts": 29915000000
},
"interest_income_and_expense": {
"interest_income": 3750000000,
"interest_expense": 3933000000,
"net_interest_income": -183000000,
"net_non_operating_interest_income_expense": -183000000,
"interest_expense_non_operating": 3933000000,
"interest_income_non_operating": 3750000000
},
"other_income_and_expenses": {
"other_income_expense": -382000000,
"other_non_operating_income_expenses": -382000000,
"special_income_charges": 382000000,
"gain_on_sale_of_ppe": 382000000,
"gain_on_sale_of_business": 382000000,
"gain_on_sale_of_security": 382000000,
"other_special_charges": 382000000,
"write_off": 382000000,
"impairment_of_capital_assets": 382000000,
"restructuring_and_merger_acquisition": 382000000,
"securities_amortization": 382000000,
"earnings_from_equity_interest": 382000000,
"earnings_from_equity_interest_net_of_tax": 382000000,
"total_other_finance_cost": 382000000
},
"taxes": {
"tax_provision": 16741000000,
"tax_effect_of_unusual_items": 0,
"tax_rate_for_calculations": 0.147,
"other_taxes": 0
},
"depreciation_and_amortization": {
"depreciation_amortization_depletion": 129188000000,
"amortization_of_intangibles": 129188000000,
"depreciation": 129188000000,
"amortization": 129188000000,
"depletion": 129188000000,
"depreciation_and_amortization_in_income_statement": 129188000000
},
"ebitda": {
"ebitda_value": 129188000000,
"normalized_ebitda_value": 129188000000,
"ebit_value": 117669000000
},
"dividends_and_shares": {
"dividend_per_share": 15812547000,
"diluted_average_shares": 15812547000,
"basic_average_shares": 15744231000,
"preferred_stock_dividends": 15744231000,
"other_under_preferred_stock_dividend": 15744231000
},
"unusual_items": {
"total_unusual_items": 11519000000,
"total_unusual_items_excluding_goodwill": 11519000000
},
"depreciation": {
"reconciled_depreciation": 11519000000
},
"pretax_income": {
"pretax_income_value": 113736000000
},
"special_income_charges": {
"special_income_charges_value": 113736000000
}
}
],
"status": "ok"
}The balance sheet endpoint provides a detailed financial statement for a company, outlining its assets, liabilities, and shareholders' equity. This endpoint returns structured data that includes current and non-current assets, total liabilities, and equity figures, enabling users to assess a company's financial health and stability.
Route
/balance_sheetAPI credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the balance sheet data
Supports: annual, quarterly
Default:
annual
start_date
stringBegin date for filtering items by fiscal date.
Returns income statements with fiscal dates on or after this date. Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering items by fiscal date.
Returns income statements with fiscal dates on or before this date. Format 2006-01-02
Example:
2024-05-01
outputsize
integerNumber of records in response
Default:
6
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York",
"period": "Quarterly"
},
"balance_sheet": [
{
"fiscal_date": "2021-09-30",
"year": 2022,
"assets": {
"current_assets": {
"cash": 17305000000,
"cash_equivalents": 17635000000,
"cash_and_cash_equivalents": 34940000000,
"other_short_term_investments": 27699000000,
"accounts_receivable": 26278000000,
"other_receivables": 25228000000,
"inventory": 6580000000,
"prepaid_assets": 0,
"restricted_cash": 0,
"assets_held_for_sale": 0,
"hedging_assets": 0,
"other_current_assets": 14111000000,
"total_current_assets": 134836000000
},
"non_current_assets": {
"properties": 0,
"land_and_improvements": 20041000000,
"machinery_furniture_equipment": 78659000000,
"construction_in_progress": 0,
"leases": 11023000000,
"accumulated_depreciation": -70283000000,
"goodwill": 0,
"investment_properties": 0,
"financial_assets": 0,
"intangible_assets": 0,
"investments_and_advances": 127877000000,
"other_non_current_assets": 48849000000,
"total_non_current_assets": 216166000000
},
"total_assets": 351002000000
},
"liabilities": {
"current_liabilities": {
"accounts_payable": 54763000000,
"accrued_expenses": 0,
"short_term_debt": 15613000000,
"deferred_revenue": 7612000000,
"tax_payable": 0,
"pensions": 0,
"other_current_liabilities": 47493000000,
"total_current_liabilities": 125481000000
},
"non_current_liabilities": {
"long_term_provisions": 0,
"long_term_debt": 109106000000,
"provision_for_risks_and_charges": 24689000000,
"deferred_liabilities": 0,
"derivative_product_liabilities": 0,
"other_non_current_liabilities": 28636000000,
"total_non_current_liabilities": 162431000000
},
"total_liabilities": 287912000000
},
"shareholders_equity": {
"common_stock": 57365000000,
"retained_earnings": 5562000000,
"other_shareholders_equity": 163000000,
"total_shareholders_equity": 63090000000,
"additional_paid_in_capital": 0,
"treasury_stock": 0,
"minority_interest": 0
}
}
]
}The balance sheet consolidated endpoint provides a detailed overview of a company's raw balance sheet, including a comprehensive summary of its assets, liabilities, and shareholders' equity. This endpoint is useful for retrieving financial data that reflects the overall financial position of a company, allowing users to access critical information about its financial health and structure.
Route
/balance_sheet/consolidatedAPI credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the balance sheet data.
Supports: annual, quarterly
Default:
annual
start_date
stringBegin date for filtering items by fiscal date. Returns income statements with fiscal dates on or after this date.
Format 2006-01-02
end_date
stringEnd date for filtering items by fiscal date. Returns income statements with fiscal dates on or before this date.
Format 2006-01-02
outputsize
integerNumber of records in response
Default:
6
Response
{
"balance_sheet": [
{
"fiscal_date": "2023-09-30",
"assets": {
"total_assets": 352583000000,
"current_assets": {
"total_current_assets": 143566000000,
"cash_cash_equivalents_and_short_term_investments": 61555000000,
"cash_and_cash_equivalents": 29965000000,
"cash_equivalents": 1606000000,
"cash_financial": 28359000000,
"other_short_term_investments": 31590000000,
"restricted_cash": 31590000000,
"receivables": {
"total_receivables": 60985000000,
"accounts_receivable": 29508000000,
"gross_accounts_receivable": 29508000000,
"allowance_for_doubtful_accounts_receivable": 29508000000,
"receivables_adjustments_allowances": 29508000000,
"other_receivables": 31477000000,
"due_from_related_parties_current": 31477000000,
"taxes_receivable": 31477000000,
"accrued_interest_receivable": 31477000000,
"notes_receivable": 31477000000,
"loans_receivable": 31477000000
},
"inventory": {
"total_inventory": 6331000000,
"inventories_adjustments_allowances": 6331000000,
"other_inventories": 6331000000,
"finished_goods": 6331000000,
"work_in_process": 6331000000,
"raw_materials": 6331000000
},
"prepaid_assets": 14695000000,
"current_deferred_assets": 14695000000,
"current_deferred_taxes_assets": 14695000000,
"assets_held_for_sale_current": 14695000000,
"hedging_assets_current": 14695000000,
"other_current_assets": 14695000000
},
"non_current_assets": {
"total_non_current_assets": 209017000000,
"financial_assets": 209017000000,
"investments_and_advances": 100544000000,
"other_investments": 100544000000,
"investment_in_financial_assets": 100544000000,
"held_to_maturity_securities": 100544000000,
"available_for_sale_securities": 100544000000,
"financial_assets_designated_as_fair_value_through_profit_or_loss_total": 100544000000,
"trading_securities": 100544000000,
"long_term_equity_investment": 100544000000,
"investments_in_joint_ventures_at_cost": 100544000000,
"investments_in_other_ventures_under_equity_method": 100544000000,
"investments_in_associates_at_cost": 100544000000,
"investments_in_subsidiaries_at_cost": 100544000000,
"investment_properties": 100544000000,
"goodwill_and_other_intangible_assets": {
"goodwill": 100544000000,
"other_intangible_assets": 100544000000,
"total_goodwill_and_intangible_assets": 100544000000
},
"net_ppe": 54376000000,
"gross_ppe": 125260000000,
"accumulated_depreciation": -70884000000,
"leases": 12839000000,
"construction_in_progress": 12839000000,
"other_properties": 10661000000,
"machinery_furniture_equipment": 78314000000,
"buildings_and_improvements": 12839000000,
"land_and_improvements": 23446000000,
"properties": 0,
"non_current_accounts_receivable": 12839000000,
"non_current_note_receivables": 12839000000,
"due_from_related_parties_non_current": 12839000000,
"non_current_prepaid_assets": 12839000000,
"non_current_deferred_assets": 17852000000,
"non_current_deferred_taxes_assets": 17852000000,
"defined_pension_benefit": 12839000000,
"other_non_current_assets": 36245000000
},
"liabilities": {
"total_liabilities_net_minority_interest": 290437000000,
"current_liabilities": {
"total_current_liabilities": 145308000000,
"current_debt_and_capital_lease_obligation": 17382000000,
"current_debt": 15807000000,
"current_capital_lease_obligation": 1575000000,
"other_current_borrowings": 9822000000,
"line_of_credit": 9822000000,
"commercial_paper": 5985000000,
"current_notes_payable": 9822000000,
"current_provisions": 9822000000,
"payables_and_accrued_expenses": {
"total_payables_and_accrued_expenses": 71430000000,
"accounts_payable": 62611000000,
"current_accrued_expenses": 9822000000,
"interest_payable": 9822000000,
"payables": 71430000000,
"other_payable": 9822000000,
"due_to_related_parties_current": 9822000000,
"dividends_payable": 9822000000,
"total_tax_payable": 8819000000,
"income_tax_payable": 8819000000
},
"pension_and_other_post_retirement_benefit_plans_current": 8061000000,
"employee_benefits": 8061000000,
"current_deferred_liabilities": 8061000000,
"current_deferred_revenue": 8061000000,
"current_deferred_taxes_liabilities": 8061000000,
"other_current_liabilities": 48435000000,
"liabilities_held_for_sale_non_current": 48435000000
},
"non_current_liabilities": {
"total_non_current_liabilities_net_minority_interest": 145129000000,
"long_term_debt_and_capital_lease_obligation": {
"total_long_term_debt_and_capital_lease_obligation": 106548000000,
"long_term_debt": 95281000000,
"long_term_capital_lease_obligation": 11267000000
},
"long_term_provisions": 15457000000,
"non_current_pension_and_other_postretirement_benefit_plans": 15457000000,
"non_current_accrued_expenses": 15457000000,
"due_to_related_parties_non_current": 15457000000,
"trade_and_other_payables_non_current": 15457000000,
"non_current_deferred_liabilities": 15457000000,
"non_current_deferred_revenue": 15457000000,
"non_current_deferred_taxes_liabilities": 15457000000,
"other_non_current_liabilities": 23124000000,
"preferred_securities_outside_stock_equity": 15457000000,
"derivative_product_liabilities": 15457000000,
"capital_lease_obligations": 12842000000,
"restricted_common_stock": 12842000000
},
"equity": {
"total_equity_gross_minority_interest": 62146000000,
"stockholders_equity": 62146000000,
"common_stock_equity": 62146000000,
"preferred_stock_equity": 62146000000,
"other_equity_interest": 62146000000,
"minority_interest": 62146000000,
"total_capitalization": 157427000000,
"net_tangible_assets": 62146000000,
"tangible_book_value": 62146000000,
"invested_capital": 173234000000,
"working_capital": -1742000000,
"capital_stock": {
"common_stock": 73812000000,
"preferred_stock": 73812000000,
"total_partnership_capital": 73812000000,
"general_partnership_capital": 73812000000,
"limited_partnership_capital": 73812000000,
"capital_stock": 73812000000,
"other_capital_stock": 73812000000,
"additional_paid_in_capital": 73812000000,
"retained_earnings": -214000000,
"treasury_stock": 73812000000,
"treasury_shares_number": 0,
"ordinary_shares_number": 15550061000,
"preferred_shares_number": 73812000000,
"share_issued": 15550061000
},
"equity_adjustments": {
"gains_losses_not_affecting_retained_earnings": -11452000000,
"other_equity_adjustments": -11452000000,
"fixed_assets_revaluation_reserve": 11452000000,
"foreign_currency_translation_adjustments": 11452000000,
"minimum_pension_liabilities": 11452000000,
"unrealized_gain_loss": 11452000000
},
"net_debt": 81123000000,
"total_debt": 123930000000
}
}
}
}
],
"status": "ok"
}The cash flow endpoint provides detailed information on a company's cash flow activities, including the net cash and cash equivalents moving in and out of the business. This data includes operating, investing, and financing cash flows, offering a comprehensive view of the company's liquidity and financial health.
Route
/cash_flowAPI credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the cash flow statements
Supports: annual, quarterly
Default:
annual
start_date
stringStart date for filtering cash flow statements.
Only cash flow statements with fiscal dates on or after this date will be included.
Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering cash flow statements.
Only cash flow statements with fiscal dates on or before this date will be included.
Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of records in response
Default:
6
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York",
"period": "Quarterly"
},
"cash_flow": [
{
"fiscal_date": "2021-12-31",
"quarter": "1",
"year": 2022,
"operating_activities": {
"net_income": 34630000000,
"depreciation": 2697000000,
"deferred_taxes": 682000000,
"stock_based_compensation": 2265000000,
"other_non_cash_items": 167000000,
"accounts_receivable": -13746000000,
"accounts_payable": 19813000000,
"other_assets_liabilities": 458000000,
"operating_cash_flow": 46966000000
},
"investing_activities": {
"capital_expenditures": -2803000000,
"net_intangibles": 0,
"net_acquisitions": 0,
"purchase_of_investments": -34913000000,
"sale_of_investments": 21984000000,
"other_investing_activity": -374000000,
"investing_cash_flow": -16106000000
},
"financing_activities": {
"long_term_debt_issuance": 0,
"long_term_debt_payments": 0,
"short_term_debt_issuance": -1000000000,
"common_stock_issuance": 0,
"common_stock_repurchase": -20478000000,
"common_dividends": -3732000000,
"other_financing_charges": -2949000000,
"financing_cash_flow": -28159000000
},
"end_cash_position": 38630000000,
"income_tax_paid": 5235000000,
"interest_paid": 531000000,
"free_cash_flow": 49769000000
}
]
}The cash flow consolidated endpoint provides raw data on a company's consolidated cash flow, including the net cash and cash equivalents moving in and out of the business. It returns information on operating, investing, and financing activities, helping users track liquidity and financial health over a specified period.
Route
/cash_flow/consolidatedAPI credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the cash flow statements
Supports: annual, quarterly
Default:
annual
start_date
stringStart date for filtering cash flow statements. Only cash flow statements with fiscal dates on or after this date will be included.
Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering cash flow statements. Only cash flow statements with fiscal dates on or before this date will be included.
Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of records in response
Default:
6
Response
{
"cash_flow": [
{
"fiscal_date": "2023-09-30",
"year": 2024,
"cash_flow_from_operating_activities": {
"net_income_from_continuing_operations": 96995000000,
"operating_cash_flow": 110543000000,
"cash_flow_from_continuing_operating_activities": 110543000000,
"cash_from_discontinued_operating_activities": 108488000000,
"cash_flow_from_discontinued_operation": 108488000000,
"free_cash_flow": 99584000000,
"cash_flows_from_used_in_operating_activities_direct": 108488000000,
"taxes_refund_paid": 108488000000,
"taxes_refund_paid_direct": 108488000000,
"interest_received": 108488000000,
"interest_received_direct": 108488000000,
"interest_paid": 108488000000,
"interest_paid_direct": 108488000000,
"dividend_received": 108488000000,
"dividend_received_direct": 108488000000,
"dividend_paid": 108488000000,
"dividend_paid_direct": 108488000000,
"change_in_working_capital": -6577000000,
"change_in_other_working_capital": 108488000000,
"change_in_receivables": -417000000,
"changes_in_account_receivables": -1688000000,
"change_in_payables_and_accrued_expense": -1889000000,
"change_in_accrued_expense": 108488000000,
"change_in_payable": -1889000000,
"change_in_dividend_payable": 108488000000,
"change_in_account_payable": -1889000000,
"change_in_tax_payable": 108488000000,
"change_in_income_tax_payable": 108488000000,
"change_in_interest_payable": 108488000000,
"change_in_other_current_liabilities": 3031000000,
"change_in_other_current_assets": -5684000000,
"change_in_inventory": -1618000000,
"change_in_prepaid_assets": 108488000000,
"other_non_cash_items": -2227000000,
"excess_tax_benefit_from_stock_based_compensation": 108488000000,
"stock_based_compensation": 10833000000,
"unrealized_gain_loss_on_investment_securities": 108488000000,
"provision_and_write_off_of_assets": 108488000000,
"asset_impairment_charge": 108488000000,
"amortization_of_securities": 108488000000,
"deferred_tax": 108488000000,
"deferred_income_tax": 108488000000,
"depreciation_amortization_depletion": 11519000000,
"depletion": 108488000000,
"depreciation_and_amortization": 11519000000,
"amortization_cash_flow": 108488000000,
"amortization_of_intangibles": 108488000000,
"depreciation": 108488000000,
"operating_gains_losses": 108488000000,
"pension_and_employee_benefit_expense": 108488000000,
"earnings_losses_from_equity_investments": 108488000000,
"gain_loss_on_investment_securities": 108488000000,
"net_foreign_currency_exchange_gain_loss": 108488000000,
"gain_loss_on_sale_of_ppe": 108488000000,
"gain_loss_on_sale_of_business": 108488000000
},
"cash_flow_from_investing_activities": {
"investing_cash_flow": 3705000000,
"cash_flow_from_continuing_investing_activities": 3705000000,
"cash_from_discontinued_investing_activities": 108488000000,
"net_other_investing_changes": -1337000000,
"interest_received_cfi": 108488000000,
"dividends_received_cfi": 108488000000,
"net_investment_purchase_and_sale": 16001000000,
"sale_of_investment": 45514000000,
"purchase_of_investment": -29513000000,
"net_investment_properties_purchase_and_sale": 108488000000,
"sale_of_investment_properties": 108488000000,
"purchase_of_investment_properties": 108488000000,
"net_business_purchase_and_sale": 108488000000,
"sale_of_business": 108488000000,
"purchase_of_business": 108488000000,
"net_intangibles_purchase_and_sale": 108488000000,
"sale_of_intangibles": 108488000000,
"purchase_of_intangibles": 108488000000,
"net_ppe_purchase_and_sale": -10959000000,
"sale_of_ppe": 108488000000,
"purchase_of_ppe": -10959000000,
"capital_expenditure_reported": 108488000000,
"capital_expenditure": -10959000000
},
"cash_flow_from_financing_activities": {
"financing_cash_flow": -108488000000,
"cash_flow_from_continuing_financing_activities": -108488000000,
"cash_from_discontinued_financing_activities": 108488000000,
"net_other_financing_charges": -6012000000,
"interest_paid_cff": 108488000000,
"proceeds_from_stock_option_exercised": 108488000000,
"cash_dividends_paid": -15025000000,
"preferred_stock_dividend_paid": 108488000000,
"common_stock_dividend_paid": -15025000000,
"net_preferred_stock_issuance": 108488000000,
"preferred_stock_payments": 108488000000,
"preferred_stock_issuance": 108488000000,
"net_common_stock_issuance": -77550000000,
"common_stock_payments": -77550000000,
"common_stock_issuance": 108488000000,
"repurchase_of_capital_stock": -77550000000,
"net_issuance_payments_of_debt": -9901000000,
"net_short_term_debt_issuance": -3978000000,
"short_term_debt_payments": 108488000000,
"short_term_debt_issuance": 108488000000,
"net_long_term_debt_issuance": -5923000000,
"long_term_debt_payments": -11151000000,
"long_term_debt_issuance": 5228000000,
"issuance_of_debt": 5228000000,
"repayment_of_debt": -11151000000,
"issuance_of_capital_stock": 108488000000
},
"supplemental_data": {
"interest_paid_supplemental_data": 3803000000,
"income_tax_paid_supplemental_data": 18679000000
},
"foreign_and_domestic_sales": {
"foreign_sales": 108488000000,
"domestic_sales": 108488000000,
"adjusted_geography_segment_data": 108488000000
},
"cash_position": {
"beginning_cash_position": 24977000000,
"end_cash_position": 30737000000,
"changes_in_cash": 5760000000,
"other_cash_adjustment_outside_change_in_cash": 108488000000,
"other_cash_adjustment_inside_change_in_cash": 108488000000,
"effect_of_exchange_rate_changes": 108488000000
},
"direct_method_cash_flow": {
"classes_of_cash_receipts_from_operating_activities": 108488000000,
"other_cash_receipts_from_operating_activities": 108488000000,
"receipts_from_government_grants": 108488000000,
"receipts_from_customers": 108488000000,
"classes_of_cash_payments": 108488000000,
"other_cash_payments_from_operating_activities": 108488000000,
"payments_on_behalf_of_employees": 108488000000,
"payments_to_suppliers_for_goods_and_services": 108488000000
}
}
],
"status": "ok"
}The key executives endpoint provides detailed information about a company's key executives identified by a specific stock symbol. It returns data such as names, titles, and roles of the executives, which can be useful for understanding the leadership structure of the company.
Route
/key_executivesAPI credits cost
1000 per symbol
symbol
stringSymbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"key_executives": [
{
"name": "Mr. Timothy D. Cook",
"title": "CEO & Director",
"age": 59,
"year_born": 1961,
"pay": 14769259
}
]
}The Market Capitalization History endpoint provides historical data on a company's market capitalization over a specified time period. It returns a time series of market cap values, allowing users to track changes in a company's market value.
Route
/market_capAPI credits cost
5 per request
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringFilter by market identifier code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
start_date
stringStart date for market capitalization data retrieval.
Data will be returned from this date onwards.
Format 2006-01-02
Example:
2023-01-01
end_date
stringEnd date for market capitalization data retrieval.
Data will be returned up to and including this date.
Format 2006-01-02
Example:
2023-12-31
page
integerPage number
Default:
1
outputsize
integerNumber of records in response
Default:
10
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"market_cap": [
{
"date": "2025-07-14",
"value": 3115906555944
},
{
"date": "2025-07-11",
"value": 3153843487457
},
{
"date": "2025-07-10",
"value": 3172513237217
}
]
}The last change endpoint provides the most recent updates to fundamental data for a specified dataset. It returns a timestamp indicating when the data was last modified, allowing users to efficiently manage API requests by only fetching new data when changes occur. This helps optimize data retrieval and reduce unnecessary API credit usage.
Route
/last_change/{endpoint}API credits cost
1 per request
✱ endpoint
stringEndpoint name
Supports: price_target, recommendations, statistics, insider_transactions, profile, mutual_funds_world_summary, mutual_funds_world, institutional_holders, analyst_rating, income_statement, income_statement_quarterly, cash_flow, cash_flow_quarterly, balance_sheet, balance_sheet_quarterly, mutual_funds_list, mutual_funds_world_sustainability, mutual_funds_world_summary, mutual_funds_world_risk, mutual_funds_world_purchase_info, mutual_funds_world_composition, mutual_funds_world_performance, mutual_funds_world, etfs_list, etfs_world, etfs_world_summary, etfs_world_performance, etfs_world_risk, etfs_world_composition, dividends, splits, money_market_funds_world
Example:
statistics
start_date
stringThe starting date and time for data selection, in 2006-01-02T15:04:05 format
Example:
2023-10-14T00:00:00
symbol
stringFilter by symbol
Example:
AAPL
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringFilter by market identifier code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
page
integerPage number
Default:
1
outputsize
integerNumber of records in response
Default:
30
Request example
Response
{
"pagination": {
"current_page": 1,
"per_page": 30
},
"data": [
{
"symbol": "AAPL",
"mic_code": "XNAS",
"last_change": "2023-10-14 12:22:48"
}
]
}