Finance & Conversion

Market Status API

Check whether any major stock exchange is open right now, with next open and close times.

Request Headers

Name	Required	Description
`X-RapidAPI-Key`	required	Your RapidAPI key. Get one free.
`X-RapidAPI-Host`	required	`market-status.p.rapidapi.com`

Endpoints

GET /v1/finance/market-hours

Get an exchange's trading hours, holidays, and half-days for a year

Parameters

Name	Type	Required	Default	Constraints
`exchange`	string	required	—	<= 32 chars; matches \S
`year`	integer	optional	—	—

Code Examples

curl --request GET \
  --url 'https://market-status.p.rapidapi.com/v1/finance/market-hours?exchange=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: market-status.p.rapidapi.com'

const url = "https://market-status.p.rapidapi.com/v1/finance/market-hours?exchange=example";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "market-status.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://market-status.p.rapidapi.com/v1/finance/market-hours"

querystring = {"exchange": "example"}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "market-status.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

GET /v1/finance/market-status

Check whether a stock exchange is open right now

Parameters

Name	Type	Required	Default	Constraints
`exchange`	string	required	—	<= 32 chars; matches \S

Code Examples

curl --request GET \
  --url 'https://market-status.p.rapidapi.com/v1/finance/market-status?exchange=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: market-status.p.rapidapi.com'

const url = "https://market-status.p.rapidapi.com/v1/finance/market-status?exchange=example";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "market-status.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://market-status.p.rapidapi.com/v1/finance/market-status"

querystring = {"exchange": "example"}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "market-status.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

Interactive Example

market-status

$ GET /v1/finance/market-status?exchange=NYSE
{"exchange":"New York Stock Exchange","mic":"XNYS","timezone":"America/New_York","local_time":"2026-07-06T08:45:00-04:00","open_now":false,"status":"closed","reason":"outside_hours","holiday_name":null,"next_open":"2026-07-06T09:30:00-04:00","next_close":"2026-07-06T16:00:00-04:00"}

Subscribe & License

Access this API with commercial-ready tiers on RapidAPI. Flexible plans designed for side-projects, startups, and high-volume production architectures.

View Pricing & Subscribe

Developer Support

Need help integrating or have a custom endpoint request? Our engineering team is here to assist with authentication, payload schemas, and high-frequency rate limit increases.

Contact API Engineering

System Performance

Monitored 24/7 with a 99.9% uptime SLA. Built atop cloud-native microservices with globally distributed edge caching to ensure ultra-low latency response times.

All Systems Operational