Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stratalerts.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Check whether the market is open

The market status endpoint returns a real-time snapshot of whether the US stock market is open, along with the details of the active session. Use this endpoint to gate time-sensitive logic in your integration — for example, to skip candle or price requests outside Regular Trading Hours (RTH), or to display market open/close countdowns in your UI. GET https://app.stratalerts.com/api/market/v1/market-status
Requires scope: metadata:read

​
Request parameters

This endpoint accepts no query parameters.

​
Response fields

​
market
string
required
The market this status applies to. Currently always stocks.
​
timezone
string
required
The timezone used for session timestamps. Always America/New_York.
​
is_open
boolean
required
true if the market is currently in a Regular Trading Hours (RTH) session, false otherwise (pre-market, after-hours, weekend, or holiday).
​
session
object
required
Details of the current or most recent RTH session. All timestamp fields are empty strings when is_open is false.
​
now
string
required
The current server time as an ISO 8601 timestamp in the America/New_York timezone (e.g., 2026-04-10T14:35:00-04:00). Use this to compute time-to-close or time-to-open without worrying about clock skew.
StratAlerts only tracks Regular Trading Hours (RTH) sessions. Pre-market and after-hours periods return is_open: false even when exchange-traded products are actively trading on extended hours.

​
Code examples

curl "https://app.stratalerts.com/api/market/v1/market-status" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example responses

​
Market open

{
  "market": "stocks",
  "timezone": "America/New_York",
  "is_open": true,
  "session": {
    "label": "RTH",
    "session_date": "2026-04-10",
    "open_ts": "2026-04-10T09:30:00-04:00",
    "close_ts": "2026-04-10T16:00:00-04:00"
  },
  "now": "2026-04-10T14:35:00-04:00"
}

​
Market closed

{
  "market": "stocks",
  "timezone": "America/New_York",
  "is_open": false,
  "session": {
    "label": "",
    "session_date": "",
    "open_ts": "",
    "close_ts": ""
  },
  "now": "2026-04-10T18:12:00-04:00"
}

​
Error codes

HTTP statusError codeMeaning
401missing_api_keyNo API key was provided or the key format is invalid.
403inactive_entitlementYour account does not have an active API entitlement.
403missing_scopeYour API key does not have the metadata:read scope.
Error responses use the following shape: 
{
  "error": {
    "code": "missing_api_key",
    "message": "missing api key"
  }
}