FMP Node API Documentation
Analyst Endpoints
The Analyst Endpoints provide access to analyst-driven data: forward estimates, price targets, rating grades (upgrades/downgrades), and the overall rating consensus for a company.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /stable/analyst-estimates?symbol={symbol} | Get analyst estimates (revenue, EBITDA, net income, EPS) |
| GET | /stable/price-target-consensus?symbol={symbol} | Get the analyst price-target consensus (high/low/consensus/median) |
| GET | /stable/price-target-summary?symbol={symbol} | Get a summary of analyst price targets over recent periods |
| GET | /stable/grades?symbol={symbol} | Get analyst grades (upgrades/downgrades) |
| GET | /stable/grades-consensus?symbol={symbol} | Get the analyst rating consensus (buy/hold/sell counts + label) |
Get Analyst Estimates
Retrieve forward analyst estimates including revenue, EBITDA, net income, and EPS, with low/high/average ranges per period.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve |
Example Response
Get Price Target Consensus
Retrieve the analyst price-target consensus for a company (high, low, consensus, median). Returns a single snapshot object.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Price Target Summary
Retrieve a summary of analyst price targets over recent periods (last month, quarter, year, and all-time counts with average targets).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Stock Grades
Retrieve recent analyst grades (upgrades/downgrades) for a company.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Grades Consensus
Retrieve the analyst rating consensus for a company: the number of analysts at each rating (strongBuy/buy/hold/sell/strongSell) plus the overall consensus label. Returns a single snapshot object.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Error Handling
Always check the success property before accessing data:
Next Steps
Explore other endpoint categories:
- Financial Endpoints - Statements, ratios, and fundamental data
- Company Endpoints - Profiles, peers, and company information
- Examples - Practical code samples
Documentation
Quotes
Analysis
Information
Resources
Analyst Endpoints
The Analyst Endpoints provide access to analyst-driven data: forward estimates, price targets, rating grades (upgrades/downgrades), and the overall rating consensus for a company.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /stable/analyst-estimates?symbol={symbol} | Get analyst estimates (revenue, EBITDA, net income, EPS) |
| GET | /stable/price-target-consensus?symbol={symbol} | Get the analyst price-target consensus (high/low/consensus/median) |
| GET | /stable/price-target-summary?symbol={symbol} | Get a summary of analyst price targets over recent periods |
| GET | /stable/grades?symbol={symbol} | Get analyst grades (upgrades/downgrades) |
| GET | /stable/grades-consensus?symbol={symbol} | Get the analyst rating consensus (buy/hold/sell counts + label) |
Get Analyst Estimates
Retrieve forward analyst estimates including revenue, EBITDA, net income, and EPS, with low/high/average ranges per period.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve |
Example Response
Get Price Target Consensus
Retrieve the analyst price-target consensus for a company (high, low, consensus, median). Returns a single snapshot object.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Price Target Summary
Retrieve a summary of analyst price targets over recent periods (last month, quarter, year, and all-time counts with average targets).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Stock Grades
Retrieve recent analyst grades (upgrades/downgrades) for a company.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Grades Consensus
Retrieve the analyst rating consensus for a company: the number of analysts at each rating (strongBuy/buy/hold/sell/strongSell) plus the overall consensus label. Returns a single snapshot object.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Error Handling
Always check the success property before accessing data:
Next Steps
Explore other endpoint categories:
- Financial Endpoints - Statements, ratios, and fundamental data
- Company Endpoints - Profiles, peers, and company information
- Examples - Practical code samples