Feed status

GET /v1/status · Connection and freshness

Draft reference · Examples use sample data.

Request

GET/v1/statusBearer token

Read-only endpoint. The base URL is a placeholder; these requests are not executable yet.

Request example

curl 'https://API_BASE_URL/v1/status?feed=justmarkets' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Query parameters

Parameter	Type	Accepted value
`feed`	string · required	justmarkets

Pagination, date-range filters and batch size are not specified in this API contract.

Example response

200 OK Fixed sample data; not an executable market price.

application/json

{
  "demo": true,
  "feed": "justmarkets",
  "symbol": "XAUUSD",
  "timestamp": "2026-10-06T08:30:00Z",
  "sampled": true,
  "source": "JustMarkets MT5",
  "connected": true,
  "stale": false,
  "note": "Illustrative feed state, not a connection test"
}

Response fields

Field	Type	Description
`demo`	boolean	True for sample responses.
`feed`	string	Identifies the broker connection.
`symbol`	string	Client-facing symbol: XAUUSD.
`timestamp`	string	ISO 8601 UTC source timestamp. Fixed in examples.
`sampled`	boolean	True: observations may omit intermediate ticks.
`source`	string	Broker platform label.
`connected`	boolean	Illustrative connection state in the sample.
`stale`	boolean	Whether the observed feed is stale.
`note`	string	Additional context about the reported state.

Behavior & errors

A successful status response may report connected: false and stale: true. Inspect these fields even when HTTP status is 200.

All endpoints may report invalid credentials (401), a rate limit (429), or an exhausted allowance (429). See error handling →

Try scenarios in the explorer →