Use cases

Which use case should an energy agent start with?

Start with EIA inventories for weekly stocks and surprise, then crack spreads for refining structure, and COT for positioning context.

Which use case covers metals fundies?

Use USGS minerals. Prefer Mineral Commodity Summaries over monthly Pink Sheet indicative prints when reasoning about metals fundamentals.

When should an agent use decision packs?

When the desk needs multi-series sector context in one x402 call — see the agent trading desk use case for snapshots and packs.

All use cases

• EIA inventories for agents

  /v1/inventory/eia

  Weekly U.S. petroleum stock prints from EIA — crude, Cushing, gasoline, distillate — with WoW and vs-5y surprise for autonomous desk agents.

• Crack & structure spreads

  /v1/spreads/crack

  Derived refining and crush structure from official cash legs — 3-2-1 crack, soy crush proxy, and WTI-Brent basis — with inputs cited in provenance.

• COT positioning

  /v1/cot/{code}

  CFTC Commitments of Traders managed-money nets for commodities agents that need positioning context alongside cash and inventories.

• USDA WASDE & ags fundies

  /v1/fundamentals/wasde

  WASDE-shaped supply and demand slices, NASS crop progress, and FAS export sales for agricultural commodity agents.

• USGS minerals fundies

  /v1/fundamentals/usgs

  Annual USGS Mineral Commodity Summaries for metals and minerals — preferred over monthly Pink Sheet indicative prints for fundies context.

• Agent trading desk packs

  /v1/snapshot/{sector}

  Sector snapshots and deterministic decision packs that bundle multi-series commodities context into one x402 call for desk-style agents.