Bitcoin widget for your iPhone

A free home-screen widget with the bitcoin price, 24-hour change, sats per $1, block height and days to the next halving.

It runs inside Scriptable, a free app by Simon B. Støvring that runs small JavaScript files. It's not an App Store app of ours, and we don't make Scriptable.

Mockup of the small and medium Hold My Bitcoin widgets, with example values

Install (about 2 minutes)

Install Scriptable from the App Store (free).
Tap Copy script below.
Open Scriptable, tap + (top right), paste, then tap the title at the top and name it Hold My Bitcoin. Tap Done.
On your home screen, touch and hold an empty spot, tap Edit then Add Widget (or +), pick Scriptable, choose small or medium, and tap Add Widget.
Touch and hold the new widget, tap Edit Widget, and set Script to Hold My Bitcoin. Leave When Interacting on Open URL to open this site when you tap it.

Show the script (84 lines)

// Variables used by Scriptable.
// These must be at the very top of the file. Do not edit.
// icon-color: orange; icon-glyph: bitcoin-sign;
/*
 * Hold My Bitcoin widget for Scriptable (free iOS app). https://holdmybitcoin.com/widget/
 * Shows: BTC/USD (Coinbase), 24h change, sats per $1, block height and an estimated next-halving countdown (mempool.space).
 * No keys, no tracking. If a source fails it shows the last saved values and marks them "stale".
 * iOS decides when widgets refresh; we only ask for about every 15 minutes.
 * Not financial advice. Made by Overfit Labs, support@getdailyedge.com
 */
const HMB = {
  ORANGE: "#f7931a", BG: "#0b0b0c", CARD: "#151517", FG: "#f4f4f5", MUT: "#a1a1aa", UP: "#4ade80", DN: "#f87171",
  URL: "https://holdmybitcoin.com/?source=widget", HALVING: 210000, CACHE: "hmb-widget.json",
  SRC: { spot: "https://api.coinbase.com/v2/prices/BTC-USD/spot", stats: "https://api.exchange.coinbase.com/products/BTC-USD/stats", height: "https://mempool.space/api/blocks/tip/height" },
};

/* ---- pure helpers (tested with node) ---- */
function parseSpot(j) { const a = parseFloat(j && j.data && j.data.amount); return a > 0 ? a : null; }
function parseChange(j, price) { const o = parseFloat(j && j.open), l = price || parseFloat(j && j.last); return o > 0 && l > 0 ? (l / o - 1) * 100 : null; }
function parseHeight(t) { const h = parseInt(String(t).trim(), 10); return /^\d{6,8}$/.test(String(t).trim()) && h > 0 ? h : null; }
function halving(h) { const next = (Math.floor(h / HMB.HALVING) + 1) * HMB.HALVING, left = next - h; return { next, left, days: Math.round(left * 10 / 1440) }; }
function satsPerDollar(p) { return p > 0 ? Math.round(1e8 / p) : null; }
function money(x) { return x == null ? "–" : "$" + Math.round(x).toLocaleString("en-US"); }
function pct(x) { return x == null ? "–" : (x >= 0 ? "+" : "") + x.toFixed(2) + "%"; }
function int(x) { return x == null ? "–" : Math.round(x).toLocaleString("en-US"); }
/* Merge fresh values over the cache; anything missing stays from the cache and is marked stale. */
function merge(fresh, cache) {
  const out = { stale: [] }, c = cache || {};
  ["price", "change", "height"].forEach(k => { if (fresh[k] != null) { out[k] = fresh[k]; out[k + "At"] = fresh.at; } else if (c[k] != null) { out[k] = c[k]; out[k + "At"] = c[k + "At"]; out.stale.push(k); } else out[k] = null; });
  if (out.change != null && out.stale.indexOf("price") >= 0 && out.stale.indexOf("change") < 0) out.stale.push("change");
  return out;
}

