Financial Data API for fundamental investors
Financial statements, earnings call transcripts, ratios and valuation metrics, decades of clean, standardized data behind a single, well-documented API.
No credit card · Free tier: 5 requests/min · Live in under a minute
curl -G https://api.roic.ai/v2/fundamental/income-statement/AAPL \
-d apikey=YOUR_API_KEY \
-d period=annual \
-d limit=1[
{
"ticker": "AAPL",
"fiscal_year": "2025",
"currency": "USD",
"is_sales_revenue_turnover": 416161000000,
"is_gross_profit": 195201000000,
"is_oper_income": 133050000000,
"is_net_income": 112010000000,
"eps": 7.49,
"gross_margin": 46.91,
"ebitda": 144748000000
}
]Coverage
Deep history. Global breadth. One consistent schema.
- 40+
- Years of financial statements
- 120+
- Quarters per company
- 68k+
- Symbols & tickers
- 70+
- Global exchanges
- 17+
- Years of call transcripts
- 28
- Documented endpoints
Endpoints
Every endpoint, in detail
Predictable REST routes, the same field names across every company, and documented formulas behind every metric. Here is exactly what each group returns.
Financial Statements
GET /v2/fundamental/income-statement/{identifier}Income statements, balance sheets and cash-flow statements, annual or quarterly, standardized into one schema. The same field names work for every company on every exchange.
Financial Ratios
GET /v2/fundamental/ratios/profitability/{identifier}Pre-calculated ratios you would otherwise derive yourself, ROIC, ROE, margins, leverage and more, split across five focused endpoints.
Earnings Call Transcripts
GET /v2/company/earnings-calls/latest/{identifier}Full earnings call transcripts going back more than 17 years, organized by fiscal quarter and ready for search or LLM retrieval.
Stock Prices
GET /v2/stock-prices/{identifier}Historical daily prices with VWAP and a separate latest-quote endpoint, plus per-ticker and calendar split data.
Company Profiles
GET /v2/company/profile/{identifier}Reference data for every covered company: profile, logo and the latest news, resolvable by ticker, CIK, CUSIP or ISIN.
Valuation multiples, enterprise value and per-share metrics, computed consistently so comparables line up across companies.
Ready to pull your first statement?
Generate a free API key and call any endpoint in under a minute. No credit card, no sales call.
Usage
From key to insight in three lines
Authenticate with your API key as a query parameter and call any endpoint. Responses are JSON by default, with spreadsheet-ready TSV one parameter away.
curl -G https://api.roic.ai/v2/fundamental/ratios/profitability/AAPL \
-d apikey=YOUR_API_KEY \
-d limit=1[
{
"ticker": "AAPL",
"fiscal_year": "2025",
"return_on_inv_capital": 59.79,
"return_com_eqy": 156.19,
"return_on_asset": 30.93,
"gross_margin": 46.91,
"oper_margin": 31.97,
"profit_margin": 26.92
}
]Use cases
One API, many ways to build
From backtests to consumer apps to AI agents, teams reach for the same standardized financial data, and skip the parsing entirely.
Quantitative research and backtesting
Pull decades of fundamentals and adjusted prices to test factor models, screen for value and validate strategies without survivorship bias. Consistent fiscal-period labelling aligns statements across thousands of tickers.
Fintech products and dashboards
Power company pages, watchlists and screeners with the same data that runs roic.ai. Predictable responses and generous rate limits let you cache aggressively and ship financial features in days, not quarters.
Financial modeling and valuation
Drive DCF, comparable-company and ROIC analyses from the API or straight into Google Sheets. Documented formulas mean every ratio you display traces back to the underlying line items.
AI agents and LLM context
Give chat assistants and autonomous agents grounded, structured financial data instead of stale training data, over REST or the roic.ai MCP server. Clean JSON and stable field names make retrieval and function-calling reliable.
Academic and market research
Access long, normalized histories across global exchanges for empirical studies, with explicit units and reporting periods that hold up to peer review.
Portfolio monitoring and alerts
Track fundamentals, prices and key ratios across a book of positions, and trigger alerts when a metric crosses a threshold you define.
Data quality
How the data is built
Data quality is the product. Raw filings are inconsistent: companies label the same concept a dozen different ways, restate prior periods, and report in different currencies and scales. The Financial Data API absorbs that messiness so you do not have to.
Each statement is parsed, mapped to a single taxonomy, and checked against the figures that power the roic.ai platform, consistent from the first fiscal year to the most recent quarter.
Standardized schema
Line items map to one taxonomy, so every company reports the same fields regardless of how the original filing was structured.
Pre-calculated ratios
ROIC, ROE, the Altman Z-Score and 100+ ratios are computed for you, not left as raw inputs.
Documented formulas
Every derived metric links back to the exact line items and equation behind it.
Explicit units & currency
Each numeric field carries its reporting currency and period, eliminating guesswork when you combine sources.
The data behind roic.ai
The API serves the same financial data that powers the roic.ai research platform.
Global coverage
More than 70 exchanges share the same endpoints and field names, so international comparison simply works.
Testimonials
Built for people who live in the numbers
Quants, analysts and builders rely on the same financial data API every day.
The transcripts endpoint replaced an entire data-cleaning pipeline for us. One schema, every company, going back further than anything else we tried.
We trust the numbers because every metric traces back to the filing. That kind of auditability is rare in a financial data API.
We went from idea to a live company page in a weekend. The data was clean enough to ship without a normalization layer of our own.
Pricing
Start free. Scale when you ship.
Every plan includes full access to every endpoint and all public companies. Plans differ by rate limit and history depth.
Get 2 months free with annual subscription
See the full pricing page for platform features included with each plan.
Guides & the knowledge base
Learn the data, then build with it
Why roic.ai
Why teams choose this Financial Data API
There are plenty of places to get a number. There are far fewer where you can trust it, trace it, and build on it for years.
One schema, every company
Stop writing per-source adapters. Field names, period labels and units are identical across every ticker and exchange, so the code you write for one company works for all of them.
History that goes deep
Forty-plus years of statements and seventeen-plus years of transcripts give models enough signal to mean something. Shallow datasets cannot backtest across a full cycle, this one can.
Transparent by design
Every metric is documented and traceable to its inputs. When a number matters, you can show exactly how it was derived rather than trusting a black box.
Built to scale with you
Start on the free tier at 5 requests a minute and grow to unlimited requests or a custom enterprise contract, without changing a single line of your integration.
Formats that fit your stack
Consume JSON in code, or add format=excel to pull spreadsheet-ready TSV straight into Google Sheets and Excel.
The data behind a real product
This is not a thin wrapper over a third party. It is the same financial data that powers the roic.ai research tools, exposed for you to build on.
FAQ
Questions, answered plainly
What is a financial data API?
A financial data API is a REST endpoint that returns stock prices, financial statements, ratios and other company data as JSON. The roic.ai API covers 68k+ public companies on 70+ exchanges and adds pre-calculated ratios like ROIC, ROE and the Altman Z-Score that most APIs leave you to derive.
Is there a free stock API?
Yes. The roic.ai free tier gives full access to every endpoint and all public companies with no credit card, capped at 5 requests per minute and 2 years of history. Paid plans raise the rate limit and extend history to 40+ years.
What is the best stock API?
The best fit depends on your use case. For fundamentals, roic.ai stands out: standardized financial statements, pre-calculated ratios, valuation multiples and 17+ years of earnings call transcripts across 70+ exchanges, all from one schema. Price-only APIs cover quotes but not deep, traceable fundamentals.
How do I get stock prices from an API?
Call /v2/stock-prices/{identifier} for historical daily prices with VWAP, or /v2/stock-prices/latest/{identifier} for the latest quote. Add your apikey as a query parameter, for example https://api.roic.ai/v2/stock-prices/latest/AAPL?apikey=YOUR_API_KEY.
How do I get real-time stock data from an API?
Use /v2/stock-prices/latest/{identifier} for the most recent price. Real-time data is available on the Professional plan; the free and Individual tiers serve end-of-day and 15-minute-delayed data respectively.
How do I get historical stock data via an API?
Use /v2/stock-prices/{identifier} for daily history, with date_start and date_end to bound the range, and the fundamental endpoints for historical statements. History depth follows your plan: 2 years on the free tier, 5 on Individual, 40+ on Professional.
How do I get financial statements from an API?
Call the fundamental endpoints: /v2/fundamental/income-statement/{identifier}, /balance-sheet/ and /cash-flow/. Pass period=annual or quarterly plus your apikey, and you get standardized statements as JSON, or spreadsheet-ready TSV with format=excel.
Is there an API for stock fundamental data?
Yes. roic.ai serves fundamental data, financial statements, pre-calculated ratios, valuation multiples, enterprise value and per-share metrics, standardized into one schema across 68k+ companies and 70+ exchanges.
Is there a stock news API?
Yes. /v2/company/news/{identifier} returns the latest news articles for a company, alongside the profile and logo endpoints under /v2/company/.
Is there an earnings call transcript API?
Yes. roic.ai has a dedicated transcripts API going back more than 17 years: /v2/company/earnings-calls/latest/{identifier} for the newest call, /list/ for available quarters, and /transcript/ to fetch a specific fiscal year and quarter.
Is there a stock screener API?
There is no single screener endpoint, but you can build one: list tickers with /v2/tickers/list, then pull fundamentals, ratios and valuation per ticker and filter on the fields you need. The roic.ai website also has a visual screener and query builder.
How does roic.ai compare to the Alpha Vantage stock API?
Alpha Vantage focuses on price feeds and a handful of indicators. roic.ai is built around fundamentals: standardized statements, pre-calculated ratios (ROIC, ROE, Altman Z-Score), valuation multiples and earnings call transcripts across 70+ exchanges. Both offer a free tier and JSON responses.
How do I get stock data in Python?
From Python, use a plain requests call, no SDK needed: requests.get("https://api.roic.ai/v2/fundamental/income-statement/AAPL", params={"apikey": "YOUR_API_KEY"}). The same REST endpoints work for prices, ratios and transcripts.
How do I get stock data into Google Sheets?
Add format=excel to any endpoint and wrap it in IMPORTDATA, for example =IMPORTDATA("https://api.roic.ai/v2/stock-prices/latest/AAPL?format=excel&apikey=YOUR_API_KEY"). It returns spreadsheet-ready TSV for Google Sheets or Excel.
What is an API key and how do I get one?
An API key is a token that authenticates your requests. Sign up at roic.ai, copy your key from your account settings, and pass it as the apikey query parameter on every request, for example ...?apikey=YOUR_API_KEY.
What does API mean in the stock market?
In the stock market, an API is a programmatic way to fetch market and company data, prices, financial statements, ratios and more, as structured JSON instead of reading it off a web page. roic.ai exposes this over plain REST.
Is there a global, international stock market data API?
Yes. roic.ai covers 68k+ companies across 70+ global exchanges through the same endpoints and field names, with the reporting currency on every figure so US and international companies compare consistently.
Is there an API for financial ratios?
Yes. roic.ai pre-calculates ratios across five endpoints under /v2/fundamental/ratios/: profitability (ROIC, ROE, margins), credit, liquidity (including the Altman Z-Score), working capital and yield, each with documented formulas.
Put decades of fundamentals behind your next build
Generate a free API key and make your first call in under a minute. No credit card required.
Explore the data
Popular financial datasets and endpoints
Jump straight to the data you need. Every dataset shares the same authentication, schema and response format.