← Back to Home

FMP Node API Documentation

Stock Endpoints

The Stock Endpoints provide access to market capitalization, stock splits, dividend history, and real-time price data. For real-time quotes, historical prices, and intraday data, see the Quote Endpoints. For company profile information, see the Company Endpoints.

All endpoints return responses with a consistent structure: { success: boolean, data: T | null, error: string | null, status: number }.

Available Methods

MethodEndpointDescription
GET/market-capitalization/{symbol}Get market capitalization data
GET/historical-price-full/stock_split/{symbol}Get stock splits history
GET/historical-price-full/stock_dividend/{symbol}Get dividend history
GET/stock/real-time-price/{symbols}Get real-time price for multiple stocks
GET/stock/full/real-time-price/{symbols}Get full real-time price data for multiple stocks

Get Market Capitalization

Retrieve market capitalization data for a specific stock.

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol

Example Response

Get Stock Splits

Retrieve historical stock splits for a specific stock.

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol

Example Response

Get Dividend History

Retrieve historical dividend payments for a specific stock.

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol

Example Response

Get Real-Time Price

Retrieve real-time price data for multiple stocks. When the symbols array is empty, returns data for all available stocks.

Parameters

ParameterTypeRequiredDescription
symbolsstring[]YesArray of stock symbols. Empty array returns all stocks.

Example Response

Get Full Real-Time Price Data

Retrieve comprehensive real-time price data including bid/ask prices, volume, and trade details for multiple stocks. When the symbols array is empty, returns data for all available stocks.

Parameters

ParameterTypeRequiredDescription
symbolsstring[]YesArray of stock symbols. Empty array returns all stocks.

Example Response

Error Handling

All API responses follow a consistent structure with the following properties:

  • success: Boolean indicating if the request was successful
  • data: The response data (null if unsuccessful)
  • error: Error message string (null if successful)
  • status: HTTP status code

Always check the success property before accessing data:

Common Error Scenarios

Rate Limiting

Stock endpoints are subject to FMP's rate limits. For production applications, implement appropriate rate limiting and caching strategies.

Next Steps

Explore other endpoint categories:


Ready to explore financial data? Check out the Financial Endpoints for income statements, balance sheets, and more.

Need real-time quotes? Check out the Quote Endpoints for comprehensive quote data, historical prices, and intraday charts.