1 · Sector interoperability
A dedicated standard works inside one domain
Like ISOBUS between tractors and implements: a shared language and protocol that works well within the agricultural sector.
Developers
Agorà’s API runs on Milky Data Way, our interoperable digital-twin platform. Send a unit, get a three-day irrigation forecast with the water balance behind it. Send feedback, and the AI tunes the model to that unit.
Quickstart
Send the coordinates and the crop. Agorà picks the best weather service, soil data and crop model for that position.
Get today’s, tomorrow’s and the day after’s irrigation need, with the full water balance.
Post the irrigation actually applied and what users observe. This is what Agorà’s AI learns from, so the model keeps adapting to each unit.
curl -X POST https://api.vaimee.com/agora/v1/units \ -H "Authorization: Bearer $AGORA_KEY" \ -H "Content-Type: application/json" \ -d '{ "lat": 52.52, "lon": 5.47, "crop": "potato" }' # → { "id": "unit_7Kq2", "soil": "sandy loam", "model": "CRITERIA1D" }
import os, requests r = requests.post( "https://api.vaimee.com/agora/v1/units", headers={"Authorization": f"Bearer {os.environ['AGORA_KEY']}"}, json={"lat": 52.52, "lon": 5.47, "crop": "potato"}, ) print(r.json()["id"]) # unit_7Kq2
const res = await fetch("https://api.vaimee.com/agora/v1/units", { method: "POST", headers: { Authorization: `Bearer ${process.env.AGORA_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ lat: 52.52, lon: 5.47, crop: "potato" }), }); const { id } = await res.json(); // "unit_7Kq2"
API surface
Set up, forecast, water balance, feedback. Everything else is data you already have.
| Method | Path | Purpose |
|---|---|---|
| POST | /agora/v1/units | Register a unit: coordinates and crop |
| GET | /agora/v1/units/{id}/advice | Three-day irrigation forecast |
| GET | /agora/v1/units/{id}/balance | Daily water balance terms |
| POST | /agora/v1/units/{id}/feedback | Report applied irrigation and observations — feeds the AI |
| POST | /agora/v1/units/{id}/observations | Push sensor, CRNS or satellite readings |
| GET | /agora/v1/weather/{id} | Weather data (Advanced plan and above) |
Illustrative endpoint names — CONFIRM AGAINST THE REAL API
Milky Data Way (MDW)® is our interoperable platform for building digital twins. Agorà is the first; the same core powers new applications for agriculture and beyond.
It is built on open standards and open source: RDF, OWL and SPARQL.
Data collection & integration
Weather, soil, sensors, satellite and farm software brought into one live graph.
Interoperability & standards
Semantic models instead of one-off connectors, so new sources plug in without rewrites.
Security & governance
Control over who shares what, ready for European Data Spaces.
Scalability & reliability
From one plot to a region, from one twin to many.
Context-driven AI
AI and models work on data that carries its meaning with it — for predictions, recommendations, optimisation and automation.
Interoperability, AI and models
1 · Sector interoperability
Like ISOBUS between tractors and implements: a shared language and protocol that works well within the agricultural sector.
2 · Across domains and ecosystems
Weather, irrigation, sensors, farm management, logistics and markets use different standards. A knowledge graph models their meaning, relationships and context — and connects them to AI, models and European Data Spaces.
Numbers to plan with
3 days
Forecast horizon, re-run daily
40+
Crop models available
60–20K
Calls per minute, by plan
SLA
Availability target on Pro and Enterprise
Start on the free API plan with two units, and see whether the numbers match what your agronomists already believe.