Stable Tape for developers

$ curl -sS 'https://stabletape.com/api/ratio'

// Illustrative values. Every field the endpoint returns is shown.
{
  "odsPctRaw":           1.3308184918420052,   // preferred; unrounded PERCENT, not a 0-1 ratio
  "odsPctDisplay":       "1.33",                 // preferred; string, fixed 2dp
  "dddPctRaw":           1.3308184918420052,   // legacy compatibility alias
  "dddPctDisplay":       "1.33",                 // legacy compatibility alias
  "oneInN":              75,                     // reciprocal denominator; round(100 / odsPctRaw)
  "stablecoinSupplyUsd": 308153683423,           // whole USD
  "usM2Usd":             23155200000000,         // whole USD
  "m2Date":              "2026-06-01",           // FRED M2SL observation date, always a month start
  "m2DateLabel":         "JUN 2026",
  "updatedAt":           "2026-08-06T12:04:11.318Z",
  "sources": {
    "stablecoins": "DeFiLlama",
    "m2":          "FRED M2SL"
  }
}

$ curl -sS 'https://stabletape.com/api/tape?window=daily'
$ curl -sS 'https://stabletape.com/api/tape?window=daily&date=2026-06-25'

$ curl -sS 'https://stabletape.com/api/tape?window=daily-history'

$ curl -sS 'https://stabletape.com/api/tape?window=daily-history&limit=90'

// illustrative values; each record is a reduced projection, newest first
{
  "status":  "ok",
  "count":   41,          // whole stored archive, not the returned page
  "records": [
    {
      "date":                 "2026-07-29",
      "from":                 "2026-07-28T12:00:00.000Z",
      "to":                   "2026-07-29T12:00:00.000Z",
      "movement": {
        "status":       "available",
        "netDeltaUsd":  -250060285,
        "netDeltaPct":  -0.08111668888574356,
        "expandedUsd":  426210093,
        "contractedUsd": 676270378
      },
      "netIssuerMovementUsd": -250060285,
      "expandedUsd":          426210093,
      "contractedUsd":        676270378,
      "dailyAggregateChange": {
        "status":        "available",
        "methodVersion": "daily-aggregate-change-v1",
        "deltaUsd":       -250019746,
        "deltaPct":       -0.08110354030153145,
        "provenance": {
          "priorRecord":   { "date": "2026-07-28", "recordHash": "0b442c3b...", "totalSupplyUsd": 308272296216 },
          "currentRecord": { "date": "2026-07-29", "recordHash": "1b60c4d0...", "totalSupplyUsd": 308022276470 }
        }
      },
      "benchmark": {
        "totalSupplyUsd": 308022276470,
        "m2Used":         23155200000000,
        "m2AsOf":         "2026-06-01",   // FRED M2SL reference month
        "sharePctRaw":    1.33025098,
        "sharePct":       1.33,
        "oneInN":         75
      },
      "canonical":    true,
      "recordStatus": "canonical"
    }
  ],
  "gaps": [
    { "date": "2026-07-30", "type": "gap", "reason": "noon_anchor_unavailable" }
  ]
}

// Read the ODS summary account from Solana mainnet.
import('@snowplow1337/ddd-oracle-sdk').then(async ({ readDDD }) => {
  const { Connection } = await import('@solana/web3.js');
  const conn = new Connection('https://api.mainnet-beta.solana.com');

  const s = await readDDD(conn);

  // dddPercent is precomputed; totalStablesUsd is a bigint in whole USD.
  console.log('ODS     = ', s.dddPercent.toFixed(4) + '%');
  console.log('Stables = $' + (Number(s.totalStablesUsd) / 1e9).toFixed(2) + 'B');
});

import urllib.request, json, base64, struct
from datetime import datetime, timezone

# Base58 encoder (no deps)
ALPH = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def b58(b):
    n = int.from_bytes(b, 'big'); s = ''
    while n: n, r = divmod(n, 58); s = ALPH[r] + s
    return '1' * (len(b) - len(b.lstrip(b'\x00'))) + s

