Fundamentaly API
A REST API for earnings calendars, results, consensus estimates, management guidance, insider trades, short interest, supply chains and prices across 1,300+ companies in the US, Europe, the UK and India. 1,000 free credits on your first key.
Coverage
1,337 companies: US 601, Europe 530, UK 152, India 54.
What you can call
Company
Who is covered.
- CEO history: Full point-in-time CEO history for ticker — tenure spells (newest first) plus the sourced transition events.
- CEO on a date: Who was CEO of ticker on a given date (point-in-time lookup).
- All companies: Every company in the universe with its ticker, name, exchange and sector. The starting point for the ticker_exchange values the other endpoints take.
- Logos: Logo URLs for up to 100 companies in one call.
- Company data: Get reference company data with optional filtering.
Ecosystem
Who a company is compared with, sells to and buys from.
- Customers: Customers {ticker} names in its annual filings, plus companies that name {ticker} as a supplier.
- Suppliers: Suppliers {ticker} names in its annual filings, plus companies that name {ticker} as a customer.
- Peers: Peers of {ticker}, derived from same GICS sub-industry, ranked by market-cap proximity.
- Read-across: Read-across sentiment for a company on a given date, today by default.
Earnings & events
When companies report, and what the price does around it.
- Earnings calendar: Get corporate events/earnings calendar with flexible filtering.
- Earnings returns: Get realized event-period returns for corporate events in a date range.
- Price around earnings: Get stock performance around corporate events.
- Earnings drivers: Get AI-generated earnings theme summaries — one sentence per ticker describing what consistently drives the stock around earnings.
- Earnings moves: Get earnings volatility summary for multiple tickers in a single request.
- Implied move: Get options-implied earnings move for upcoming earnings events.
Estimates
What the Street expects, and whether it was right.
- Revisions: How the consensus moved — the dated path of each estimate, not just today's level.
- Consensus: Forward analyst consensus for multiple tickers, with the metric as data.
- Surprises: Reported actual vs expected — EPS and revenue — with the metric as data.
- Deep estimates: Deep estimates — issuer-compiled analyst consensus, the Street's expectations bar for upcoming periods, line by line.
- Deep estimates coverage: Which companies have deep-estimates coverage, how fresh it is, and how deep.
- Target prices: Deep-estimates target price and recommendation split per ticker.
Reported financials
What companies actually reported.
- Financials: Everything a company reported: statements, ratios and the revenue split.
- Financials coverage: What we hold for this company, and over what span — before asking for it.
- Management guidance: All management guidance for ticker, every metric and every period.
Prices & risk
How the stock trades.
- Daily prices: Get market data (daily prices and volume) for a specific ticker.
- News: Recent deduped news per company.
- Returns: Get price returns for multiple tickers over a given period.
- Return breakdown: Latest market and sector sensitivity, plus the last N days of return decomposition for ticker.
- Market sensitivity: How sensitive the stock is to the market and its sector over time: beta drift, R² and idiosyncratic volatility, one row per day for charting.
- Seasonality: Monthly seasonality profile for one ticker.
- Sector returns: Calculate returns by GICS sector over a date range.
Positioning
Who is short, who is buying, and the read-across.
- Insider trades: Get insider transactions across multiple tickers with filtering options.
- Short interest: Latest short interest reading per ticker, for US and UK equities.
- Shorts into earnings: Compare the latest short interest reading with the reading at the equivalent point (same number of days) before the previous earnings date.
- Short interest history: Short interest as a time series for one ticker, oldest first.
Macro
What is happening outside the company.
- Macro calendar: Flexible macro-economic events endpoint.
- Macro movers: Get stocks most sensitive to surprises in a specific macro event.
- Macro releases: The macro releases the sensitivity screen covers, with each one's currency, category and event count. Pick an event_name and currency here, then call macro-sensitivity with them.
- Macro series: Find macro series. Use this first to discover the code you need, then call /observations with it.
- Macro data: Observations for the matching series. Levels, not rates — compute YoY yourself, with one documented exception (below).
Pricing
- One credit per company per call. Errors cost nothing.
- 1,000 free credits on your first key, valid 30 days. No card needed.
- Top up any amount on your Account page when they run out.
Authentication
Send your key as a bearer token: Authorization: Bearer fk_live_YOUR_KEY. Base URL: https://api.fundamentaly.io/v1.
First call
curl -H "Authorization: Bearer fk_live_YOUR_KEY" \
"https://api.fundamentaly.io/v1/earnings-calendar?tickers=AAPL@US&start_date=2026-01-01&end_date=2026-12-31"