Skip to main content
GET
/
api
/
v1
/
market
/
regional-prices
curl 'https://www.wiseyield.co/api/v1/market/regional-prices?country=Egypt' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": [
    {
      "cropName": "Wheat",
      "region": "Egypt",
      "avgPrice": 287.43,
      "minPrice": 210.00,
      "maxPrice": 340.00,
      "currency": "EGP",
      "unit": "per_ton",
      "sampleSize": 18,
      "sources": { "userReported": 12, "sales": 6 }
    }
  ],
  "meta": {
    "country": "Egypt",
    "currency": "EGP",
    "minSampleSize": 5,
    "count": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt

Use this file to discover all available pages before exploring further.

GET https://www.wiseyield.co/api/v1/market/regional-prices
Returns aggregated, anonymized regional crop pricing combining two sources:
  • User-reported local prices — what farms in the region say they’re paying or selling for.
  • Recorded crop sales — actual sale transactions on the platform.
Per-crop rows are returned only when the combined sample size is at least 5 distinct farms, to preserve contributor privacy. Crops below the threshold are silently filtered out.

Authentication

Requires a key with the market:read scope. See Authentication.

Query parameters

country
string
required
Country to aggregate over. Match the format used in the dashboard (e.g. Egypt, Spain, Morocco).
cropName
string
Optional. Filter to a single crop name (matches both userLocalPrices.cropName and crops.cropType).

Response

data
array
Per-crop aggregated price rows that meet the privacy threshold.
meta
object
curl 'https://www.wiseyield.co/api/v1/market/regional-prices?country=Egypt' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"
{
  "data": [
    {
      "cropName": "Wheat",
      "region": "Egypt",
      "avgPrice": 287.43,
      "minPrice": 210.00,
      "maxPrice": 340.00,
      "currency": "EGP",
      "unit": "per_ton",
      "sampleSize": 18,
      "sources": { "userReported": 12, "sales": 6 }
    }
  ],
  "meta": {
    "country": "Egypt",
    "currency": "EGP",
    "minSampleSize": 5,
    "count": 1
  }
}

Errors

StatusWhen
400 VALIDATION_ERRORcountry query parameter is missing
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks market:read scope
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error

Privacy

Rows are returned only when at least 5 distinct farms contribute to a crop. This applies after merging user-reported and sales data — a crop with 3 user reports plus 2 sales rows clears the threshold, but a crop with only 4 of either does not. No individual farm identifier is ever exposed.