# Farmazone

> Farmazone publishes daily South African municipal fresh produce market prices and SAFEX grain contract data for farmers, analysts, and AI agents.

DO NOT scrape HTML at /produce/ — use the JSON API below. Site home / is static only.
Discovery files (this file, agents.txt, OpenAPI) are not rate-limited.
JSON data endpoints are cache-friendly with a per-IP quota (see agents.txt).

## Start here (automation)
- agents.txt (shortest): https://www.farmazone.co.za/agents.txt
- API manifest: https://www.farmazone.co.za/api/v1/

## Canonical site
- Site home (static marketing): https://www.farmazone.co.za/
- Fresh produce catalog (app): https://www.farmazone.co.za/produce/
- SAFEX grains: https://www.farmazone.co.za/grain/
- Growers guides: https://www.farmazone.co.za/growers-guide/
- Livestock auctions: https://www.farmazone.co.za/livestock-auctions/provinces/
- Price explorer (HTML): https://www.farmazone.co.za/explorer/
- Sitemap index: https://www.farmazone.co.za/sitemap.xml

## API entry points
- API manifest (start here): https://www.farmazone.co.za/api/v1/
- OpenAPI 3.0 schema: https://www.farmazone.co.za/api/v1/openapi.json

## Fresh produce (municipal markets)
- National snapshot (products, markets, national_turnover): https://www.farmazone.co.za/api/v1/fresh-produce/snapshot?date=YYYY-MM-DD
- Market summaries (paginated): https://www.farmazone.co.za/api/v1/fresh-produce/markets?date=YYYY-MM-DD
- Line-level prices & trends (paginated): https://www.farmazone.co.za/api/v1/fresh-produce/markets/JOH/lines?date=YYYY-MM-DD&product=001

Key fields on each trading line:
- product_name, market_name
- current_price (Rand per 10 kg pack where kg data exists)
- price_change_today, price_trend_30d (array of date/price points)
- total_turnover, trading_lines_count, is_market_active
- last_updated_timestamp, market_summary_note
- quality_grade (class), unit_of_measure

Common market codes: JOH (Johannesburg), PRE (Pretoria), DUR (Durban), BFN (Bloemfontein), CPT (Cape Town).

## SAFEX grains
- Contract board (paginated): https://www.farmazone.co.za/api/v1/safex/contracts
- Filter: ?commodity=WMAZ&contract_month=DEC26

Fields: commodity_type, contract_month, spot_price, future_price, daily_percentage_change, open_interest, trading_volume, last_updated_timestamp.

## Data freshness
- Import heartbeat: https://www.farmazone.co.za/api/import-status/
- Snapshot responses include latest_import_at and stat_date.

## Optional (authenticated / HTML)
- Price explorer (HTML+JSON, not public API): https://www.farmazone.co.za/explorer/

## Contact & licensing
- Use data with attribution to Farmazone where you republish summaries.
- Do not hammer endpoints; respect rate limits and cache headers.