Getting started
Make your first ROIC.ai API call in a few minutes. By the end, you have an API key and a working request that returns financial data for a public company. The free tier needs no credit card.
The API is a REST service over HTTPS that returns JSON, so you can call it from any HTTP client, including curl, Python, and JavaScript.
Add the ROIC.ai MCP server and connect your AI coding tools to financial data.
Base URL
https://api.roic.aiEvery endpoint is a GET request authenticated with an apikey query parameter.
Responses are JSON by default, or TSV with ?format=excel.
Quickstart
Three steps take you from zero to your first response.
Create your free account
Sign up for ROIC.ai — it's free and takes no credit card. Your account holds your API key and tracks your usage.
Get your API key
Your key authenticates every request. Copy it below, keep it private, and never commit it to source control.
Sign in to see your API key.
For the rules that apply to your key, see the authentication guide.
Make your first request
Pass your key as the apikey query parameter on any endpoint. The example below
fetches Apple's company profile. Pick your language, add your key, and run it.
A successful request returns 200 OK with a JSON body. Each endpoint documents
its own fields on its reference page.
Rate limits
Every plan, including the free tier, can call every endpoint across all public companies. Plans differ only by rate limit and history depth: the free tier allows 5 requests per minute and 2 years of history, and paid plans raise both. For current numbers, see pricing.
When you exceed your rate limit, the API returns 429 Too Many Requests. We
recommend that you retry after a short delay and cache responses you reuse.
Connect an AI assistant
If you work in an AI coding tool or chat client, connect through the Model Context Protocol instead of making manual requests. The MCP server exposes the same financial data as tools your assistant calls directly.
https://mcp.roic.ai/mcpSee the MCP server guide for setup steps in Claude, Cursor, VS Code, and Codex.
Next steps
Explore the rest of the API: