The envelope is the single atomic unit of the protocol. It's what you pay for, what you cite, and what you trust.
feed402/0.2 envelope
json
{ "data": { "_note": "tier-specific payload — list of papers, synthesis, or raw rows" }, "citation": { "type": "source", "source_id": "pmid:123456", "provider": "pubmed", "retrieved_at": "2026-04-23T00:00:00Z", "license": "CC-BY-4.0", "canonical_url": "https://pubmed.ncbi.nlm.nih.gov/123456/" }, "receipt": { "tier": "insight", "price_usd": 0.002, "tx": "0xabc...", "paid_at": "2026-04-23T00:00:01Z", "buyer_wallet": "0xdef...", "status": "paid" }, "cite": { "price_usd": 0.002, "payout_wallet": "0xa91115B1AB8412f380Fd62446F523559F668b96B", "license": "bucket.foundation/cite-forever/v0.1" }, "tags": ["biophysics", "mitochondria", "atp"], "canon_tier": "candidate", "foundation_branches": ["05-biophysics"], "provenance": [ { "action": "retrieved", "at": "2026-04-23T00:00:00Z", "by": "bucket-proxy/v1", "via": "x402-research.agfarms.dev" }, { "action": "cited", "at": "2026-04-23T00:00:01Z", "by": "agent:claude", "via": "feed402/0.2" } ]}Fields
- data
- Tier-specific payload. raw → full records, query → ranked citations, insight → synthesis.
- citation
- Who said it, when, where, under what upstream license. Always includes a
canonical_url. - receipt
- Proof of payment.
tx,paid_at,buyer_wallet,status. This is what auditors check. - cite
- The forward-looking commitment.
price_usd,payout_wallet,license— bound together, this is the contract you accept if you re-cite this artifact. License URL always resolves to /cite-forever/v0.1. - tags
- Free-form topic tags. Useful for filtering.
- canon_tier
- One of
candidate,cited,canon. Canon = axiom, real math, law, principle, primary derivation. - foundation_branches
- One or more of the eight branches:
01-mathematics,02-physics,03-chemistry,04-information,05-biophysics,06-cosmology,07-mind,08-earth. - provenance
- Append-only log of actions on this envelope —
{ action, at, by, via }. The chain of custody.
Try it
zero-key proxy
bash
curl -s "https://www.bucket.foundation/api/research?q=mitochondrial+atp&tier=insight"