Docs
Api referenceInstruments

Market hours for a symbol or instrument, from the account's broker

GET
/v1/accounts/{id}/sessions

When the account's broker lets orders be placed in a symbol — or in this account's symbol for an instrument — as the broker configured it (MetaTrader's SymbolInfoSessionTrade), with whether it is open now and when that next changes.

trade and quote are given in the broker's server time and in UTC; utcOffsetSeconds is the broker's clock as measured when the sessions were read. Read when the account comes online and refreshed daily, so it answers while the account is offline.

Holidays a broker does not load into its schedule are not here: on such a day an order is still refused with ORDER_REJECTED (Market closed).

Authorization

apiKey
AuthorizationBearer <token>

Authorization: Bearer fx_live_<id>_<secret>.

A key is shown once, at creation. We cannot show it again or recover it for you. Keys carry a label (live or test) in the key itself, so each configuration is easy to tell apart. Both reach real brokers: test with a broker demo account.

Scopes are per key. A key without accounts:write can read accounts and nothing else.

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

symbol?string

A broker symbol, exactly as the broker spells it.

instrument?string

Or an instrument, e.g. XAUUSD: this account's symbol for it is used.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/sessions"
{  "data": {    "symbol": "XAUUSD",    "instrument": "XAUUSD",    "server": "string",    "utcOffsetSeconds": 10800,    "sessionsSyncedAt": "2019-08-24T14:15:22Z",    "openNow": true,    "nextOpen": null,    "nextClose": null,    "trade": {      "server": [        {          "day": "sunday",          "open": "00:01",          "close": "23:58"        }      ],      "utc": [        {          "day": "sunday",          "open": "00:01",          "close": "23:58"        }      ]    },    "quote": {      "server": [        {          "day": "sunday",          "open": "00:01",          "close": "23:58"        }      ],      "utc": [        {          "day": "sunday",          "open": "00:01",          "close": "23:58"        }      ]    }  }}