{
  "kind": "lumi_trust_feed",
  "summary": "Licensed, keyed access to Lumi's x402 trust observations (quote checks, test-buys, payTo census) for facilitators, wallets and agent frameworks.",
  "plans": [
    {
      "plan": "free",
      "price_usd": "0",
      "lookups": "1000/month",
      "evidence": "answer-only",
      "rate_limit_per_min": 30,
      "signup": "GET https://api.lumitrades.io/v1/feed/challenge?wallet=<address>, sign it, POST https://api.lumitrades.io/v1/feed/keys"
    },
    {
      "plan": "feed_credits",
      "price_usd": "1.5",
      "lookups": "1000 prepaid, never expire",
      "evidence": "answer-only",
      "rate_limit_per_min": 60,
      "pay": "https://api.lumitrades.io/v1/feed/credits?key_id=<key id>"
    },
    {
      "plan": "feed",
      "price_usd": "99",
      "term_days": 30,
      "lookups": "100,000 per term",
      "evidence": "full (tx hashes, receipts)",
      "delta": true,
      "rate_limit_per_min": 120,
      "pay": "https://api.lumitrades.io/v1/feed/subscribe/feed?key_id=<key id> (omit key_id to get a new key)"
    },
    {
      "plan": "feed_pro",
      "price_usd": "199",
      "term_days": 30,
      "lookups": "500,000 per term",
      "evidence": "full (tx hashes, receipts)",
      "delta": true,
      "snapshot": true,
      "webhooks": true,
      "rate_limit_per_min": 600,
      "pay": "https://api.lumitrades.io/v1/feed/subscribe/feed_pro?key_id=<key id>"
    }
  ],
  "metering": "Lookups beyond the included amount use prepaid credits ($1.50 per 1,000). Without credits the request is refused (HTTP 429) and nothing is charged.",
  "auth": "Authorization: Bearer <api key> (or X-Lumi-Key). Keys are shown once; Lumi stores only a SHA-256 hash.",
  "endpoints": {
    "lookup": "POST https://api.lumitrades.io/v1/feed/lookup {items:[{url}|{payTo}], max 50} (also GET ?url= or ?payTo=)",
    "delta": "GET https://api.lumitrades.io/v1/feed/delta?since=<ISO time>&after_id=<id> (Feed, Feed Pro): status changes (quote validity, pays listed payTo, price match)",
    "snapshot": "GET https://api.lumitrades.io/v1/feed/snapshot?cursor=<id> (Feed Pro): paginated full catalog export, licensed",
    "webhook": "POST https://api.lumitrades.io/v1/feed/webhook {url} (Feed Pro): status-change webhooks, HMAC-signed",
    "usage": "GET https://api.lumitrades.io/v1/feed/usage"
  },
  "license": "https://api.lumitrades.io/v1/feed/license",
  "attribution": {
    "lumi": "Trust data: Lumi (lumitrades.io)",
    "vet402": "vet402 observatory (KIZUNA Creation), CC BY 4.0"
  },
  "auto_renew": false,
  "disclaimer": "Dated observations, not ratings or advice. Not financial advice."
}