# SiteCheck Trade & Energy – World Reference Prices for Coffee, Sugar & Cocoa

> SiteCheck Trade & Energy – World Reference Prices for Coffee, Sugar & Cocoa is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns World Bank monthly reference prices (USD) for coffee, sugar, and cocoa via FRED, including the latest value and up to 24 months of history.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/energy/ice-coffee-sugar-cocoa?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-world-reference-prices-for-coffee-sugar-cocoa-10cecddd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NhK8X8r247-k6EpPd9Xq5

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 sitecheck-trade-energy-world-reference-prices-for-coffee-sugar-cocoa-10cecddd
```

Example prompt: What are the latest World Bank reference prices for coffee, sugar, and cocoa? Give me the most recent values plus the last 6 months of history.

## When to prefer this

Choose this endpoint when you need official World Bank monthly benchmark prices for coffee, sugar, or cocoa sourced from FRED — not real-time ICE futures tick data. Ideal for macroeconomic analysis, procurement cost modeling, or trend monitoring where official reference prices (Other Mild Arabica for coffee, ISA daily for sugar, World Bank series for cocoa) are required over exchange-traded settlement prices.

## Known failure modes

- FRED/World Bank data unavailable or delayed — endpoint may return stale or empty history
- Invalid months parameter (outside 1–24 range) may cause unexpected response or default behavior
- Cloudflare Worker timeout if upstream FRED CSV endpoint is slow
- Payment of 0.002 USDC not completed — request blocked by x402 paywall

## How this service works

Monthly world reference prices for coffee, sugar and cocoa from FRED (World Bank series, USD). These are not ICE futures settlements; the name is kept for the route. Latest value plus up to 24 months of history.

## Output

A JSON object with three top-level keys — coffee, sugar, cocoa — each containing a unit string, a latest object (date + value), and a history array of monthly {date, value} objects covering up to 24 months. Also includes the FRED source URL and a checkedAt timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "months": {
       "type": "string",
       "description": "Months of history, 1 to 24 (default 3)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cocoa": {
   "unit": "USD per metric ton",
   "latest": {
    "date": "2026-09-01",
    "value": 5918.981427980948
   },
   "history": [
    {
     "date": "2026-09-01",
     "value": 5918.981427980948
    },
    {
     "date": "2026-08-01",
     "value": 5990.497009722438
    }
   ]
  },
  "sugar": {
   "unit": "USD per kg, ISA daily price",
   "latest": {
    "date": "2026-09-01",
    "value": 17.93714285714286
   },
   "history": [
    {
     "date": "2026-09-01",
     "value": 17.93714285714286
    },
    {
     "date": "2026-08-01",
     "value": 16.82619047619048
    }
   ]
  },
  "coffee": {
   "unit": "USD per kg, Other Mild Arabica",
   "latest": {
    "date": "2026-09-01",
    "value": 330.1219047619048
   },
   "history": [
    {
     "date": "2026-09-01",
     "value": 330.1219047619048
    },
    {
     "date": "2026-08-01",
     "value": 360.6319047619048
    }
   ]
  },
  "source": "https://fred.stlouisfed.org/graph/fredgraph.csv",
  "checkedAt": "2026-10-23T09:38:08.269Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-world-reference-prices-for-coffee-sugar-cocoa-10cecddd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)