GM! Index — programmatic reference

# 1. Free: discover live catalog, prices, and schemas
curl https://gm.mutantdefi.com/services.json | jq '.services[] | {id, path: .http.path, price: .price_usd}'

# 2. Free: your first conviction cell (one free per caller fingerprint)
curl "https://gm.mutantdefi.com/v1/gm/conviction?symbol=BTC1D/DFY"

# 3. Free: feed metadata + validation telemetry
curl https://gm.mutantdefi.com/v1/feed/metadata

# ACP job history — requirements are on MESSAGE entries, not event.
import json, datetime, subprocess

raw = subprocess.check_output(
    ["acp", "job", "history", "--job-id", "JOB_ID", "--chain-id", "8453", "--json"],
    text=True,
)
d = json.loads(raw)
print("status:", d.get("status"))
for e in d.get("entries") or []:
    ts = e.get("timestamp") or 0
    t = datetime.datetime.utcfromtimestamp(ts / 1000).strftime("%H:%M:%S") if ts else "?"
    if e.get("kind") == "system":
        ev = e.get("event") or {}
        print(f"{t} system   {ev.get('type')}")
    else:
        # NEVER use e.get("event") here — it is empty on messages.
        print(f"{t} message  {e.get('contentType')}: {e.get('content')}")

# First call → 402 with payment requirements
curl -i "https://gm.mutantdefi.com/v1/gm/lattice?universe=core6&horizon=1D"

# 402 body (shape):
# { "x402Version": 1,
#   "accepts": [{ "scheme": "exact", "network": "base",
#     "maxAmountRequired": "100000",   # atomic USDC (6dp) = $0.10
#     "asset": "USDC", "payTo": "0x430c…8059",
#     "resource": "/v1/gm/lattice" }] }

# After settling, retry with the payment proof:
curl "https://gm.mutantdefi.com/v1/gm/lattice?universe=core6&horizon=1D" \
  -H "X-PAYMENT: <settlement-proof-from-facilitator>"

# Paid GM! cell (x402). Prefer the Virtuals agent checkout in production.
# Local gateways accept X402_SKIP_PAYMENT=true for integration tests.
import httpx

r = httpx.get(
    "https://gm.mutantdefi.com/v1/gm/conviction",
    params={"symbol": "BTC1D/DFY"},
    timeout=30,
)
if r.status_code == 402:
    # Settle via x402 / ACP, then retry with payment proof headers
    print(r.headers.get("PAYMENT-REQUIRED") or r.text[:200])
else:
    cell = r.json()
    print(cell["symbol"], cell["value"], cell.get("omega_mass"))

const GM = "https://gm.mutantdefi.com";

// Free tool registry
const registry = await fetch(`${GM}/mcp/tools`).then((r) => r.json());

// Paid execute — same settlement as HTTP x402 routes
const paid = await fetch(`${GM}/mcp/execute`, {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    name: "get_gm_lattice",
    args: { universe: "core6", horizon: "1D" },
  }),
});
// 402 → settle → retry; 200 → { name, result }
console.log(await paid.json());

# Hermes connector — desk owns the store; Hermes only pushes/pulls.
# Set HERMES_INGEST_TOKEN on dfy-desk; never expose on public A routes.
import httpx
import os

DESK = "https://desk.mutantdefi.com"
token = os.environ["HERMES_INGEST_TOKEN"]
headers = {"Authorization": f"Bearer {token}"}

# Trader → desk (outbound push)
httpx.post(
    f"{DESK}/v1/dfy/ingest",
    headers=headers,
    json={"kind": "runner", "data": {"symbol": "BTC", "event": "heartbeat"}},
    timeout=30,
).raise_for_status()

# Optional Tier-C oracle snapshot (operator / hermes-agent)
snap = httpx.get(f"{DESK}/v1/dfy/snapshot", headers=headers, timeout=60).json()
print(snap.keys())

import httpx

GM = "https://gm.mutantdefi.com"

# Free discovery — machine catalog is source of truth
catalog = httpx.get(f"{GM}/services.json", timeout=30).json()
tools = httpx.get(f"{GM}/mcp/tools", timeout=30).json()
print(catalog["product_name"], len(catalog.get("acp_offering_ids", [])))
print("mcp tools:", len(tools.get("tools", tools) if isinstance(tools, dict) else tools))

// Desk uses base tickers (BTC), never BTC1D/DFY
const desk = await fetch(
  "https://desk.mutantdefi.com/v1/dfy/desk?symbol=BTC",
).then(async (r) => {
  if (r.status === 402) throw new Error("settle x402 then retry");
  return r.json();
});
console.log(desk.symbol, desk.regime);

// apps.mutantdefi.com BFF — Virtuals front only (fails closed without bearer)
const apps = "https://apps.mutantdefi.com";
const symbol = encodeURIComponent("BTC1D/DFY");
const r = await fetch(`${apps}/api/dfy/ccxt/ticker?symbol=${symbol}`, {
  headers: { Authorization: `Bearer ${process.env.DFY_TICKER_ACCESS_TOKEN}` },
});
console.log(r.status, await r.json());