Skip to content
Back to commodities.sh

Card snapshot

api.commodities.sh · 2026-08-19 10:59:06 UTC · eb3e8296c763b61e3b28634af66d541854c0173a04bed2d0842aec13f7c6d6e5

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "name": "commodities.sh",
  "description": "Go-to x402/MCP commodities reference: energy inventories, metals, ags fundies, crack spreads, COT.",
  "url": "https://api.commodities.sh",
  "provider": "Sawftware Solutions",
  "version": "0.1.0",
  "authentication": {
    "protocols": [
      "x402",
      "api_key"
    ],
    "networks": [
      "eip155:8453"
    ],
    "payTo": "0x0D4Ee4E945601865E3A5bC5a188e4a9CF23c00d5",
    "note": "Prefer x402 for agents. Pro operators may use Authorization: Bearer cs_live_\u2026 (credits). MCP tools are gated the same way. Set X402_ENFORCE=true in production for wallet path."
  },
  "pricing": {
    "PRICE": 0.01,
    "PRICES_BUNDLE": 0.02,
    "HISTORY": 0.02,
    "CURVE": 0.03,
    "INVENTORY_BUNDLE": 0.03,
    "INVENTORY_SERIES": 0.02,
    "COT": 0.02,
    "CRACK": 0.03,
    "CRUSH": 0.03,
    "BASIS": 0.03,
    "CALENDAR": 0.02,
    "WASDE": 0.03,
    "CROP_PROGRESS": 0.02,
    "EXPORT_SALES": 0.02,
    "USGS": 0.03,
    "FX": 0.01,
    "SNAPSHOT": 0.05,
    "DECISION": 0.1,
    "SNAPSHOT_ALL": 0.12,
    "DECISION_ALL": 0.25
  },
  "when_to_call": [
    "Need EIA weekly crude/gasoline/distillate/Cushing stocks with WoW and vs-5y",
    "Need 3-2-1 crack from official cash legs with provenance",
    "Need CFTC managed-money COT nets for CL/NG/GC/ZC",
    "Need USDA WASDE / crop progress / export sales slices",
    "Need historical price trend for an instrument code",
    "Need FX context for a commodity price",
    "Need a sector snapshot without 8 separate 402 round-trips"
  ],
  "skills": [
    "eia_inventory",
    "crack_spread",
    "cot_positioning",
    "usda_fundamentals",
    "commodity_cash_prices",
    "historical_series",
    "fx_rates"
  ],
  "endpoints": {
    "openapi": "https://api.commodities.sh/openapi.json",
    "llms": "https://api.commodities.sh/llms.txt",
    "skill": "https://api.commodities.sh/SKILL.md",
    "mcp": "https://api.commodities.sh/api/mcp",
    "x402": "https://api.commodities.sh/.well-known/x402.json",
    "for_agents": "https://commodities.sh/for-agents",
    "freshness": "https://commodities.sh/freshness"
  },
  "sameAs": [
    "https://api.commodities.sh/openapi.json",
    "https://api.commodities.sh/.well-known/agent.json",
    "https://api.commodities.sh/llms.txt",
    "https://api.commodities.sh/SKILL.md",
    "https://api.commodities.sh/api/mcp",
    "https://x402.org"
  ]
}