Company, product and segment forecasts
Revenue and EPS consensus, plus product, segment and operating metrics where the source forecasts them, each with its forecast period, unit and accounting basis.
Consensus forecasts · REST API · MCP
Analyst estimates API and MCP server for consensus forecasts
Read what analysts expect a company to report: revenue, EPS, product sales, segment results and operating figures for coming quarters and years, with each statistic kept exactly as the source states it. Query by ticker over the REST API, or ask Claude, ChatGPT or any MCP client what analysts expect next quarter.
Using ChatGPT or Claude? Add this data to your AI — no code needed.
Free: 100 requests a day, no credit card. One account works with REST and MCP.
Works with
Claude
ChatGPT
Gemini
MCP
What the API and the MCP tools cover
Both surfaces read the same store the Equibles pages render, so a figure on the site and a figure in your code agree.
Company-published consensus first
A consensus the company publishes through its investor-relations sources answers first once independently verified. Otherwise a compiled consensus of analyst forecasts answers for US-listed companies, and the response says which.
Snapshot history
Every verified capture is kept as a dated snapshot, so you can read the consensus that stood at an earlier time and see how expectations moved.
REST endpoints and MCP tools
Every endpoint below is a GET under the api.equibles.com/v1 base URL, authenticated with an API key. Each MCP tool answers the same question in plain English from Claude, ChatGPT or any connected client.
GET /v1/stocks/{ticker}/analyst-estimates
GetAnalystEstimates
The same question, three ways
One free key covers the MCP server and the REST API; the browser needs no key at all.
REST
curl "https://api.equibles.com/v1/stocks/NVDA/analyst-estimates?limit=3" -H "Authorization: Bearer eq_YOUR_KEY"
MCP, in Claude or ChatGPT
“Using Equibles, what revenue and EPS do analysts expect from NVIDIA next quarter, and how wide is the range?”
Name Equibles in the prompt so the model calls the tool instead of answering from memory. Connection guides
Read the consensus correctly
Each figure is the statistic the source states. Mean and median stay separate, and highs, lows and analyst counts are their own rows, so never average a range or read a mean as a median.
An empty result does not mean analysts have no estimates; coverage varies by issuer. Management guidance and reported actuals are a separate dataset, so compare a forecast with the company's own guidance rather than expecting both in one answer.
What the API preserves
- The source's own metric name, forecast period and product or segment dimensions
- Each statistic as the source states it, with mean and median never merged
- Values in their original units and precision, with no missing figure turned into zero
- Which kind of source answered: company-published or compiled
- Verified snapshots with their capture dates, readable as of an earlier time
Use the data in code, AI, or the browser
Choose the interface that fits the work; all three read the same store.
Frequently asked questions
What is an analyst estimates API?
It returns the consensus of what analysts forecast a company will report, revenue, EPS and other metrics for coming quarters and years, as structured rows with the statistic, unit and period, so code or an AI model can compare expectations with results.
Where do the estimates come from?
From the company itself where it publishes a consensus through its investor-relations sources and that consensus passes an independent check, and otherwise, for US-listed companies, from a compiled consensus of analyst forecasts. The provider field says which kind answered.
Can I see how the consensus changed?
Yes. Every verified capture is stored as a snapshot. List the snapshots, then read one by snapshotId, or pass asOf to get the consensus that had been verified by that time.
Does it include management guidance?
No. Guidance and historical actuals are excluded from this dataset. Equibles extracts company guidance from earnings releases as a separate dataset.
Can I read analyst estimates in Claude or ChatGPT?
Yes. Connect the Equibles MCP server and ask what analysts expect from a company; the GetAnalystEstimates tool answers by ticker, and the REST API returns the same data as JSON. For a company listed on another exchange, pass MIC:TICKER, such as XAMS:ASML.
Is there a free analyst estimates API?
Yes. The Equibles free tier includes 100 requests a day, shared across the REST API and MCP server, with no credit card. Paid plans raise the limit.
Start reading analyst expectations as data.
One free key for consensus forecasts and their snapshot history, over REST and MCP.