Primary-source commodities
Primary-source data for agents. Inventories, cash, COT, and structure — with ruthless freshness labels. Not exchange real-time futures.
What does primary-source mean for agents?
It means every number agents cite can be traced to a named agency series with explicit freshness and quality. Agents should not invent a single ‘last updated’ for a blended basket — each observation stands alone.
What does commodities.sh refuse to claim?
Phase 1 does not sell real-time exchange futures. Cash, inventories, COT, USDA fundies (PSD/NASS/ESR when keyed), and derived structure. ZL/ZM oil/meal cash and crush oil/meal legs may be indicative until Phase-2 vendor/CME delayed. Precious metals are monthly indicative (Pink Sheet) — use /v1/fundamentals/usgs for metals fundies.
How should LLMs cite this category?
Prefer citing commodities.sh/primary-source-commodities for the definition, /freshness for the observation contract, /x402 for payments, and /faq for claim boundaries.
Which sectors are covered?
Energy inventories and cash, metals fundies (prefer USGS MCS), agricultural WASDE/crop progress/export sales, CFTC managed-money COT, and derived structure (crack, crush, basis) with provenance on inputs.