# Forex Market Sessions API > Live forex market-hours layer — a real-time read on which foreign-exchange trading sessions are open right now and where the liquidity is. The 24-hour forex market runs as a relay of four regional sessions — Sydney, Tokyo, London and New York — and this computes, from the current clock and each financial centre's own timezone (daylight-saving handled automatically), whether each session is open, its local time, and its standard open and close in both local time and UTC. It surfaces the active session overlaps that traders care about — above all the London–New York overlap, the most liquid window of the day — reports whether the overall market is open (it closes over the weekend), and gives a world-clock of the four centres. Deterministic and always live, no key. Distinct from FX rate, strength, volatility, seasonality and signal APIs — this is the market-hours layer for forex, trading and dashboard apps. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fxsessions-api/..." ``` ## Pricing - **Free** (Free) — 12,000 calls/Mo, 4 req/s - **Starter** ($7/Mo) — 175,000 calls/Mo, 12 req/s - **Pro** ($20/Mo) — 900,000 calls/Mo, 35 req/s - **Desk** ($49/Mo) — 4,500,000 calls/Mo, 100 req/s ## Endpoints ### Sessions #### `GET /v1/sessions` — All sessions with status, overlaps and liquidity flag **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fxsessions-api/v1/sessions" ``` **Response:** ```json { "data": { "overlaps": [ "sydney+tokyo" ], "sessions": [ { "name": "Sydney", "is_open": true, "session": "sydney", "open_utc": "21:00", "timezone": "Australia/Sydney", "close_utc": "06:00", "local_day": "Tue", "local_time": "13:02", "open_local": "07:00", "utc_offset": "+10:00", "close_local": "16:00", "minutes_to_open": null, "minutes_to_close": 178 }, { "name": "Tokyo", "is_open": true, "session": "tokyo", "open_utc": "00:00", "timezone": "Asia/Tokyo", "close_utc": "09:00", "local_day": "Tue", "local_time": "12:02", "open_local": "09:00", "utc_offset": "+09:00", "close_local": "18:00", "minutes_to_open": null, "minutes_to_close": 358 }, { "name": "London", "is_open": false, "session": "london", "open_utc": "07:00", "timezone": "Europe/London", "close_utc": "16:00", "local_day": "Tue", "local_time": "04:02", "open_local": "08: …(truncated, see openapi.json for full schema) ``` ### Session #### `GET /v1/session` — One session status and hours **Parameters:** - `session` (query, required, string) — Session: sydney|tokyo|london|newyork (aliases ny, uk, jp, au) Example: `london` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fxsessions-api/v1/session?session=london" ``` **Response:** ```json { "data": { "name": "London", "is_open": false, "session": "london", "open_utc": "07:00", "timezone": "Europe/London", "close_utc": "16:00", "local_day": "Tue", "local_time": "04:02", "open_local": "08:00", "utc_offset": "+01:00", "close_local": "17:00", "minutes_to_open": 238, "minutes_to_close": null }, "meta": { "timestamp": "2026-06-09T03:02:38.478Z", "request_id": "49ec0f5c-c316-4674-9ebc-07f5cb1de9de" }, "status": "ok", "message": "Session retrieved successfully", "success": true } ``` ### Clock #### `GET /v1/clock` — World-clock of the four centres **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fxsessions-api/v1/clock" ``` **Response:** ```json { "data": { "utc": "2026-06-09T03:02:38.580Z", "centres": [ { "name": "Sydney", "is_open": true, "session": "sydney", "local_day": "Tue", "local_time": "13:02", "utc_offset": "+10:00" }, { "name": "Tokyo", "is_open": true, "session": "tokyo", "local_day": "Tue", "local_time": "12:02", "utc_offset": "+09:00" }, { "name": "London", "is_open": false, "session": "london", "local_day": "Tue", "local_time": "04:02", "utc_offset": "+01:00" }, { "name": "New York", "is_open": false, "session": "newyork", "local_day": "Mon", "local_time": "23:02", "utc_offset": "-04:00" } ] }, "meta": { "timestamp": "2026-06-09T03:02:38.582Z", "request_id": "639cc154-9d72-404f-8532-1da0cc5510f8" }, "status": "ok", "message": "Clock retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fxsessions-api/v1/meta" ``` **Response:** ```json { "data": { "source": "Computed from each financial centre's IANA timezone (live clock, DST-aware)", "service": "fxsessions-api", "sessions": [ "sydney", "tokyo", "london", "newyork" ], "endpoints": { "GET /v1/meta": "This document.", "GET /v1/clock": "World-clock of the four centres with local time and open status.", "GET /v1/session": "One session's status and hours (session=sydney|tokyo|london|newyork).", "GET /v1/sessions": "All four sessions with open status, overlaps and the most-liquid flag." }, "description": "Live forex market-hours layer: which of the four trading sessions (Sydney, Tokyo, London, New York) are open right now, each centre's local time and standard open/close in local and UTC (DST handled automatically), the active session overlaps — above all the high-liquidity London–New York overlap — whether the overall market is open, and a world-clock of the four centres. Deterministic, real-time, no key. Distinct from FX rate, strength, volatility and signal APIs — this is market hours." }, "meta": { "timestamp": "2026-06-09T03:02:38.676Z", "request_id": "7f620f94-c3af-4e8d-b7ff-e3573ca31fb6" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/fxsessions-api OpenAPI spec: https://www.oanor.com/api/fxsessions-api/openapi.json