{"openapi":"3.1.0","info":{"title":"Forex Market Sessions API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fxsessions-api","description":"oanor gateway"}],"tags":[{"name":"Sessions"},{"name":"Session"},{"name":"Clock"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/sessions":{"get":{"operationId":"get_v1_sessions","tags":["Sessions"],"summary":"All sessions with status, overlaps and liquidity flag","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_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_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:00","utc_offset":"+01:00","close_local":"17:00","minutes_to_open":238},{"name":"New York","is_open":false,"session":"newyork","open_utc":"12:00","timezone":"America/New_York","close_utc":"21:00","local_day":"Mon","local_time":"23:02","open_local":"08:00","utc_offset":"-04:00","close_local":"17:00"}],"as_of_utc":"2026-06-09T03:02:38.376Z","market_open":true,"open_sessions":["sydney","tokyo"],"most_liquid_now":false},"meta":{"timestamp":"2026-06-09T03:02:38.378Z","request_id":"e7798df9-9ef9-459e-9c22-19d97bb6612c"},"status":"ok","message":"Sessions retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/session":{"get":{"operationId":"get_v1_session","tags":["Session"],"summary":"One session status and hours","description":"","parameters":[{"name":"session","in":"query","required":true,"description":"Session: sydney|tokyo|london|newyork (aliases ny, uk, jp, au)","schema":{"type":"string"},"example":"london"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},"meta":{"timestamp":"2026-06-09T03:02:38.478Z","request_id":"49ec0f5c-c316-4674-9ebc-07f5cb1de9de"},"status":"ok","message":"Session retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/clock":{"get":{"operationId":"get_v1_clock","tags":["Clock"],"summary":"World-clock of the four centres","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":4,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":175000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":900000,"rps_limit":35,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":4900,"monthly_call_quota":4500000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fxsessions-api"}