ROIC.ai
- Free allowance
- Free plan USD 0/month: 5 requests per minute and 2 years of history, with every endpoint and all public companies included; plans differ only by rate limit and history depth.
- Verdict
- caveatusable, with a named limit or an unprobed read path
- Cost
- free tier
- Identity
- emailno card, no phone
- Binding limit
- request-rate5 requests per minute on the Free plan; over it the API answers HTTP 429
- Evidence
- documented30 sources; a first-party page was read and the sentence quoted
- Freshness
- stale on 2026-12-03checked 2026-11-02 (live); stale on 2026-12-03
| Free tier | Free plan USD 0/month: 5 requests per minute and 2 years of history, with every endpoint and all public companies included; plans differ only by rate limit and history depth. unit requests; metered on request-count; A request for history beyond 2 years answers HTTP 403 naming the minimum plan that covers it, and a request over the minute limit answers HTTP 429 with Retry-After and X-RateLimit headers. The pricing comparison table lists batch stock prices and the earnings calendar as not included on Free, while the authentication page and the changelog of 4 June 2026 say every endpoint is available; most per-endpoint pages still carry the line Free tier: AAPL available on free tier, and the ticker list page says Free tier: Premium only. The next plan up is Individual at USD 24 a month billed annually, with 300 requests a minute and 5 years of history. |
|---|---|
| Price | none stated |
| Limits |
History depth: 2 years on Free, and a request beyond it answers HTTP 403. Bulk path: none on Free; bulk downloads are listed for Professional and Enterprise. |
| Binding | request-rate 5 requests a minute is the only rate cap stated for the Free plan; the 2-year history depth bounds each series. |
| Identity | email The sign-up page takes an email and a password, or Google sign-in; the quickstart says the free tier needs no credit card. |
| Egress | not metered in bytes; the 5 requests per minute bound what a free key can pull |
| Per-object cap | unverified: no per-response cap is stated on the pages read; period endpoints return 10 periods by default and take a limit parameter |
| Retention | 2 years of history on the Free plan; a request for older data answers HTTP 403 |
| Interface | rest GET https://api.roic.ai/v2/{endpoint} with the key in the apikey query parameter; JSON by default or tab-separated values with format=excel. An MCP server at https://mcp.roic.ai/mcp exposes the same data as tools, and two spreadsheet endpoints serve an Excel and Google Sheets add-on. |
| Tooling | any HTTP client; request examples for cURL, Python, JavaScript, Ruby, Go and Google Sheets; an MCP server |
| Composes with | Worldwide fundamentals, ratios, prices and earnings call transcripts for the last 2 years at 5 requests a minute, with no daily or monthly count stated; deeper history, higher rates and bulk downloads are paid, so a free stack pairs it with a quote feed such as Finnhub or Alpha Vantage. |
| Reliability | Over the minute limit the API answers HTTP 429 with Retry-After and X-RateLimit headers; a call with no key answered HTTP 401 Invalid or missing API key. |
| Notes | Every endpoint and all public companies are included on Free per the authentication page; plans differ only by rate limit and history depth. |
| Evidence note | documented The Free plan limits are read from the first-party authentication page, the changelog and the pricing page, and a keyless call answered HTTP 401. The pricing table and the per-endpoint pages disagree with the authentication page on which endpoints the Free plan reaches, and a free key was not exercised, so that point is unverified: behind a sign-up. |
| Parsed numbers |
|
Evidence 30
| date | source | what it proved |
|---|---|---|
| 2026-11-02 | www.roic.ai/pricing | the Free plan allows 5 requests per minute against 300 on Individual |
| 2026-11-02 | www.roic.ai/pricing | the Free plan reaches 2 years of history against 5 years on Individual |
| 2026-11-02 | www.roic.ai/pricing | market coverage is worldwide on every plan |
| 2026-11-02 | www.roic.ai/pricing | the pricing table lists batch stock prices as not included on Free |
| 2026-11-02 | www.roic.ai/pricing | the pricing table lists the earnings calendar as not included on Free |
| 2026-11-02 | www.roic.ai/pricing | the Free plan is USD 0 a month |
| 2026-11-02 | www.roic.ai/pricing | the next plan up, Individual, is USD 24 a month billed annually |
| 2026-11-02 | www.roic.ai/api/v2/docs/authentication | the Free plan is 5 requests per minute and 2 years of history |
| 2026-11-02 | www.roic.ai/api/v2/docs/authentication | every plan, Free included, reaches every endpoint and all public companies |
| 2026-11-02 | www.roic.ai/api/v2/docs/authentication | exceeding the per-minute limit answers HTTP 429 |
| 2026-11-02 | www.roic.ai/api/v2/docs/authentication | the 429 answer carries Retry-After and X-RateLimit headers |
| 2026-11-02 | www.roic.ai/api/v2/docs/authentication | history beyond the plan's depth answers HTTP 403 naming the minimum plan |
| 2026-11-02 | www.roic.ai/api/v2/docs/authentication | every request carries the key in the apikey query parameter |
| 2026-11-02 | www.roic.ai/api/v2/docs/getting-started | the free tier needs no credit card |
| 2026-11-02 | www.roic.ai/api/v2/docs/getting-started | the free account takes no credit card |
| 2026-11-02 | www.roic.ai/api/v2/docs/getting-started | endpoints are GET requests with an apikey parameter and answer JSON or tab-separated values |
| 2026-11-02 | www.roic.ai/api/v2/docs/getting-started | an MCP server exposes the same data as tools |
| 2026-11-02 | www.roic.ai/api/v2/docs/getting-started | the MCP server URL is mcp.roic.ai |
| 2026-11-02 | www.roic.ai/api/v2/docs/getting-started | request examples exist for cURL, Python, JavaScript, Ruby, Go and Google Sheets |
| 2026-11-02 | www.roic.ai/api/v2/docs/changelog | since 4 June 2026 every plan, Free included, has full access to every endpoint |
| 2026-11-02 | www.roic.ai/api/v2/docs/changelog | two endpoints power an Excel and Google Sheets add-on |
| 2026-11-02 | www.roic.ai/api/v2/docs/valuation/per-share | the per-endpoint page still states that AAPL is available on the free tier |
| 2026-11-02 | www.roic.ai/api/v2/docs/stock-prices/historical | the historical prices page states that AAPL is available on the free tier |
| 2026-11-02 | www.roic.ai/api/v2/docs/company/profile | the company profile page states that AAPL is available on the free tier |
| 2026-11-02 | www.roic.ai/api/v2/docs/tickers/list | the ticker list page states that the free tier is premium only |
| 2026-11-02 | www.roic.ai/api/v2/docs/valuation/per-share | period endpoints return 10 periods by default and take a limit parameter |
| 2026-11-02 | www.roic.ai/signup | the sign-up page takes an email and a password |
| 2026-11-02 | www.roic.ai/signup | the sign-up page offers Google sign-in |
| 2026-11-02 | probe: https://api.roic.ai/v2/company/profile/AAPL | a keyless call to the API answers HTTP 401 |
| 2026-11-02 | probe: https://api.roic.ai/v2/company/profile/AAPL | the keyless 401 body names a missing or invalid API key |