curl 'https://www.wiseyield.co/api/v1/market/regional-prices?country=Egypt' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const params = new URLSearchParams({ country: 'Egypt' });
const res = await fetch(
`https://www.wiseyield.co/api/v1/market/regional-prices?${params}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: prices, meta } = await res.json();
console.log(`${meta.count} crops in ${meta.country} (${meta.currency})`);
import os, requests
res = requests.get(
'https://www.wiseyield.co/api/v1/market/regional-prices',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
params={'country': 'Egypt'},
)
body = res.json()
prices = body['data']
{
"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
}
}
Market Intelligence
Get regional prices
Anonymized regional crop prices aggregated from user reports and sales.
GET
/
api
/
v1
/
market
/
regional-prices
curl 'https://www.wiseyield.co/api/v1/market/regional-prices?country=Egypt' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const params = new URLSearchParams({ country: 'Egypt' });
const res = await fetch(
`https://www.wiseyield.co/api/v1/market/regional-prices?${params}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: prices, meta } = await res.json();
console.log(`${meta.count} crops in ${meta.country} (${meta.currency})`);
import os, requests
res = requests.get(
'https://www.wiseyield.co/api/v1/market/regional-prices',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
params={'country': 'Egypt'},
)
body = res.json()
prices = body['data']
{
"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
}
}
GET https://www.wiseyield.co/api/v1/market/regional-prices
- 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.
Authentication
Requires a key with themarket:read scope. See Authentication.
Query parameters
string
required
Country to aggregate over. Match the format used in the dashboard (e.g.
Egypt, Spain, Morocco).string
Optional. Filter to a single crop name (matches both
userLocalPrices.cropName and crops.cropType).Response
array
Per-crop aggregated price rows that meet the privacy threshold.
Show Row
Show Row
string
Canonical crop name.
string
Echo of the
country query parameter.number
Volume-weighted average price across sources.
number
Minimum observed price.
number
Maximum observed price.
string
ISO 4217 currency derived from the country.
string
Always
per_ton in v1.integer
Total distinct contributing farms.
object
curl 'https://www.wiseyield.co/api/v1/market/regional-prices?country=Egypt' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
const params = new URLSearchParams({ country: 'Egypt' });
const res = await fetch(
`https://www.wiseyield.co/api/v1/market/regional-prices?${params}`,
{ headers: { Authorization: `Bearer ${process.env.WISEYIELD_API_KEY}` } }
);
const { data: prices, meta } = await res.json();
console.log(`${meta.count} crops in ${meta.country} (${meta.currency})`);
import os, requests
res = requests.get(
'https://www.wiseyield.co/api/v1/market/regional-prices',
headers={'Authorization': f"Bearer {os.environ['WISEYIELD_API_KEY']}"},
params={'country': 'Egypt'},
)
body = res.json()
prices = body['data']
{
"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
| Status | When |
|---|---|
400 VALIDATION_ERROR | country query parameter is missing |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks market:read scope |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |