API endpoints.
Eight public endpoints exposing the live bar state and the press archive. All allow cross-origin reads. None require an API key. Use them in scripts, bots, README badges, status pages, or wherever else you need a percentage that goes up.
See also: /badge (copy-paste embed snippets) · /about (what the site is)
/api/state
Full JSON state. Live percentage, leaderboard, recent transactions, lifetime stats.
curl -s https://boring.now/api/state | jq '.percentage'Powers the home page. Polled every 10s by clients without websocket support.
/api/state.txt
Plain-text ASCII poster. Curl-friendly. Fits in a terminal.
curl -s https://boring.now/api/state.txt20-block ASCII bar with current percent, target cap, last finisher, next-cycle countdown, lifetime views/dollars.
/api/bar.svg
Live SVG bar. Embed anywhere images render.
curl -s https://boring.now/api/bar.svg > bar.svgSee /badge for copy-paste markdown / HTML / BBCode snippets. 30s cache, open CORS.
/api/custom-bar.svg
Parameterized SVG. Render any progress bar in boring.now's style.
https://boring.now/api/custom-bar.svg?percent=42&label=PROJECT-X&footer=ship-itInputs: percent (0-100), label (24 char max), footer (60 char max). Default footer is “made at boring.now” for attribution. 5min cache.
/api/random-press
302 redirects to a random press article. Reader roulette.
curl -sIL https://boring.now/api/random-press | grep -i location12-entry path list (10 articles + glossary + cycles). Useful for share links, footers, and discovery.
/api/quote
Random press pull-quote. Plain text or JSON via Accept header.
curl -s -H 'Accept: application/json' https://boring.now/api/quote10-quote pool drawn from the press archive. Each call returns a random one. Use cases: Slack /quote commands, IRC bots, README rotating taglines.
/api/health
Uptime probe. Returns 200 with bar percentage and DB latency.
curl -s https://boring.now/api/health | jq '.'Lightweight - one Prisma findUnique. Cache-Control: no-store. Use for monitoring services.
/llms.txt
Plain-text overview for AI crawlers (llmstxt.org standard).
curl -s https://boring.now/llms.txtLists all press articles, mechanics, and lore characters so AI agents can ground accurate answers about the site.
/press/feed.xml
RSS 2.0 feed of all dispatches from The Boring Desk.
curl -s https://boring.now/press/feed.xmlSubscribe in any RSS reader. New press articles append at the top. <link rel="alternate"> in the root layout makes it auto-detected by Feedly / NetNewsWire.