Love, disappointment, and the pain in between. Told honestly. No apologies.

It’s 4:20 Somewhere. Now a Free, Open-Source API Tells You Exactly Where

Written by

in

The Official 420 World Clock at 420.menow.us shows, live, exactly where on Earth it is 4:20 right now, and how long until it is 4:20 everywhere else. And everything behind it is a free, open-source API that anyone can build on: no account, no key, no cost.

It’s 4:20 somewhere. Now there is a precise, public answer to where.

The Official 420 World Clock: a world map divided into time zones, colored from red to bright green by how close each zone is to 4:20
The Official 420 World Clock at 420.menow.us.

The clock

  • A live map of every time zone on Earth: 66 zones, built from the open timezone-boundary-builder boundaries, colored by how far each one is from 4:20, from deep red (hours away) to bright green (right now).
  • Your own clock, privately. The page reads your time zone from your browser. No location prompt, and nothing is sent to a server.
  • The countdown. The header shows the closest 4:20, the next one coming, and the minutes until it lands.
  • Fly there. Every place name links to Google Earth.
  • Know the law before you light up. Hearts mark the 32 countries where cannabis is legal or decriminalized nationally; skulls mark the 15 where a cannabis offense can carry the death penalty. Every zone has a plain-language law card.
The 420 World Clock web page showing the status line, a row of city clocks and the color-coded world map
The live page: status line, city clocks, and the map.

The API: free, read-only, no key

api.420.menow.us serves the same data the clock uses. Open any address in a browser and you get a readable page; ask from code and you get JSON. Full reference: api.420.menow.us/docs.

Endpoint What it answers
/v1/now Is it 4:20 anywhere right now? The closest place, what’s next, and the countdown queue
/v1/zones Every map zone with its local time and distance from 4:20
/v1/zones/{tzid} One zone, e.g. America/New_York
/v1/zones/{tzid}/law The law card for one zone
/v1/zones/{tzid}/places Every place in one zone, each with its own law card
/v1/laws Cannabis law status for every country
/v1/laws/{iso2} Full law card for one country, e.g. NL
/v1/laws.sqlite The whole law database as one SQLite file, for offline apps
/v1/time The server clock, cross-checked against the U.S. Naval Observatory
/v1/meta Data version, and the offline database for apps

One call answers the question. Asked at 4:03 p.m. New York time today, /v1/now said the next 4:20 was 17 minutes away, landing at once in Caracas, Havana, New York and Manila:

curl https://api.420.menow.us/v1/now

"is_420_somewhere": false,
"closest": { "place": "Caracas", "minutes_until_next_420": 17 },
"queue": [ { "in_minutes": 17,
             "places": ["Caracas", "Havana", "New York", "Manila"] } ]
420 World Clock API banner: a glowing globe clock reading 04:20 with the words Free, Read-only, No key required
Free. Read-only. No key required.

Open source

The API’s code is public on GitHub under the MIT license: github.com/LIBCSYS/420-world-clock-api. Read it, run it, fork it, put it in your own app. Time zone rules are pinned to the official tz database (2026e), so the answers stay correct when governments change their clocks.

Built by LIBCSystems in Long Island, New York.

All the links

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *