TickQuote logoTickQuoteDocs

Docs search

Search the current language documentation index.

Docs/Market Data·API

Market status

Return calendar-aware display status for compact tickers.

Method
GET
Path
/api/v1/market/status
Auth
Bearer token

Overview

Returns calendar-aware display status for one or more tickers. Calendar data is not fully seeded yet, so unknown is expected and does not mean the endpoint failed.

Common use cases

  • - Render status badges in Market Watch
  • - Distinguish closed from open_data_stale
  • - Avoid rendering calendar unknown as an outage

Request URL

Send the request to the base API URL with your product API key in the Authorization bearer header.

GET/api/v1/market/status?tickers=EURUSD%2CXAUUSD%2CUS30
HTTP request
GET https://api.tickquote.com/api/v1/market/status?tickers=EURUSD%2CXAUUSD%2CUS30
Authorization: Bearer <tkp_api_key>
Parameter
Description
tickers
Required. Comma-separated compact ticker list, for example EURUSD,XAUUSD,US30.
at
Optional. ISO-8601 timestamp for debugging or tests.

Try It Out

Edit query parameters and send a demo or authenticated request from this endpoint page.

GET/api/v1/market/status
Live sandbox

Use demo_key to try it without an account.

Response

// Response will appear here after sending a request

Response

A successful REST response uses code 0 and message success. Always check code before reading data.

response.json
Sample payload
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "ticker": "XAUUSD",
        "calendar_state": "unknown",
        "market_data_state": "live",
        "final_display_state": "unknown",
        "next_open_at": null,
        "next_close_at": null,
        "reason": null,
        "calendar_source": "unknown",
        "provider_source": "mt5",
        "updated_at": "2026-05-06T12:00:00Z"
      }
    ]
  }
}

Examples

The examples below use compact tickers and the Authorization bearer header.

curl
cURL
curl "https://api.tickquote.com/api/v1/market/status?tickers=EURUSD%2CXAUUSD%2CUS30" \
  -H "Authorization: Bearer $TICKQUOTE_API_KEY"
request.js
JavaScript
const response = await fetch("https://api.tickquote.com/api/v1/market/status?tickers=EURUSD%2CXAUUSD%2CUS30", {
  headers: {
    Authorization: `Bearer ${process.env.TICKQUOTE_API_KEY}`,
  },
})

const payload = await response.json()
if (payload.code !== 0) {
  throw new Error(payload.message)
}

console.log(payload.data)

Field reference

Field
Sample
Description
ticker
XAUUSD
Compact ticker for this status row.
calendar_state
unknown
Calendar-layer state, for example open, closed, or unknown.
market_data_state
live
Market-data state, for example live, stale, or missing.
final_display_state
unknown
Primary frontend display state for badges.
next_open_at
null
Next open timestamp; null when unknown.
next_close_at
null
Next close timestamp; null when unknown.
reason
null
Backend-provided status reason; may be null.
calendar_source
unknown
Calendar decision source.
provider_source
mt5
Market-data provider source; may be null.
updated_at
2026-05-06T12:00:00Z
Status generation timestamp.

Important notes

  • - Primary UI should prefer final_display_state.
  • - closed and unknown are neutral states.
  • - open_data_stale and late_open_data_stale are warning states.