{"uid":"cap_EX-ZmWSCNsSSKly1bRz9l","slug":"ds-commodity-regime-endpoint-149d5166","name":"DS Commodity-Regime Endpoint","description":"Monthly, ed25519-signed regime classification for four commodity sectors plus macro context, served behind an x402 paywall.\n\nThe paid route returns HTTP 402 with an x402 payment challenge until a valid `X-PAYMENT` header is presented. Settlement is USDC on Base.\n\nSectors 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.\n\nInformation only. Not investment advice.","url":"https://ds-regime.sector-regime.workers.dev/regime","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_im2SMDu6dIWW6IVyJGANq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a monthly, ed25519-signed regime classification for copper, energy, gold, and agriculture commodity sectors plus macro context, gated behind an x402 USDC micropayment.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monthly commodity regime dashboard","prompt":"Get me the latest monthly commodity regime update — I want the regime color and confidence for each sector, the macro DXY trend, and a note on any sectors that had insufficient titan coverage."},{"title":"Verifying signed regime data for compliance","prompt":"Fetch this month's signed commodity regime report and confirm the ed25519 signature is valid so I can store it as a compliant, tamper-evident record of our market view."},{"title":"Automated regime-change alert","prompt":"Check the current commodity regime classifications and compare them to last month — flag any sectors where the regime changed or where confidence dropped, especially if copper or energy flipped."}],"resultDescription":"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'.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:03.120Z","isFirstParty":false}