commodities.sh

Docs

API reference

Paid paths are priced in USDC per call. Free discovery stays free.

Paid endpoints

PathUSDC
GET /v1/price/{code}$0.01
GET /v1/prices?codes=$0.02
GET /v1/history/{code}$0.02
GET /v1/inventory/eia$0.03
GET /v1/inventory/eia/{series}$0.02
GET /v1/cot/{code}$0.02
GET /v1/spreads/crack$0.03
GET /v1/spreads/crush$0.03
GET /v1/spreads/basis$0.03
GET /v1/fundamentals/wasde$0.03
GET /v1/fundamentals/crop-progress$0.02
GET /v1/fundamentals/export-sales$0.02
GET /v1/fundamentals/usgs$0.03
GET /v1/fx/{pair}$0.01
GET /v1/snapshot/{sector}$0.05
GET /v1/decision/{sector}$0.10
GET /v1/snapshot/all$0.12
GET /v1/decision/all$0.25

Free discovery paths

Where is the machine-readable spec?

GET /openapi.json on the same host. Pair it with /.well-known/x402.json for payment metadata and /v1/catalog for live instruments and pricing_usd.

Are curve and calendar spreads live?

Some paths (curve, calendar spreads) may be Phase-2 stubs when indicative futures are off. Read the catalog claims and observation quality before trading on them.

← Docs hubPricing page →

Related