# Fetch all 4 oracle accounts in one RPC call
req = urllib.request.Request(
    'https://api.mainnet-beta.solana.com',
    data=json.dumps({
        "jsonrpc": "2.0", "id": 1, "method": "getMultipleAccounts",
        "params": [[
            "8DAncbbsEkmsCCakHpNK5zf49XLcWQrryTBYdjgcLWxA",  # summary
            "97g36T1PV3anxCwxV6ue5MmF2A9HQHMsLqevckrkqjzK", # chains
            "GznG6pxbLPrqeYDd5aFXJcXK5SQ4wXifBtqjep34DNe",  # issuers
            "7FRjdiN489qMU2R8G2RumBPxRjanY9683gnXttKP4Fhv",  # tokens
        ], {"encoding": "base64"}],
    }).encode(),
    headers={'Content-Type': 'application/json'},
)
r = json.loads(urllib.request.urlopen(req).read())['result']['value']
s, c, ib, t = (base64.b64decode(a['data'][0]) for a in r)
ts_utc = lambda u: datetime.fromtimestamp(u, tz=timezone.utc).isoformat()

# Summary account, offset 73 onward: ddd, total_stables_usd, m2_usd, timestamp, slot, sequence
ddd, stb, m2, ts, slot, seq = struct.unpack_from('<QQQqQQ', s, 73)
# Concentration fields follow the three u8 counts at 121/122/123.
hhi, eff, top = struct.unpack_from('<III', s, 124)

print(f"ODS ratio : {ddd/1e4:.4f}%")          # raw / 1e4 == percent
print(f"Stables   : ${stb/1e9:,.4f}B")        # whole USD, so /1e9 == billions
print(f"U.S. M2   : ${m2/1e12:,.4f}T")
print(f"Issuer HHI: {hhi}  (effective {eff/1e6:.2f}, top {top/1e6:.2f}%)")
print(f"Updated   : {ts_utc(ts)}  (slot {slot:,})")
print(f"Sequence  : {seq}")
print(f"Admin     : {b58(s[8:40])}")

# Book accounts: count at byte 25, then fixed 29-byte entries from byte 26.
def read_book(name, d):
    cnt = d[25]
    print(f"\n--- {name}  (count={cnt}) ---")
    for k in range(cnt):
        o = 26 + k*29
        nm = d[o+1:o+1+d[o]].decode('utf-8', errors='replace')
        sup, pct = struct.unpack_from('<QI', d, o+17)
        print(f"  {k+1:<3} {nm:<16} ${sup/1e9:>10,.2f}B  {pct/1e6:.4f}%")

read_book('CHAINS',  c)
read_book('ISSUERS', ib)
read_book('TOKENS',  t)

# Static example. This page runs no browser-side RPC call of its own:
# third-party RPC endpoints set their own CORS and CSP rules, so a
# documentation page is the wrong place to read from one. Run the
# snippet above from a server or a shell for real values.
ODS ratio : 1.3500%
Stables   : $305.0000B
U.S. M2   : $22.5900T
Issuer HHI: 3120  (effective 3.21, top 61.40%)
Updated   : 2026-08-06T12:00:00+00:00  (slot ...)
Sequence  : ...

$ curl -sS https://api.mainnet-beta.solana.com \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getAccountInfo",
    "params": [
      "8DAncbbsEkmsCCakHpNK5zf49XLcWQrryTBYdjgcLWxA",
      { "encoding": "base64", "commitment": "confirmed" }
    ]
  }'

$ curl -sS 'https://api.mainnet-beta.solana.com' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"getAccountInfo","params":["8DAncbbsEkmsCCakHpNK5zf49XLcWQrryTBYdjgcLWxA",{"encoding":"base64","commitment":"confirmed"}]}' \
| python3 -c '
import sys, json, base64, struct
from datetime import datetime, timezone
j = json.load(sys.stdin)
raw = base64.b64decode(j["result"]["value"]["data"][0])
ddd, stb, m2, ts, slot, seq = struct.unpack_from("<QQQqQQ", raw, 73)
print("ODS %     ", round(ddd / 1e4, 4))
print("Stables   ", "${:.2f}B".format(stb / 1e9))
print("U.S. M2   ", "${:.2f}T".format(m2 / 1e12))
print("Updated   ", datetime.fromtimestamp(ts, tz=timezone.utc).strftime("%Y-%m-%d %H:%M UTC"))
print("Slot      ", slot)
print("Sequence  ", seq)
'