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
Method | Endpoint | Description |
---|---|---|
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
Parameter | Type | Required | Description |
---|---|---|---|
symbol | string | Yes | Stock symbol |
Example Response
Get Stock Splits
Retrieve historical stock splits for a specific stock.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
symbol | string | Yes | Stock symbol |
Example Response
Get Dividend History
Retrieve historical dividend payments for a specific stock.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
symbol | string | Yes | Stock 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
Parameter | Type | Required | Description |
---|---|---|---|
symbols | string[] | Yes | Array 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
Parameter | Type | Required | Description |
---|---|---|---|
symbols | string[] | Yes | Array 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 successfuldata
: 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:
- Quote Endpoints - Real-time quotes, historical prices, and intraday data
- Company Endpoints - Company profiles, executive compensation, and employee data
- Financial Endpoints - Financial statements and ratios
- Market Endpoints - Market indices and sector data
- Calendar Endpoints - Earnings, dividends, and economic calendars
- List Endpoints - Available symbols and instruments
- Examples - Practical code samples
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.
Documentation
Quotes
Information
Resources
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
Method | Endpoint | Description |
---|---|---|
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
Parameter | Type | Required | Description |
---|---|---|---|
symbol | string | Yes | Stock symbol |
Example Response
Get Stock Splits
Retrieve historical stock splits for a specific stock.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
symbol | string | Yes | Stock symbol |
Example Response
Get Dividend History
Retrieve historical dividend payments for a specific stock.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
symbol | string | Yes | Stock 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
Parameter | Type | Required | Description |
---|---|---|---|
symbols | string[] | Yes | Array 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
Parameter | Type | Required | Description |
---|---|---|---|
symbols | string[] | Yes | Array 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 successfuldata
: 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:
- Quote Endpoints - Real-time quotes, historical prices, and intraday data
- Company Endpoints - Company profiles, executive compensation, and employee data
- Financial Endpoints - Financial statements and ratios
- Market Endpoints - Market indices and sector data
- Calendar Endpoints - Earnings, dividends, and economic calendars
- List Endpoints - Available symbols and instruments
- Examples - Practical code samples
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.