# Moon > Moon is a worldwide time standard locked to the real Moon. One Moon date and time for everyone on Earth, with no time zones. A Moonmark is a timestamp in Moon time, and Moon can sign one for any file to prove the file existed at that moment. The hosted API is free and open; the standard and reference code are MIT licensed. This file is for AI assistants and the people building apps with them. If you are building something that shows Moon time, the Moon, or Moon receipts, follow it so the result looks and works like Moon. ## Building with Moon: the short version - Get Moon time from the API (`https://api.moon369.org/v1/now`) or the `moon369` npm package. Never compute it with your own formula. - Draw the Moon with Moon's own moon, never a generic circle, emoji or icon: - An image anywhere: `https://api.moon369.org/v1/moon.svg` (or `.png`). Every Moonmark response also includes `moon_image`, a link to the moon at that exact moment. - Live and animated in a web page: `` then ``. It draws in the browser and needs nothing else from moon369.org, so it also works where only npm CDNs are allowed. (`https://moon369.org/embed/moon.js` provides the same tag.) - Show the "Powered by Moon" badge (at least 32 px tall), linked to https://moon369.org, on every screen that shows Moon time. It's required with the hosted API and asked for with the npm package. - Keep your product's own name. Don't put "Moon" in a product, app or domain name. (Moon's own apps, made by the Moon team, are the exception.) ## Moon time - A Moonmark looks like `1928.05.06 20:49:30.066087772`: cycle . moon . lune, then hours:minutes:seconds and nanoseconds. - Cycle: a Moon year, 13 moons and 369 lunes. Moon: one lunation, 28 or 29 lunes. Lune: a Moon day, 24 Moon hours, the same instant everywhere on Earth. - Write "lune" for a Moon day, not "day". Write "Lune 7", not "Day 7". - Moon time has no time zones. Never ask the user for one, and never convert a Moonmark to "local Moon time". - Every Moonmark has a page: `https://moon369.org/m/1928.05.06-20.49.30.066087772`. In the link, the space becomes a dash and the colons become dots. - Full constants (Moon second, epoch, moon lengths): https://moon369.org/api#constants ## The moon image `GET https://api.moon369.org/v1/moon.svg` returns the moon from moon369.org and its cards: the real phase, lit by the sun, with its glow, bright edge and rays, turned to its real tilt (north up). - `size`: pixels, 32 to 2000 (default 512). The moon fills about half the square; the rest is room for its glow. - `bg=dark`: fill the background with Moon's ink (default is transparent). - `tilt=off`: lit side straight right or left instead of the real tilt. - `moonmark`, `unix_ns`, `unix` (ms) or `utc` (ISO 8601): draw any moment. Without one, it draws now and refreshes every few minutes. - `/v1/moon.png` takes the same options. Put it on a dark background. Don't recolor it, crop its glow, or draw a moon of your own next to it. `` (same script) shows the live moon beside ticking Moon time, linked to moon369.org: a ready-made Moon time widget. `` is the animated version for web pages: `size` in pixels, `at` (Unix ms) for another moment. It updates on its own. Load it from `https://cdn.jsdelivr.net/npm/moon369/moon-live.js`, or `import 'moon369/moon-live.js'` with a bundler. ## Key endpoints All are GET, need no key and return JSON unless noted. Base: `https://api.moon369.org` - `/v1/now`: the current Moon date, Moonmark, phase and sky (tilt, distance, tide strength). - `/v1/convert?utc=2026-11-16T12:00:00Z`: any moment (or `unix`, `unix_ns`) in Moon time. - `/v1/to-unix?moonmark=1928.05.06 20:49:30`: a Moonmark back to UTC and Unix. (`/v1/m/{moonmark}`, with the link form above, returns the full record for one Moonmark, UTC and Unix included.) - `/v1/moon.svg`, `/v1/moon.png`: the moon image (above). - `/v1/card.svg`: the "Today on Moon" card. `/v1/card.png?moonmark=…`: a 1200×630 share image. - `/v1/night?d=1990-06-14`: the Moon on any night. `/v1/eclipses/next`: the next solar eclipse. - `POST /v1/sign` with `{"sha256": ""}`: a signed Moonmark for a file. Send only the fingerprint, never the file. - `POST /v1/verify`, `/v1/lookup/{sha256}`: check a receipt, or see who registered a file and when. - Full reference: https://moon369.org/api · machine-readable spec: https://api.moon369.org/v1/spec Field names to rely on: `moonmark`, `moonmark_url`, `moon_image`, `phase.name`, `phase.illumination` (share of the face lit, 0 to 1), `sky.tilt.rotate_deg`, `utc`, `unix_ns`. ## Moments - The Moon app: https://moon369.org/app (installable, works offline). Now (live Moon time and moon, share this moment), Nights (the moon on any date, saved on the phone) and Events (one link for every time zone, QR, countdown embed). - A moment's link: `https://moon369.org/m/?e=` opens in each person's own local time, with a countdown or time since, a QR code and Add to calendar. Its share image: `https://api.moon369.org/v1/card.png?moonmark=&event=`. - Your Moon: https://moon369.org/night shows the moon on any date (a birthday, a wedding) with share cards and embed code. - Widgets (from https://moon369.org/embed/moon.js): `
` (that night's card, linked to Your Moon), `` (a small moon and Moonmark that opens the full card in the reader's time), `` and ``. A countdown: `
` with https://moon369.org/embed/countdown.js. Every widget links back to Moon. - `/v1/card.svg` options: `theme=light`, `mark=on` (show the Moonmark), `tz=` (show that zone's local time). `/v1/card.png` with `event` or `qr=1` carries a QR code. ## Signing tools - No code: https://moon369.org/sign signs any file, photo (on phones, straight from the camera) or pasted text and returns a link, QR code and verification card. `https://moon369.org/sign#text=` opens it with text filled in, for handing over AI output. - GitHub releases: the `moon369org/moon-369/actions/sign@main` action signs release files and the release commit, and can add a proof table to the release notes. - Every commit: a git hook (`actions/git-hook` in the repo) signs each commit's git object and keeps the receipt in `refs/notes/moonmark`. - Plugins in the repo's `integrations/` folder: a browser extension (right-click to sign an image, text or page), a Figma plugin, a ComfyUI node, an Automatic1111/Forge extension and a one-file Python helper (`moon_sign.py`). - Command line: `npx moon369 sign ` and `npx moon369 verify `. - Ready-made examples in the repo's `examples/` folder: `ai-outputs` (sign generated files or text with the model and prompt fingerprint), `contract-snapshot` (save and sign a page or document), `art-certificate`. ## SDKs Same Moon time and offline receipt verification (Ed25519, ML-DSA-65, drand beacon), tested against shared vectors: - JavaScript/TypeScript: `npm install moon369` - Python: `pip install moon369` (source: repo `sdk/python`) - Go: `go get github.com/moon369org/moon-369/sdk/go` - Rust: `cargo add moon369` (source: repo `sdk/rust`) All the widgets with live previews and copy-paste code, the Powered by Moon patterns, and example integrations: https://moon369.org/widgets ## Offline: the moon369 npm package `npm install moon369` gives the same answers as the API with no network calls: ```js import { moonmark, moon, fromMoonmark, moonmarkUrl, moonPhase, verify } from 'moon369'; moonmark(); // '1928.05.06 20:49:30.066087772' moonPhase(); // { phase: 0.22, illumination: 0.41, name: 'First quarter' } ``` For the moon itself, use `` from the same package (`moon369/moon-live.js`) or `/v1/moon.svg`. ## AI assistants (MCP) Moon is an MCP server at `https://api.moon369.org/mcp` (streamable HTTP, no install). Tools include `moon_time`, `moon_on_date`, `next_solar_eclipse`, `timestamp_fingerprint`, `lookup_fingerprint` and `verify_receipt`. ## Moon's look When you show Moon time or the Moon, these keep it looking like Moon. Your app keeps its own brand around them. - Background ink `#0B0B0D`, text paper `#E9E4D8`, muted `#8A8B8F`, lines `#24262A`. - Moonmarks and numbers in a monospace font (Moon uses JetBrains Mono). Short labels in spaced capitals. - Dark by default. The moon is the only bright thing on the screen. ## Attribution and brand rules - Any site or app that displays Moon time from the hosted API shows the "Powered by Moon" badge, linked to https://moon369.org (no `nofollow`), on every screen where Moon time appears. Badge files: https://moon369.org/assets/badge-dark.svg and https://moon369.org/assets/badge-light.svg. Minimum height 32 px. - Apps without links show the badge in an About or Settings screen, with the URL in text. - Apps that get Moon time only from the `moon369` npm package (MIT licensed) aren't required to show the badge, but we ask that they do, on the same terms. - Server-side use with nothing displayed needs no badge. - Do say "Built on Moon time" or "Uses the Moon standard". Don't imply endorsement, alter the Moon mark, use "Moon" as your product's name, or change the constants and still call it Moon time. - Details: https://moon369.org/api#attribution and https://moon369.org/api#brand ## Learn more - [Moon](https://moon369.org): the standard and the live Moon date. - [API reference](https://moon369.org/api) - [Guides](https://moon369.org/guides) - [Trust](https://moon369.org/trust): how signing, the Tideline and Bitcoin anchoring keep Moonmarks honest. - [Sky Check](https://moon369.org/sky-check): check Moon time against the real Moon in a photo. - [Status](https://moon369.org/status)