Market Endpoints

Access market-wide data including performance metrics, trading hours, sector information, and market indices.

Available Methods

MethodEndpointDescription
GET/market-performanceGet market performance data
GET/stable/all-exchange-market-hoursGet trading hours and open/closed status for all exchanges
GET/stable/biggest-gainersGet top gaining stocks
GET/stable/biggest-losersGet top losing stocks
GET/stable/most-activesGet most active stocks
GET/stable/sector-performance-snapshotGet sector performance snapshot for a date
GET/stable/industry-pe-snapshotGet industry P/E snapshot for a date
GET/quotes/indexGet market index data

Get Market Performance

Retrieve overall market performance data including major indices.

TypeScriptTypeScript

Example Response

TypeScriptTypeScript

Get Market Hours

Retrieve trading hours and the current open/closed status for every supported exchange. Returns one record per exchange.

TypeScriptTypeScript

Example Response

TypeScriptTypeScript

Get Top Gainers

Retrieve the top gaining stocks for the current trading day.

TypeScriptTypeScript

Example Response

TypeScriptTypeScript

Get Top Losers

Retrieve the top losing stocks for the current trading day.

TypeScriptTypeScript

Example Response

TypeScriptTypeScript

Get Most Active

Retrieve the most actively traded stocks by volume.

TypeScriptTypeScript

Example Response

TypeScriptTypeScript

Get Sector Performance

Retrieve a sector-performance snapshot for a given date, showing the average change per sector broken out by exchange. A date (YYYY-MM-DD) is required; exchange and sector are optional filters.

TypeScriptTypeScript
ParameterTypeDescription
datestringrequiredSnapshot date in YYYY-MM-DD format
exchangestringoptionalOptional exchange filter (e.g., NASDAQ, NYSE)
sectorstringoptionalOptional sector filter (e.g., Technology)

Example Response

TypeScriptTypeScript

Get Industry P/E Snapshot

Retrieve an industry P/E snapshot for a given date, showing the average price-to-earnings ratio per industry broken out by exchange. A date (YYYY-MM-DD) is required; exchange and industry are optional filters.

TypeScriptTypeScript
ParameterTypeDescription
datestringrequiredSnapshot date in YYYY-MM-DD format
exchangestringoptionalOptional exchange filter (e.g., NASDAQ, NYSE)
industrystringoptionalOptional industry filter (e.g., Software)

Example Response

TypeScriptTypeScript

Note: On the FMP Starter plan, the snapshot endpoints are available for recent dates only; older date values require a higher tier.

Get Market Index

Retrieve detailed market index data.

TypeScriptTypeScript

Example Response

TypeScriptTypeScript

Response Types

MarketPerformance

TypeScriptTypeScript

ExchangeMarketHours

TypeScriptTypeScript

MarketSectorPerformance

TypeScriptTypeScript

IndustryPESnapshot

TypeScriptTypeScript

MarketIndex

TypeScriptTypeScript

Note: Some numeric fields may be returned as strings by the FMP API. Always check the type at runtime if you need strict type safety.

Error Handling

Always check the success property before accessing data:

TypeScriptTypeScript

Rate Limiting

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

Market Hours

Market data availability depends on trading hours:

  • Stock Market - Typically 9:30 AM - 4:00 PM ET (Monday-Friday)
  • Pre-Market - 4:00 AM - 9:30 AM ET
  • After-Hours - 4:00 PM - 8:00 PM ET
  • Weekends/Holidays - Limited data availability

Next Steps

Explore other endpoint categories:


Ready to explore economic data? Check out the Economic Endpoints for indicators and macroeconomic data.