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 | /stable/stock-price-change | Get price change percentages across standard horizons |
Get Market Capitalization
Retrieve market capitalization data for a specific stock.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Price Change
Retrieve the percentage price change for a stock across standard horizons (1D, 5D, 1M, 3M, 6M, YTD, 1Y, 3Y, 5Y, 10Y, and max) in a single call.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Stock Splits
Retrieve historical stock splits for a specific stock.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Dividend History
Retrieve historical dividend payments for a specific stock.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | 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.
| Parameter | Type | Description | |
|---|---|---|---|
| symbols | string[] | required | 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.
| Parameter | Type | Description | |
|---|---|---|---|
| symbols | string[] | required | 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.