# Edge Agents Cocoa Positioning Momentum Intelligence

> Edge Agents Cocoa Positioning Momentum Intelligence 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-14).

Returns evidence-backed cocoa commodity positioning and momentum analysis with provenance, contradictions, and verification for business leaders and AI agents.

## Facts

- Endpoint: GET https://pay.edge-agents.ai/v1/services/cocoa-positioning-momentum
- Price: $0.01/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-cocoa-positioning-momentum-intelligence-5e2ba751
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bCG_79loQH3YRsqkFLb22

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-cocoa-positioning-momentum-intelligence-5e2ba751
```

Example prompt: Pull the latest cocoa positioning momentum report from Edge Agents — I need the evidence-backed summary with confidence rating and source provenance so I can brief our strategy team on current cocoa market direction.

## When to prefer this

Choose this endpoint when you need traceable, evidence-backed cocoa commodity positioning and momentum intelligence with explicit provenance, contradiction flagging, and confidence scoring — especially for executive briefings, board-level strategy, or autonomous agent pipelines where auditability and point-in-time sourcing matter. Prefer over generic market data APIs when you need a bounded, defensible narrative rather than raw price feeds.

## Known failure modes

- Payment not received or insufficient USDC — HTTP 402 returned before report is issued
- Live data temporarily unavailable — report may note coverage gaps or source freshness limitations
- Report generated but evidence incomplete — limitations field will enumerate gaps explicitly
- Network timeout — retry with same parameters as endpoint is idempotent

## How this service works

Direct CFTC weekly changes in managed-money long, short and spread positions for Cocoa, including the resulting change in net positioning. Purpose: Detect whether reported managed-money positioning in Cocoa shifted toward net-long, net-short or stable exposure in the latest CFTC week. 168-hour freshness target; missing evidence is reported explicitly rather than invented.

## Output

A structured JSON report including: quality status and confidence level, a family and intent classification ('agriculture', 'momentum', 'positioning'), a human-readable summary of cocoa positioning momentum findings, the assets covered (COCOA), data policy (point-in-time), signed provenance from edge-agents.ai, schema version, generation timestamp, and a disclaimer that the report 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": [
    "momentum",
    "evidence",
    "positioning",
    "commodities"
   ],
   "summary": "Fresh Cocoa Positioning Momentum findings appear here."
  },
  "evidence": {
   "assets": [
    "COCOA"
   ],
   "policy": "point-in-time",
   "sources": "Reported from the actual live report; never inferred from this example."
  },
  "serviceId": "cocoa-positioning-momentum",
  "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-cocoa-positioning-momentum-intelligence-5e2ba751/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)
