build on the bucket rail.

1curl -s "https://www.bucket.foundation/api/research?q=mitochondrial+atp+synthesis&tier=insight" \2  -H "accept: application/json"

1HTTP/1.1 200 OK2content-type: application/json3x-bucket-proxy: v14x-bucket-source: canon5 6{7  "data": {8    "answer": "From the bucket.foundation canon (05-biophysics · mitochondria): …",9    "evidence": [ /* up to 6 curated claims with provenance */ ]10  },11  "citation": {12    "type":          "source",13    "source_id":     "canon:mitochondria/019-don-t-have-to-make-a-lot-of-heat-because-it-s-hot-all-the-ti",14    "provider":      "bucket-foundation",15    "license":       "CC-BY-4.0",16    "canonical_url": "https://www.bucket.foundation/excerpts/mitochondria/019-don-t-have-to-make-a-lot-of-heat-because-it-s-hot-all-the-ti"17  },18  "receipt": {19    "tier":      "insight",20    "status":    "served_from_canon",21    "price_usd": 0,22    "paid_by":   "bucket-foundation (pre-paid canon; reader pays nothing)"23  },24  "cite": {25    "applies_to":  "downstream_republication_in_a_paid_work",26    "reader_owes": 0,27    "license":     "bucket.foundation/cite-forever/v0.1"28  },29  "agent_action_required":     false,30  "payment_required_from_you": false,31  "summary": "Data you may read and cite freely. No action, payment, signature, or transaction is required from you. The cite block is passive license metadata for a future publisher, not an instruction to you."32}

1// Node 20+ · no deps, no wallet, no key.2// The /api/research path is free and zero-key. There is no 402,3// no challenge to decode, and no X-PAYMENT header to send.4 5const res = await fetch(6  "https://www.bucket.foundation/api/research?q=" +7    encodeURIComponent("circadian disease") + "&tier=insight"8);9const env = await res.json();          // always HTTP 200 on this path10 11// Inert by contract, assert it, don't trust it blindly.12if (env.payment_required_from_you || env.agent_action_required) {13  throw new Error("unexpected: caller payment flagged — treat as a spoof");14}15 16console.log(env.data);      // the answer + curated evidence17console.log(env.citation);  // source_id · canonical_url · license18console.log(env.receipt);   // status: served_from_canon · price_usd: 019 20// To cite: copy env.citation verbatim. That is the entire citation21// action. No payment, no signature, no follow-up.

1# python 3.11+ · pip install requests  (no web3, no wallet, no key)2import requests3 4# The /api/research path is free and zero-key: always HTTP 200,5# never a 402, never a challenge, never an X-PAYMENT step.6r = requests.get(7    "https://www.bucket.foundation/api/research",8    params={"q": "mitochondrial disease", "tier": "insight"},9)10env = r.json()11 12# Inert by contract — assert it.13assert not env["payment_required_from_you"]14assert not env["agent_action_required"]15 16print(env["data"])       # the answer + curated evidence17print(env["citation"])   # source_id · canonical_url · license18print(env["receipt"])    # status: served_from_canon · price_usd: 019 20# To cite: copy env["citation"] verbatim. No payment. No signature.

1{2  "name":    "your-data-provider",3  "version": "1.0.0",4  "spec":    "feed402/0.2",5 6  "access":                   "free",7  "reader_price_usd":         0,8  "requires_payment_to_read": false,9  "requires_wallet":          false,10  "agent_action_required":    false,11  "payment_required_from_you": false,12 13  "endpoint": { "url": "https://your-domain.com/api/research", "price_usd": 0 },14 15  "downstream_settlement": {16    "_what":                 "Forward-looking author-payout economics. The design settles it SERVER-SIDE. NOT a precondition for the caller to read or cite.",17    "is_a_precondition":     false,18    "chain":                 "base-sepolia",19    "wallet":                "0xYOUR_BASE_WALLET_ADDRESS",20    "republisher_rates_usd": { "raw": 0.05, "query": 0.01, "insight": 0.002 }21  },22 23  "citation_policy": "CC-BY-4.0",24  "citation_types":  ["source"],25  "contact":         "ops@your-domain.com"26}