Get the current Unix time

GET/api/v2/time/now

The current Unix time in seconds, milliseconds, microseconds and nanoseconds, with ISO 8601 and RFC 2822 in a zone. Free, no key needed. The Workers clock has millisecond resolution, so microseconds and nanoseconds end in zeros

Free: no key needed and not counted towards your quota. Limited to 60 requests per minute per IP address

Parameters

Name	In	Description
`tz`optional	query	IANA time zone for `zone`. Defaults to UTCExample: `America/New_York`

Example

curl "https://marketcalendars.com/api/v2/time/now?tz=America/New_York"

const res = await fetch("https://marketcalendars.com/api/v2/time/now?tz=America/New_York");
const data = await res.json();

import requests

data = requests.get("https://marketcalendars.com/api/v2/time/now?tz=America/New_York").json()

GET /api/v2/time/now?tz=America/New_York200

{
  "seconds": 1793992989,
  "milliseconds": 1793992989382,
  "microseconds": "1793992989382000",
  "nanoseconds": "1793992989382000000",
  "utc": "2026-11-06T19:23:09.382Z",
  "zone": {
    "id": "America/New_York",
    "local": "2026-11-06T14:23:09.382-05:00",
    "rfc9557": "2026-11-06T14:23:09.382-05:00[America/New_York]",
    "rfc2822": "Fri, 06 Nov 2026 14:23:09 -0500",
    "offset": "-05:00",
    "abbreviation": "EST",
    "dst": false
  },
  "calendar": {
    "weekday": "Friday",
    "isoWeek": "2026-W45",
    "dayOfYear": 310
  }
}

A live response from the API. Lists longer than seven items are cut to three here

Response fields

TimeNow object. Fields marked | null are always present and may be null

Field	Type	Description
seconds	integer	Unix time in whole seconds, rounded down
milliseconds	integer	Unix time in whole milliseconds, rounded down
microseconds	string	Unix time in microseconds. A string, as it exceeds 2^53
nanoseconds	string	Unix time in nanoseconds, exact. A string, as it exceeds 2^53
utc	string (date-time)	ISO 8601 in UTC, with as many fraction digits as the value needs (0, 3, 6 or 9)
zone	object
zone.id	string	IANA time zone
zone.local	string (date-time)	ISO 8601 in the zone, with its UTC offset
zone.rfc9557	string	ISO 8601 with the offset and the zone in brackets (RFC 9557)
zone.rfc2822	string	RFC 2822 date in the zone, whole seconds
zone.offset	string	UTC offset, ±HH:MM (±HH:MM:SS for local mean time before standard time)
zone.abbreviation	string	Zone abbreviation, or GMT±H where there is no common one
zone.dst	boolean	Whether summer time is in force
calendar	object	Calendar facts in the zone
calendar.weekday	string	Weekday in the zone
calendar.isoWeek	string	ISO 8601 week in the zone
calendar.dayOfYear	integer	Day of the year in the zone, 1 to 366

Errors

400invalid-parameterA path or query parameter is malformed, such as a date that is not YYYY-MM-DD
429rate-limitedThe key sent more requests in a minute than its plan's burst limit, or the client sent too many invalid keys