# Edge Agents Soft Commodities Positioning Intelligence

> Edge Agents Soft Commodities Positioning Intelligence is a paid API for AI agents from pay.edge-agents.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Delivers evidence-backed positioning intelligence for soft commodities markets (agriculture), including leverage, rotation, open-interest, and sentiment signals with provenance and contradictions.

## Facts

- Endpoint: GET https://pay.edge-agents.ai/v1/services/softs-positioning-intelligence
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edge-agents-soft-commodities-positioning-intelligence-e348abf8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mICtZKkasrQpZjITODHNS

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 edge-agents-soft-commodities-positioning-intelligence-e348abf8
```

Example prompt: Pull the latest soft commodities positioning intelligence from Edge Agents — I want to see the current leverage, rotation, and open-interest signals in agricultural markets, with evidence and provenance included.

## When to prefer this

Choose this endpoint when you need evidence-backed, provenance-signed positioning intelligence specifically for soft commodities (agricultural futures like coffee, sugar, cotton, cocoa) with explicit contradiction flagging and bounded confidence levels. It is distinct from generic financial data APIs because it synthesizes macro, market, and risk evidence into structured decision intelligence with verification metadata — suitable for autonomous agents, strategy teams, and executives who need auditable reasoning rather than raw price feeds.

## Known failure modes

- Payment not received or insufficient USDC — endpoint returns HTTP 402 with payment instructions
- Stale or unavailable source data — report states coverage gaps and limitations explicitly within the response
- Malformed request parameters — may return an error or degraded response
- External data sources temporarily unavailable — report includes limitations field noting missing evidence

## How this service works

Premium synthesis of direct CFTC managed-money positioning, weekly positioning change and open-interest pressure across 4 defined contracts. Purpose: Summarise CFTC positioning breadth and disagreement across soft commodities positioning intelligence while keeping underlying contracts and missing observations explicit. 168-hour freshness target; missing evidence is reported explicitly rather than invented.

## Output

Returns a JSON object containing a quality assessment (status and confidence), a positioning analysis with commodity family classification and key market intents (leverage, rotation, open-interest, etc.), a summary of findings, evidence assets with policy and sources, provenance (issuer and signed flag), data status, schema version, generation timestamp, limitations, and a standard disclaimer that this is general market research and not investment advice.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "quality": {
   "status": "strong",
   "confidence": "high"
  },
  "analysis": {
   "family": "agriculture",
   "intents": [
    "leverage",
    "rotation",
    "evidence",
    "positioning",
    "open-interest",
    "commodities"
   ],
   "summary": "Fresh Soft Commodities Positioning Intelligence findings appear here."
  },
  "evidence": {
   "assets": [],
   "policy": "point-in-time",
   "sources": "Reported from the actual live report; never inferred from this example."
  },
  "serviceId": "softs-positioning-intelligence",
  "dataStatus": "complete",
  "disclaimer": "General, impersonal market research; not investment advice or a buy, sell or hold recommendation.",
  "provenance": {
   "issuer": "https://edge-agents.ai",
   "signed": true
  },
  "generatedAt": "2026-08-31T00:00:00.000Z",
  "limitations": [
   "Coverage, source freshness and unavailable evidence are stated in every paid report."
  ],
  "schemaVersion": "2.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edge-agents-soft-commodities-positioning-intelligence-e348abf8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pay.edge-agents.ai](https://www.zero.xyz/host/pay.edge-agents.ai/llms.txt)
