FMP Node API Documentation
Calendar Endpoints
The Calendar Endpoints provide access to various financial calendars including earnings, dividends, economic events, IPOs, and stock splits. These endpoints help you track important financial events and announcements.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /earning_calendar | Get earnings calendar data |
| GET | /earning-calendar-confirmed | Get earnings confirmed data |
| GET | /stock_dividend_calendar | Get dividends calendar data |
| GET | /economic_calendar | Get economic calendar data |
| GET | /ipo_calendar | Get IPO calendar data |
| GET | /stock_split_calendar | Get stock splits calendar data |
Get Earnings Calendar
Retrieve upcoming earnings announcements with estimated and actual earnings per share (EPS) and revenue data.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Earnings Confirmed
Retrieve confirmed earnings announcements with detailed information including publication dates and URLs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Dividends Calendar
Retrieve upcoming dividend payments and declarations with payment dates and amounts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Economic Calendar
Retrieve economic events and indicators from various countries with estimates and actual values.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get IPO Calendar
Retrieve upcoming initial public offerings (IPOs) with company details and offering information.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Stock Splits Calendar
Retrieve upcoming stock splits with ratio information.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Working with Calendar Data
Filtering by Date Range
All calendar endpoints support optional date filtering. When no dates are provided, the API returns the most recent data:
Processing Calendar Events
Calendar data is particularly useful for building financial dashboards and tracking important events:
Error Handling
Always check the success property before accessing data:
Rate Limiting
Calendar endpoints are subject to FMP's rate limits. For production applications, implement appropriate rate limiting and caching strategies, especially when fetching data for extended date ranges.
Next Steps
Explore other endpoint categories:
- Stock Endpoints - Real-time stock data and quotes
- Financial Endpoints - Financial statements and ratios
- Market Endpoints - Market indices and sector data
- Examples - Practical code samples
Ready to explore market data? Check out the Market Endpoints for indices, sector performance, and market statistics.
Documentation
Quotes
Information
Resources
Calendar Endpoints
The Calendar Endpoints provide access to various financial calendars including earnings, dividends, economic events, IPOs, and stock splits. These endpoints help you track important financial events and announcements.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /earning_calendar | Get earnings calendar data |
| GET | /earning-calendar-confirmed | Get earnings confirmed data |
| GET | /stock_dividend_calendar | Get dividends calendar data |
| GET | /economic_calendar | Get economic calendar data |
| GET | /ipo_calendar | Get IPO calendar data |
| GET | /stock_split_calendar | Get stock splits calendar data |
Get Earnings Calendar
Retrieve upcoming earnings announcements with estimated and actual earnings per share (EPS) and revenue data.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Earnings Confirmed
Retrieve confirmed earnings announcements with detailed information including publication dates and URLs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Dividends Calendar
Retrieve upcoming dividend payments and declarations with payment dates and amounts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Economic Calendar
Retrieve economic events and indicators from various countries with estimates and actual values.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get IPO Calendar
Retrieve upcoming initial public offerings (IPOs) with company details and offering information.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Get Stock Splits Calendar
Retrieve upcoming stock splits with ratio information.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | No | Start date (YYYY-MM-DD format) |
| to | string | No | End date (YYYY-MM-DD format) |
Example Response
Working with Calendar Data
Filtering by Date Range
All calendar endpoints support optional date filtering. When no dates are provided, the API returns the most recent data:
Processing Calendar Events
Calendar data is particularly useful for building financial dashboards and tracking important events:
Error Handling
Always check the success property before accessing data:
Rate Limiting
Calendar endpoints are subject to FMP's rate limits. For production applications, implement appropriate rate limiting and caching strategies, especially when fetching data for extended date ranges.
Next Steps
Explore other endpoint categories:
- Stock Endpoints - Real-time stock data and quotes
- Financial Endpoints - Financial statements and ratios
- Market Endpoints - Market indices and sector data
- Examples - Practical code samples
Ready to explore market data? Check out the Market Endpoints for indices, sector performance, and market statistics.