# DS Commodity-Regime Endpoint

> DS Commodity-Regime Endpoint is a paid API for AI agents from ds-regime.sector-regime.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a monthly, ed25519-signed regime classification for copper, energy, gold, and agriculture commodity sectors plus macro context, gated behind an x402 USDC micropayment.

## Facts

- Endpoint: GET https://ds-regime.sector-regime.workers.dev/regime
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ds-commodity-regime-endpoint-149d5166
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EX-ZmWSCNsSSKly1bRz9l

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ds-commodity-regime-endpoint-149d5166
```

Example prompt: Pull this month's commodity regime classifications for all sectors — I want to see which ones are thesis-intact vs deteriorating, the macro regime color, and whether any sectors came back as insufficient sources.

## When to prefer this

Choose this endpoint when you need a cryptographically-signed, attestable monthly regime classification across commodity sectors (copper, energy, gold, agriculture) plus macro context, and when you need explicit coverage transparency (gray/insufficient_sources) rather than silent omissions. Prefer it over generic market-data feeds when auditability (ed25519 signature) and structured regime vocabulary (thesis_intact, deteriorating, etc.) matter, and when a $0.01 USDC per-call micropayment model is acceptable.

## Known failure modes

- HTTP 402 returned with x402 payment challenge if no valid X-PAYMENT header is present
- Invalid or expired USDC payment header results in payment rejection
- Service may return stale data if the monthly update cycle has not yet completed
- Sectors with limited titan coverage return 'insufficient_sources' rather than a regime signal — not an error, but indicates limited data backing

## How this service works

Monthly, ed25519-signed regime classification for four commodity sectors plus macro context, served behind an x402 paywall.

The paid route returns HTTP 402 with an x402 payment challenge until a valid `X-PAYMENT` header is presented. Settlement is USDC on Base.

Sectors that lack sufficient independent titan coverage in a given cycle are published explicitly as `insufficient_sources` (colour `gray`) rather than being omitted — a buyer always sees the full sector list and can tell which entries are backed.

Information only. Not investment advice.

## Output

A JSON object containing: a macro block (regime label, DXY trend, confidence, color), an array of sector objects (sector name, regime, thesis status, titan consensus, drivers, confidence, color, change vs previous, as_of date), cryptographic provenance (ed25519 public key and signature), cadence, generated_at timestamp, next_update date, and schema version. Sectors with insufficient independent coverage are explicitly returned with color 'gray' and status 'insufficient_sources'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "macro": {
   "regime": "neutral",
   "dxy_trend": "flat",
   "confidence": "medium",
   "regime_color": "yellow"
  },
  "cadence": "monthly",
  "sectors": [
   {
    "as_of": "2026-07-20",
    "regime": "thesis_intact",
    "sector": "copper",
    "drivers": [
     "titan_consensus_split"
    ],
    "confidence": "medium",
    "regime_color": "green",
    "thesis_status": "structural supply deficit narrative holding; demand proxy firm",
    "change_vs_prev": "unchanged",
    "titan_consensus": "split"
   }
  ],
  "provenance": {
   "pubkey": "CEB6LaGG…GbU=",
   "signature": "…",
   "signature_alg": "ed25519"
  },
  "next_update": "2026-08-20",
  "generated_at": "2026-07-20T09:49:19.980Z",
  "schema_version": "1.1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ds-commodity-regime-endpoint-149d5166/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ds-regime.sector-regime.workers.dev](https://www.zero.xyz/host/ds-regime.sector-regime.workers.dev/llms.txt)