{"uid":"cap_NhK8X8r247-k6EpPd9Xq5","slug":"sitecheck-trade-energy-world-reference-prices-for-coffee-sugar-cocoa-10cecddd","name":"SiteCheck Trade & Energy – World Reference Prices for Coffee, Sugar & Cocoa","description":"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.","url":"https://api.tradeenergy-api.workers.dev/api/energy/ice-coffee-sugar-cocoa?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Cu5e65Ox2XKziJJ01pFev","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Soft commodity price dashboard","prompt":"Pull the latest World Bank reference prices for coffee, sugar, and cocoa along with 12 months of history so I can update my commodity price dashboard."},{"title":"Coffee price trend analysis","prompt":"Show me 24 months of monthly World Bank coffee price data in USD per kg — I want to see how prices have trended over the past two years."},{"title":"Cocoa cost monitoring for procurement","prompt":"What's the current World Bank reference price for cocoa in USD per metric ton, and how has it changed over the last 3 months?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:17.544Z","isFirstParty":false,"canonicalSlug":"sitecheck-trade-energy-world-reference-prices-for-coffee-sugar-cocoa-10cecddd"}