We've got a big API realese - a new version.

Consistent responses and pagination

Resources and collections now follow a shared response model. Paginated collections return data, next_page_url, and previous_page_url, so you can move through large result sets without managing offsets.

Errors now include a stable type, code, and message alongside the appropriate HTTP status. Responses also expose request and rate-limit information to help you monitor usage, trace failures, and retry safely.

Learn more in the response format documentation.

New data

We've updated the company identifier to EXCHANGE:TICKER in v3 to accommodate new exchange integrations. v2 will continue to be supported.

• Added company employee-count history with GET /v3.0.0/company/employees

• Added earnings calendar events with GET /v3.0.0/calendar/earnings

• Added a markets catalog connecting countries, exchanges, and ticker coverage

• Added exchange trading hours with GET /v3.0.0/exchanges/trading-hours

• Added exchange holiday calendars with GET /v3.0.0/exchanges/holidays

• You can now retrieve an individual ticker with GET /v3.0.0/tickers/{identifier}

Improvements

• Bearer authentication is now supported and recommended for production applications

• Reference catalogs now include normalized exchange names, MIC codes, markets, and coverage counts

• Financial statements now share a consistent period model across income statements, balance sheets, and cash-flow statements

• Financial data, prices, earnings calls, and stock splits use more consistent filters, ordering, and pagination

• Rate-limit headers and Retry-After behavior are now documented in the response format guide

• Plan access and visibility are now shown right on the endpoint page.

Simplified endpoints

• Ticker listing moved from /v2/tickers/list to /v3.0.0/tickers

• Ticker search routes were consolidated into /v3.0.0/tickers/search

• Exchange filtering is now part of ticker queries instead of a separate search endpoint

• Earnings-call summaries moved to /v3.0.0/earnings-calls

• Individual earnings calls are now retrieved by ID from /v3.0.0/earnings-calls/{identifier}

• Countries, exchanges, sectors, and industries no longer use the /list suffix

• Stock splits now use one filterable /v3.0.0/stock-splits collection

Migration notes

Existing integrations can continue using API v2 while migrating. Update your base path, authentication, response parsing, pagination, and renamed endpoints before switching production traffic to v3.

Company news isn't in v3 yet, we'll add support for that later. You can still use v2 for those operations. v2 website docs are now under the v2 prefix.

Check it out ✌️

https://www.roic.ai/api/docs/getting-started

Company charts

Introducing metric charts that turn raw financial data into a visual story. Instead of scanning tables, see revenue, margins, free cash flow, and ROIC trends at a glance, with a fair-value band that shows whether a stock is cheap right now. And much more!

Build your own metrics and overlays using metrics builder, and it becomes the workspace where you actually make the call.

You can check it out by clicking on the charts link in every company (quote) page.

Like https://www.roic.ai/quote/aapl/charts

🖐️ Share charts with your colleagues and friends; just copy or download chart images.

Improvements

• ROIC.AI is now listed on several MCP directories, including glama and mcp.so, making it easier to integrate.

• URLs are now selectable by clicking on them in API Explorer.

• Refactored the gated user experience: hitting an auth-walled feature now dynamically routes users based on their status - sending existing users to /login and new users to /signup.

• OG images are now 2x faster, thanks to takumi

Ambassador program

Now you can get free individual subscription by posting twice a week on reddit.

New

• ChatGPT integration guide added — A new guide helps you install and use ChatGPT alongside Roic for seamless analysis.

• Blog platform — A new blog.

Improved

• News article fonts updated — Fonts in news articles have been refreshed for a more modern and readable appearance.

• Default date range for company news API page updated — The default date for the company news API now starts from the current year, so you always get recent results in API explorer

Fixed

• Opengraph images now display correctly — Fixed an issue where opengraph images were not showing up properly when sharing links.

• MCP banner removed from API getting started page — The confusing MCP banner has been removed from the API getting started page for clarity.

Financial definitions filter

You can now find the financial terms you need faster with a new search through all financial definitions.

As of date on financial tables

Financial tables now show an as-of date, so you can see exactly which data snapshot you're looking at.

This reflects what was publicly known at that point in time − before any later restatements or revisions − so your analysis stays accurate and reproducible (no lookahead bias in backtests).

New

• API dashboard — You can now overview your API stats on the new dashboard page. Regenerate and update your API key directly from the page, with the key partially masked for security.

• Blog page — A new page where we share research from the ROIC.ai team.

Improvements

• Mobile navigation is now fully usable — Fixed navigation issues on mobile: the logo is clickable to return home, menus close properly after page changes, and the layout is more intuitive.

• Changelog page redesigned for clarity — The changelog is now easier to browse with a cleaner layout.

• News page feels more human and editorial — The /news page has been redesigned provide a higher-quality reading experience.

• Numbers in tables are bold for better readability — Key numbers in financial tables are now displayed in bold to help them stand out.

• API getting started page improved — The API getting started page has been updated with better structure and clarity.

Fixed

• Financial tables scroll smoothly without overflow — Horizontal scrolling in financial tables is no longer problematic, and the view now opens to the most recent table by default.

• Tooltips stay open when you hover over them — Tooltips on financial tables no longer close unexpectedly when you try to interact with them.

Introducing Stock logo API.

Now you can get company and stock market logos by ticker symbol. Supports NYSE, NASDAQ, and global exchanges, with all standard logo size.

Explore here - https://www.roic.ai/api/docs/company/logo

Available for all plans and only unlimited access for PRO members.