/* ---- Scriptable runtime ---- */
async function getJSON(u) { const r = new Request(u); r.timeoutInterval = 10; return r.loadJSON(); }
async function getText(u) { const r = new Request(u); r.timeoutInterval = 10; return r.loadString(); }
async function safe(f) { try { return await f(); } catch (e) { return null; } }
function fm() { return FileManager.local(); }
function readCache() { try { const f = fm(), p = f.joinPath(f.documentsDirectory(), HMB.CACHE); return f.fileExists(p) ? JSON.parse(f.readString(p)) : null; } catch (e) { return null; } }
function writeCache(d) { try { const f = fm(); f.writeString(f.joinPath(f.documentsDirectory(), HMB.CACHE), JSON.stringify(d)); } catch (e) {} }
async function load() {
  const at = Date.now();
  const [spot, stats, ht] = await Promise.all([safe(() => getJSON(HMB.SRC.spot)), safe(() => getJSON(HMB.SRC.stats)), safe(() => getText(HMB.SRC.height))]);
  const price = parseSpot(spot), d = merge({ price, change: parseChange(stats, price), height: parseHeight(ht), at }, readCache());
  writeCache(d); return d;
}
function logo(size) {
  const c = new DrawContext(); c.size = new Size(64, 64); c.opaque = false; c.respectScreenScale = true;
  c.setFillColor(new Color(HMB.ORANGE)); c.fillEllipse(new Rect(8, 8, 48, 48));
  c.setFillColor(new Color(HMB.BG)); [[21, 18, 6, 28], [37, 18, 6, 28], [21, 29, 22, 6], [27.5, 11, 3, 8], [33.5, 11, 3, 8], [27.5, 45, 3, 8], [33.5, 45, 3, 8]].forEach(r => c.fillRect(new Rect(r[0], r[1], r[2], r[3])));
  return c.getImage();
}
function text(stack, s, size, color, weight) { const t = stack.addText(s); t.font = weight === "bold" ? Font.boldSystemFont(size) : weight === "mono" ? Font.boldMonospacedSystemFont(size) : Font.systemFont(size); t.textColor = new Color(color); t.lineLimit = 1; t.minimumScaleFactor = 0.6; return t; }
function build(d, family) {
  const w = new ListWidget(); w.url = HMB.URL; w.backgroundColor = new Color(HMB.BG); w.setPadding(12, 14, 10, 14);
  w.refreshAfterDate = new Date(Date.now() + 15 * 60 * 1000);   // a request; iOS chooses the real time
  const head = w.addStack(); head.centerAlignContent(); const im = head.addImage(logo()); im.imageSize = new Size(18, 18); head.addSpacer(5);
  text(head, "Hold My ", 12, HMB.FG, "bold"); text(head, "Bitcoin", 12, HMB.ORANGE, "bold");
  w.addSpacer(6);
  text(w, money(d.price), family === "small" ? 24 : 28, HMB.FG, "bold");
  const ch = d.change; text(w, pct(ch) + " 24h", 12, ch == null ? HMB.MUT : ch >= 0 ? HMB.UP : HMB.DN, "bold");
  w.addSpacer(4);
  const hv = d.height ? halving(d.height) : null;
  if (family === "small") {
    text(w, int(satsPerDollar(d.price)) + " sats per $1", 11, HMB.MUT);
    text(w, hv ? "Halving ~" + int(hv.days) + " days" : "Halving –", 11, HMB.MUT);
  } else {
    const row = w.addStack(); row.spacing = 14;
    [["Sats per $1", int(satsPerDollar(d.price))], ["Block", int(d.height)], ["Next halving", hv ? "~" + int(hv.days) + " days" : "–"]].forEach(x => {
      const s = row.addStack(); s.layoutVertically(); text(s, x[0], 10, HMB.MUT); text(s, x[1], 14, HMB.FG, "bold"); });
  }
  w.addSpacer();
  const foot = w.addStack(); text(foot, "holdmybitcoin.com", 9, HMB.ORANGE, "bold"); foot.addSpacer();
  const df = new DateFormatter(); df.useShortTimeStyle(); df.useNoDateStyle();
  const t = text(foot, (d.stale.length ? "stale · " : "") + df.string(new Date(d.priceAt || Date.now())), 9, d.stale.length ? "#fbbf24" : HMB.MUT);
  return w;
}
async function main() {
  const d = await load(), fam = config.widgetFamily || "medium", w = build(d, fam === "small" ? "small" : "medium");
  if (config.runsInWidget) Script.setWidget(w); else if (fam === "small") await w.presentSmall(); else await w.presentMedium();
  Script.complete();
}
if (typeof module !== "undefined") module.exports = { parseSpot, parseChange, parseHeight, halving, satsPerDollar, money, pct, merge, build, HMB };
if (typeof Script !== "undefined") await main();

What it shows and where it comes from

Price and 24h change: Coinbase public BTC-USD data (spot price, and the change from the price 24 hours ago).
Sats per $1: 100,000,000 divided by the price.
Block height: mempool.space.
Next halving: blocks left to the next multiple of 210,000, at about 10 minutes per block. It's an estimate; the real date depends on block times.
Time: when the data last loaded. If a source fails, it shows the last saved value and marks it stale.

Good to know

The widget asks iOS to refresh about every 15 minutes, but iOS decides the actual timing, and it is often less frequent.
No account, no keys, no tracking. The script talks only to Coinbase and mempool.space, and saves its last values in Scriptable's own files on your phone.
You can read every line before you paste it. Not financial advice.

For information and education only. Not financial advice. Past prices don't predict future prices.