Financials and Corporate Event Tools
Financial statement data, and the calendars of earnings, dividends, IPOs and stock splits.
get_financials
Latest financial statement data.
Returns the latest four reporting periods of financial statement data: every metric for one company, or one metric across all companies.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
symbol | string | Conditional | — | {ticker}:{exchange} | For example "aapl:us". Returns every financial metric for this company. Takes priority over category. |
category | string | Conditional | — | Financial metric name | For example "assets", "net-income" or "eps". Returns this metric across all companies. |
Example
“Show Apple’s latest financial statements.”
{ "symbol": "aapl:us" }Example response
{
"columns": ["Symbol", "Date", "last", "value1", "date1", "value2", "date2", "value3", "date3", "value4", "date4", "unit", "currency", "frequency", "stock", "financialSymbol"],
"rows": [
["aapl:us:assets", "2026-06-30T00:00:00", 383266, 383266, "2026-06-30T00:00:00", 371082, "2026-03-31T00:00:00", 379297, "2025-12-31T00:00:00", 359241, "2025-09-30T00:00:00", "E+06", "USD", "quarterly", "aapl:us", "assets"],
["aapl:us:eps", "2026-06-30T00:00:00", 2.02, 2.02, "2026-06-30T00:00:00", 2.01, "2026-03-31T00:00:00", 2.84, "2025-12-31T00:00:00", 1.85, "2025-09-30T00:00:00", "E+00", "USD", "quarterly", "aapl:us", "eps"]
]
}Retrieved on October 26, 2026; truncated to 2 of 29 rows. Values change over time.
Returns
| Field | Description |
|---|---|
Symbol | Compound key, for example "aapl:us:assets". |
stock, financialSymbol | The stock and the financial metric. |
Date | The date of the latest record. |
last | The latest reported value. |
value1 to value4, date1 to date4 | The four latest periods, newest first. |
currency | The reporting currency. |
unit | The scale of every value, for example "E+06" = millions. |
frequency | The length of each period: "quarterly", "semesterly" or "yearly". |
Notes
- At least one of
symbolorcategoryis required. - Pass the
Symbolcompound key toget_financials_historicalassymbolCategory. - Use
get_financial_referencewithtype"categories"to list valid metric names.
get_financials_historical
History of a financial metric.
Returns the full history of a financial metric for one or more companies.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
symbolCategory | string | Yes | — | {ticker}:{exchange}:{metric}, comma-separated | For example "aapl:us:assets" or "aapl:us:assets,msft:us:assets". |
startDate | string | No | — | YYYY-MM-DD | Start of the range. |
endDate | string | No | — | YYYY-MM-DD | End of the range. Takes effect only with startDate. |
Example
“Compare Apple’s and Microsoft’s total assets since 2020.”
{ "symbolCategory": "aapl:us:assets,msft:us:assets", "startDate": "2020-01-01" }Example response
{
"columns": ["symbol", "category", "date", "value", "reportDate", "reference"],
"rows": [
["aapl:us", "assets", "2020-03-31T00:00:00", 320400, "2020-03-31T00:00:00", "FY2020Q2"],
["msft:us", "assets", "2026-06-30T00:00:00", 758376, "2026-07-29T00:00:00", "FY2026Q4"]
]
}Retrieved on October 26, 2026; truncated to 2 of 52 rows. Values change over time.
Returns
symbol (for example, "aapl:us"), category (for example, "assets"), date (period end), value, reportDate, reference (fiscal period, for example "FY2024Q4").
Notes
- There is no unit field. The values use the
unitthatget_financialsreturns for the same compound key.
get_financial_reference
Lists of companies, sectors and financial metrics.
Returns the valid names to use with the other financial tools: the companies covered, the sector names, or the financial metric categories.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
type | string (enum) | Yes | — | companies, sectors, categories | companies: the companies covered. sectors: sector names for get_earnings_by_sector. categories: metric names for get_financials. |
country | string | No | — | Country names, comma-separated, up to 5 | For example "united states" or "spain,germany". Applies only with type "companies". |
Example
“Which sectors can I query earnings for?”
{ "type": "sectors" }Example response
{
"columns": ["Sector"],
"rows": [
["Accommodation and Food Services"],
["Communication Services"]
]
}Retrieved on October 26, 2026; truncated to 2 of 19 rows.
Returns
companies:Symbol,Name,Country.sectors:Sector.categories:Category, the metric name to pass toget_financials(for example"net-income"), andName, its display name (for example"Net Income").
Notes
countryhas no effect withtype"sectors"or"categories".
get_earnings
Earnings and revenue calendar.
Returns the corporate earnings and revenue calendar by company, country or stock index, optionally within a date range.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
symbol | string | No | — | {ticker}:{exchange} | For example "aapl:us". Takes priority over country and index. |
country | string | No | — | Country name | For example "mexico". Takes priority over index. |
index | string | No | — | Index symbol | For example "spx:ind". Returns the companies of this index. |
startDate | string | No | — | YYYY-MM-DD | Start of the range. |
endDate | string | No | — | YYYY-MM-DD | End of the range. Takes effect only with startDate. |
Example
“Which S&P 500 companies report earnings between October 26 and October 30, 2026?”
{ "index": "spx:ind", "startDate": "2026-10-26", "endDate": "2026-10-30" }Example response
{
"columns": ["Date", "Symbol", "Name", "Actual", "ActualValue", "Forecast", "ForecastValue", "Previous", "PreviousValue", "Revenue", "RevenueValue", "RevenueForecast", "RevenueForecastValue", "RevenuePrevious", "RevenuePreviousValue", "MarketCapUSD", "FiscalTag", "FiscalReference", "CalendarReference", "Country", "Currency", "Importance", "Session", "MarketRelease", "LastUpdate"],
"rows": [
["2026-10-26", "CDNS:US", "Cadence Design Systems", "", null, "1.92", 1.92, "1.93", 1.93, "", null, "1.55B", 1550000000, "1.34B", 1340000000, 91697100000, "FY2026Q3", "Q3", "2026-09-30", "United States", "USD", 3, 21, "after_close", "2026-10-23T16:59:00"],
["2026-10-26", "HIG:US", "Hartford Financial Services", "", null, "3.11", 3.11, "3.78", 3.78, "", null, "7.41B", 7410000000, "7.23B", 7230000000, 42277200000, "FY2026Q3", "Q3", "2026-09-30", "United States", "USD", 3, 21, "after_close", "2026-10-23T16:59:00"]
]
}Retrieved on October 26, 2026; truncated to 2 of 175 rows. Values change over time.
Returns
| Fields | Description |
|---|---|
Date, Symbol, Name, Country, Currency, MarketCapUSD | The event and the company. |
Actual, Forecast, Previous | Earnings per share, as text. |
ActualValue, ForecastValue, PreviousValue | Earnings per share, as numbers. |
Revenue, RevenueForecast, RevenuePrevious | Revenue as text, for example "1.72B". |
RevenueValue, RevenueForecastValue, RevenuePreviousValue | Revenue as numbers, for example 1720000000. |
FiscalTag, FiscalReference | The fiscal period, for example "FY2026Q3", and the fiscal quarter, for example "Q3". |
CalendarReference | The calendar date of the fiscal quarter end. |
Importance | 1 = low to 3 = high. |
Session, MarketRelease | The expected release hour (UTC), and the release timing: before_open, after_close or by_day_end. |
LastUpdate | When the record was last updated, in UTC. |
Notes
- Without filters, the upcoming earnings calendar is returned.
- Use the numeric
*Valuefields for calculations.Actual,Revenueand their numeric fields are empty for results not yet reported. - Use
get_stock_indicesto find index symbols.
get_earnings_by_sector
Earnings and revenue by sector.
Returns corporate earnings and revenue for one sector, optionally within a date range.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
sector | string | Yes | — | Sector name | For example "technology" or "health care". |
startDate | string | No | — | YYYY-MM-DD | Start of the range. |
endDate | string | No | — | YYYY-MM-DD | End of the range. Takes effect only with startDate. |
Example
“Which technology companies report earnings in October 2026?”
{ "sector": "technology", "startDate": "2026-10-01", "endDate": "2026-10-31" }Example response
{
"columns": ["Date", "Symbol", "Name", "Actual", "ActualValue", "Forecast", "ForecastValue", "Previous", "PreviousValue", "Revenue", "RevenueValue", "RevenueForecast", "RevenueForecastValue", "RevenuePrevious", "RevenuePreviousValue", "MarketCapUSD", "FiscalTag", "FiscalReference", "CalendarReference", "Country", "Currency", "Importance", "Session", "MarketRelease", "LastUpdate"],
"rows": [
["2026-10-01", "ACN:US", "Accenture", "3.29", 3.29, "3.18", 3.18, "3.03", 3.03, "18.7B", 18700000000, "18.05B", 18050000000, "17.6B", 17600000000, 142890900000, "FY2026Q4", "Q4", "2026-06-30", "Ireland", "USD", 2, 13, "before_open", "2026-10-08T11:29:00"],
["2026-10-14", "ASML:NA", "ASML Holding", "12.93", 12.93, "8.50", 8.5, "5.48", 5.48, "11.66B", 11660000000, "10.33B", 10330000000, "7.52B", 7520000000, 655709005594, "FY2026Q3", "Q3", "2026-09-30", "Netherlands", "EUR", 3, 24, "by_day_end", "2026-10-14T07:06:00"]
]
}Retrieved on October 26, 2026; truncated to 2 rows. Values change over time.
Returns
The same fields as get_earnings.
Notes
- Use
get_financial_referencewithtype"sectors"to list valid sector names.
get_dividends
Dividend calendar.
Returns the dividend calendar, with ex-dividend dates, payment dates and amounts per share, for one company or for all companies.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
symbol | string | No | — | {ticker}:{exchange} | For example "aapl:us". Omit for all companies. |
startDate | string | No | — | YYYY-MM-DD | Start of the range. |
endDate | string | No | — | YYYY-MM-DD | End of the range. Takes effect only with startDate. |
Example
“Which dividends did Apple pay in 2025?”
{ "symbol": "aapl:us", "startDate": "2025-01-01", "endDate": "2025-12-31" }Example response
{
"columns": ["DateEx", "Symbol", "Name", "Actual", "DatePayment", "Currency", "LastUpdate"],
"rows": [
["2025-02-10", "AAPL:US", "Apple", 0.25, "2025-02-13", "USD", "2025-03-10T07:23:00"],
["2025-05-12", "AAPL:US", "Apple", 0.26, "2025-05-15", "USD", "2025-05-16T20:11:00"]
]
}Retrieved on October 26, 2026; truncated to 2 of 4 rows.
Returns
DateEx (ex-dividend date), Symbol, Name, Actual (dividend per share), DatePayment, Currency, LastUpdate (UTC).
Notes
- Without
symbol, the dividends of all companies are returned.
get_ipo
IPO calendar.
Returns the calendar of initial public offerings by ticker or by country, optionally within a date range.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
ticker | string | Conditional | — | IPO ticker | For example "RRKA". Takes priority over country. |
country | string | Conditional | — | Country name | For example "india". |
startDate | string | No | — | YYYY-MM-DD | Start of the range. |
endDate | string | No | — | YYYY-MM-DD | End of the range. Takes effect only with startDate. |
Example
“Which IPOs are scheduled in India until the end of 2026?”
{ "country": "india", "startDate": "2026-10-01", "endDate": "2026-12-31" }Example response
{
"columns": ["Date", "Ticker", "Country", "Exchange", "Symbol", "Name", "Value", "StartPrice", "Currency", "LastUpdate"],
"rows": [
["2026-10-23T00:00:00", "BONF", "India", "BSE", "", "Bonfiglioli Transmissions Ltd", "25.3B", "558.00-586.00", "INR", "2026-10-22T10:14:00"],
["2026-10-23T00:00:00", "BONF", "India", "NSE", "", "Bonfiglioli Transmissions Ltd", "25.3B", "558.00-586.00", "INR", "2026-10-22T10:14:00"]
]
}Retrieved on October 26, 2026; truncated to 2 of 8 rows. Values change over time.
Returns
Date, Ticker, Country, Exchange, Symbol (often empty), Name, Value (offer amount as text, for example "200.0M"), StartPrice (price per share as text, for example "10.00", or a price range such as "558.00-586.00"), Currency, LastUpdate (UTC).
Notes
- At least one of
tickerorcountryis required. - An IPO listed on several exchanges returns one row per exchange.
get_stock_splits
Stock split calendar.
Returns the stock split calendar by ticker, by country, or for all countries.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
ticker | string | No | — | Stock ticker | For example "DEIN". Takes priority over country. |
country | string | No | — | Country name | For example "india". |
startDate | string | No | — | YYYY-MM-DD | Start of the range. Not accepted with ticker. |
endDate | string | No | — | YYYY-MM-DD | End of the range. Requires startDate. Not accepted with ticker. |
Example
“Which stock splits took place in India in 2025?”
{ "country": "india", "startDate": "2025-01-01", "endDate": "2025-12-31" }Example response
{
"columns": ["Date", "Ticker", "Country", "Symbol", "Name", "Ratio", "LastUpdate"],
"rows": [
["2025-01-03T00:00:00", "MCNL", "India", "", "McNally Bharat Engg Co Ltd", "1:20", "2025-01-31T08:51:00"],
["2025-01-10T00:00:00", "SHMF", "India", "SHFL:IN", "Shriram Finance", "5:1", "2025-01-31T08:51:00"]
]
}Retrieved on October 26, 2026; truncated to 2 rows.
Returns
Date, Ticker, Country, Symbol (often empty), Name, Ratio (new shares to old shares, for example "2:1"; a ratio such as "1:20" is a reverse split), LastUpdate (UTC).
Notes
- Without
tickerandcountry, the splits of all countries are returned. - Without
startDate, only recent and upcoming splits are returned. Records start in September 2023. - A ticker is matched in every country, so it can return different companies; check
CountryandName.