# Edge Agents Coffee Managed Money Positioning

> Edge Agents Coffee Managed Money Positioning is a paid API for AI agents from pay.edge-agents.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns evidence-backed analysis of managed money positioning in coffee futures markets, including leverage, open interest, and speculator sentiment with provenance and contradictions.

## Facts

- Endpoint: GET https://pay.edge-agents.ai/v1/services/coffee-managed-money-positioning
- 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/edge-agents-coffee-managed-money-positioning-a92d7009
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rE_esyWXQToRwu3g2_Zax

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-coffee-managed-money-positioning-a92d7009
```

Example prompt: Pull the latest managed money positioning report for coffee futures from Edge Agents — I want to see whether speculators are net long or short, the confidence level, and any contradictions flagged in the evidence.

## When to prefer this

Choose this endpoint when you need point-in-time, evidence-backed managed money positioning specifically for coffee futures with signed provenance and explicit contradiction flagging. It is preferable over generic market data APIs when you need interpretive decision intelligence (not raw price data), when auditability and source provenance matter, or when integrating into an autonomous agent workflow that needs structured, bounded outputs with confidence levels.

## Known failure modes

- Payment not received or x402 payment header missing — returns 402 Payment Required
- Service temporarily unavailable or data pipeline issue — returns 5xx error
- Stale or incomplete underlying data — report will note coverage limitations in the limitations field
- No managed money positioning update available for the current period — dataStatus field may reflect partial data

## How this service works

Direct CFTC Commitments of Traders managed-money long, short, spread and net positioning for Coffee, with open-interest share and exact contract provenance. Purpose: Measure the latest CFTC managed-money net positioning in Coffee without inferring trader motive or predicting price direction. 168-hour freshness target; missing evidence is reported explicitly rather than invented.

## Output

A JSON object containing a quality status with confidence rating, an analysis block with the commodity family (agriculture), key intents (leverage, evidence, positioning, open-interest), and a narrative summary of coffee managed money positioning findings. Also includes evidence metadata listing covered assets (COFFEE), policy type (point-in-time), signed provenance from edge-agents.ai, a generatedAt timestamp, schema version, limitations disclosure, a data status field, and a standard disclaimer that the output 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",
    "evidence",
    "positioning",
    "open-interest",
    "commodities"
   ],
   "summary": "Fresh Coffee Managed Money Positioning findings appear here."
  },
  "evidence": {
   "assets": [
    "COFFEE"
   ],
   "policy": "point-in-time",
   "sources": "Reported from the actual live report; never inferred from this example."
  },
  "serviceId": "coffee-managed-money-positioning",
  "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-coffee-managed-money-positioning-a92d7009/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)
