# roic.ai

> Financial data API for company fundamentals: financial statements, 90+ pre-calculated ratios, valuation multiples and earnings call transcripts for 68k+ public companies on 70+ exchanges, with up to 40+ years of history. REST (JSON or TSV), SDKs for Python, Node and Go, and an MCP server for AI agents.

- Plans: Free (5 requests/minute, 2 years of annual fundamentals and daily prices, 2 quarters of earnings calls, no credit card); Individual $29/month (300 requests/minute, 5 years of history); Professional $89/month (unlimited requests, 40+ years of history); Enterprise (commercial use, multi-user access).
- Authentication: API key passed as the `apikey` query parameter. Get a key at https://www.roic.ai/dashboard
- Stock prices are end-of-day and historical, not a real-time feed.
- Every docs page below is also available as Markdown: request it with the header `Accept: text/markdown`.

## Docs
- [Getting started](https://www.roic.ai/api/docs/getting-started): first request, API key, base URL
- [Authentication](https://www.roic.ai/api/docs/authentication): API keys and plans
- [Response format](https://www.roic.ai/api/docs/response-format): JSON and TSV output
- [OpenAPI spec](https://api.roic.ai/openapi.json): machine-readable spec for all endpoints

## Fundamentals
- [Financial statements](https://www.roic.ai/api/docs/financial-statements): income statement, balance sheet, cash flow (annual and quarterly)
- [Financial ratios](https://www.roic.ai/api/docs/financial-ratios): profitability (ROIC, ROE, margins), credit, liquidity, working capital, yield
- [Valuation](https://www.roic.ai/api/docs/valuation): multiples, enterprise value, per-share data

## Earnings calls
- [Earnings call transcripts](https://www.roic.ai/api/docs/earnings-calls): transcripts by year and quarter, list of calls
- [Edited transcripts, audio and slides](https://www.roic.ai/api/docs/earnings-calls/edited-transcript): Professional plan

## Market and reference data
- [Stock prices](https://www.roic.ai/api/docs/stock-prices): latest and historical OHLCV
- [Tickers](https://www.roic.ai/api/docs/tickers): search and list tickers
- [Company profile](https://www.roic.ai/api/docs/company/profile): sector, industry, employees
- [Reference data](https://www.roic.ai/api/docs/reference-data/exchanges): exchanges, sectors, industries, countries

## AI agents (MCP)
- [MCP server setup](https://www.roic.ai/api/mcp): hosted server at https://mcp.roic.ai/mcp (Streamable HTTP, OAuth); setup for Claude, ChatGPT, Cursor, VS Code, Codex
- [Open-source MCP server](https://github.com/roicai/agents-plugin): MIT, 25 tools, `npx -y @roicai/mcp-server`

## SDKs
- [Python SDK](https://github.com/roicai/roicai-python): `pip install roicai`, pandas and polars output
- [Node.js / TypeScript SDK](https://github.com/roicai/roicai-node): `npm install roicai`
- [Go SDK](https://github.com/roicai/roicai-go): `go get github.com/roicai/roicai-go`

## Optional
- [Pricing](https://www.roic.ai/pricing): plans and limits
- [Bulk data](https://www.roic.ai/api/docs/bulk/fundamentals): bulk fundamentals, earnings calls and prices
- [Forex](https://www.roic.ai/api/docs/forex/latest): latest and historical exchange rates