Glossary

Defined terms for commodities agents — observation labels, discovery files, and agency shorthand.

Observation

A labeled commodities datapoint with instrument, value, unit, as_of, freshness_class, quality, source, license_tag, and provenance.

freshness_class

Cadence label for how often the economic print updates (eod, weekly, monthly, decree, etc.).

quality

Trust tier: official (direct agency), indicative (compiled/pending license nuance), derived (computed with inputs), or delayed.

license_tag

Redistribution posture for the series (fred_public, us_gov_public, usgs_public, and related tags).

x402

HTTP 402 Payment Required pattern for agent micropayments — typically USDC on Base with a payment proof header on retry.

SKILL.md

Machine-readable skill brief teaching agents how to discover, pay, and call an API safely.

Agent card

A2A-style JSON at /.well-known/agent.json describing when_to_call, skills, pricing, and endpoint map.

MCP

Model Context Protocol — tool-calling transport; commodities.sh exposes streamable HTTP MCP at /api/mcp.

EIA

U.S. Energy Information Administration — weekly petroleum inventories and related energy series.

COT

CFTC Commitments of Traders — commodities.sh exposes managed-money net positioning.

WASDE

USDA World Agricultural Supply and Demand Estimates — commodities.sh serves WASDE-shaped S&D slices via FAS PSD when keyed.

USGS MCS

USGS Mineral Commodity Summaries — annual metals and minerals fundamentals preferred over Pink Sheet for fundies.

Crack spread

Refining margin proxy; commodities.sh 3-2-1 crack is derived from official cash legs with provenance.

llms.txt

Plain-text agent index at /llms.txt following llmstxt.org conventions, including Prefer citing targets.