Skip to main content

Commodity Prices

Query current commodity market prices and compare across regions.

Consult Price​

GET https://api.yodi.tg/v1/climate/prices?commodity={name}&region={region}

Query Parameters​

ParameterTypeDescription
commoditystringCommodity name (e.g., maize, rice, millet)
regionstringRegion code (e.g., maritime, savanes)

Example Request​

curl -X GET "https://api.yodi.tg/v1/climate/prices?commodity=maize&region=maritime" \
  -H "x-api-key: YOUR_API_KEY"

Example Response​

{
  "message": "PRICE_CHECKED",
  "error": false,
  "data": {
    "commodity": "maize",
    "region": "maritime",
    "price": 250,
    "unit": "FCFA/kg",
    "lastUpdated": "2025-07-16T08:00:00Z"
  },
  "status": 200
}

Compare Prices​

GET https://api.yodi.tg/v1/climate/prices/compare?commodity={name}&regions={r1},{r2}

Query Parameters​

ParameterTypeDescription
commoditystringCommodity name
regionsstringComma-separated region codes

Example Request​

curl -X GET "https://api.yodi.tg/v1/climate/prices/compare?commodity=rice&regions=maritime,savanes,kara" \
  -H "x-api-key: YOUR_API_KEY"

Example Response​

{
  "message": "PRICES_COMPARED",
  "error": false,
  "data": {
    "commodity": "rice",
    "regions": [
      { "region": "maritime", "price": 350, "unit": "FCFA/kg" },
      { "region": "savanes", "price": 380, "unit": "FCFA/kg" },
      { "region": "kara", "price": 365, "unit": "FCFA/kg" }
    ]
  },
  "status": 200
}

Next Steps​