Skip to content
Docs
Get API key
Tools

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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringConditional—{ticker}:{exchange}For example "aapl:us". Returns every financial metric for this company. Takes priority over category.
categorystringConditional—Financial metric nameFor example "assets", "net-income" or "eps". Returns this metric across all companies.

Example

“Show Apple’s latest financial statements.”

JSON
{ "symbol": "aapl:us" }
Example response
JSON
{
  "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

FieldDescription
SymbolCompound key, for example "aapl:us:assets".
stock, financialSymbolThe stock and the financial metric.
DateThe date of the latest record.
lastThe latest reported value.
value1 to value4, date1 to date4The four latest periods, newest first.
currencyThe reporting currency.
unitThe scale of every value, for example "E+06" = millions.
frequencyThe length of each period: "quarterly", "semesterly" or "yearly".

Notes

get_financials_historical

History of a financial metric.

Returns the full history of a financial metric for one or more companies.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolCategorystringYes—{ticker}:{exchange}:{metric}, comma-separatedFor example "aapl:us:assets" or "aapl:us:assets,msft:us:assets".
startDatestringNo—YYYY-MM-DDStart of the range.
endDatestringNo—YYYY-MM-DDEnd of the range. Takes effect only with startDate.

Example

“Compare Apple’s and Microsoft’s total assets since 2020.”

JSON
{ "symbolCategory": "aapl:us:assets,msft:us:assets", "startDate": "2020-01-01" }
Example response
JSON
{
  "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 unit that get_financials returns 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
typestring (enum)Yes—companies, sectors, categoriescompanies: the companies covered. sectors: sector names for get_earnings_by_sector. categories: metric names for get_financials.
countrystringNo—Country names, comma-separated, up to 5For example "united states" or "spain,germany". Applies only with type "companies".

Example

“Which sectors can I query earnings for?”

JSON
{ "type": "sectors" }
Example response
JSON
{
  "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 to get_financials (for example "net-income"), and Name, its display name (for example "Net Income").

Notes

  • country has no effect with type "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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringNo—{ticker}:{exchange}For example "aapl:us". Takes priority over country and index.
countrystringNo—Country nameFor example "mexico". Takes priority over index.
indexstringNo—Index symbolFor example "spx:ind". Returns the companies of this index.
startDatestringNo—YYYY-MM-DDStart of the range.
endDatestringNo—YYYY-MM-DDEnd of the range. Takes effect only with startDate.

Example

“Which S&P 500 companies report earnings between October 26 and October 30, 2026?”

JSON
{ "index": "spx:ind", "startDate": "2026-10-26", "endDate": "2026-10-30" }
Example response
JSON
{
  "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

FieldsDescription
Date, Symbol, Name, Country, Currency, MarketCapUSDThe event and the company.
Actual, Forecast, PreviousEarnings per share, as text.
ActualValue, ForecastValue, PreviousValueEarnings per share, as numbers.
Revenue, RevenueForecast, RevenuePreviousRevenue as text, for example "1.72B".
RevenueValue, RevenueForecastValue, RevenuePreviousValueRevenue as numbers, for example 1720000000.
FiscalTag, FiscalReferenceThe fiscal period, for example "FY2026Q3", and the fiscal quarter, for example "Q3".
CalendarReferenceThe calendar date of the fiscal quarter end.
Importance1 = low to 3 = high.
Session, MarketReleaseThe expected release hour (UTC), and the release timing: before_open, after_close or by_day_end.
LastUpdateWhen the record was last updated, in UTC.

Notes

  • Without filters, the upcoming earnings calendar is returned.
  • Use the numeric *Value fields for calculations. Actual, Revenue and their numeric fields are empty for results not yet reported.
  • Use get_stock_indices to 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
sectorstringYes—Sector nameFor example "technology" or "health care".
startDatestringNo—YYYY-MM-DDStart of the range.
endDatestringNo—YYYY-MM-DDEnd of the range. Takes effect only with startDate.

Example

“Which technology companies report earnings in October 2026?”

JSON
{ "sector": "technology", "startDate": "2026-10-01", "endDate": "2026-10-31" }
Example response
JSON
{
  "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

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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringNo—{ticker}:{exchange}For example "aapl:us". Omit for all companies.
startDatestringNo—YYYY-MM-DDStart of the range.
endDatestringNo—YYYY-MM-DDEnd of the range. Takes effect only with startDate.

Example

“Which dividends did Apple pay in 2025?”

JSON
{ "symbol": "aapl:us", "startDate": "2025-01-01", "endDate": "2025-12-31" }
Example response
JSON
{
  "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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
tickerstringConditional—IPO tickerFor example "RRKA". Takes priority over country.
countrystringConditional—Country nameFor example "india".
startDatestringNo—YYYY-MM-DDStart of the range.
endDatestringNo—YYYY-MM-DDEnd of the range. Takes effect only with startDate.

Example

“Which IPOs are scheduled in India until the end of 2026?”

JSON
{ "country": "india", "startDate": "2026-10-01", "endDate": "2026-12-31" }
Example response
JSON
{
  "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 ticker or country is 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
tickerstringNo—Stock tickerFor example "DEIN". Takes priority over country.
countrystringNo—Country nameFor example "india".
startDatestringNo—YYYY-MM-DDStart of the range. Not accepted with ticker.
endDatestringNo—YYYY-MM-DDEnd of the range. Requires startDate. Not accepted with ticker.

Example

“Which stock splits took place in India in 2025?”

JSON
{ "country": "india", "startDate": "2025-01-01", "endDate": "2025-12-31" }
Example response
JSON
{
  "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 ticker and country, 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 Country and Name.