# NuaSense > East African farm and market data for software and agents. Live weather stations and soil probes with the agronomy computed from them (spray windows, disease risk, irrigation need, a forecast corrected to the station), and the market layer (county prices, satellite demand, news signals, food security) for Kenya, Tanzania, Uganda and Rwanda. One key, one base URL, 40 datasets, 342 fields. Base URL `https://api.nuasense.com/api/nuasense/v1`. Every dataset is one `GET`, answers JSON and takes the same time arguments. The same data is reachable as an MCP server at `https://mcp.nuasense.com/mcp`. This page is also served at `https://api.nuasense.com/` to any client that sends `Accept: text/markdown`; the index is `https://api.nuasense.com/llms.txt`, the full field list `https://api.nuasense.com/llms-full.txt`, and the OpenAPI 3.1 description `https://api.nuasense.com/openapi.json` (for Copilot Studio, GPT Actions, Postman and frameworks that turn a spec into tools). ## For coding agents Paste this prompt into Claude Code, Codex, Cursor or another coding agent in your project: ```text Add NuaSense field and market data to this project. Docs: https://api.nuasense.com/index.md 1. If `npx skills add nuasense/skills` works here, run it and read the installed skill; otherwise read the docs page above. The full field list is at https://api.nuasense.com/llms-full.txt. 2. A key needs an account at https://platform.nuasense.com with a confirmed email and a verified phone. If I have no key yet, tell me the four steps (sign up, confirm the email, verify the phone under API Keys, create a key) and wait until I paste the key. Read it from an environment variable; never write it into the repository. 3. Call GET https://api.nuasense.com/api/nuasense/v1/catalog with the key. It lists the datasets this key reaches. Build only against what it lists. 4. Send the header `X-NuaSense-Client: skill/0.1.0; agent=` on every call, with your own name as the agent. 5. Pick the dataset for the task, make one call with a small `limit`, show me the rows, then build the integration. On 429 wait for `Retry-After`; on 402 tell me what needs credit and stop. ``` What the agent can do alone: read these docs, call the catalog, choose a dataset, make the first call, build the integration. What it needs you for, once: the console hands out a key only to an account with a confirmed email and a verified phone (a code by SMS or WhatsApp). The key is shown once. ### Skill and plugin - Skill for any agent that reads `SKILL.md` files: `npx skills add nuasense/skills` (https://github.com/nuasense/skills). - Claude Code plugin with the skill and the MCP server: `/plugin marketplace add nuasense/skills`, then `/plugin install nuasense@nuasense`. - MCP server for Claude.ai, Claude Desktop, Claude Code and other MCP clients: `https://mcp.nuasense.com/mcp`. It signs in with your console account; no key to paste. ### Say that you are an agent Send `X-NuaSense-Client: skill/0.1.0; agent=` on every call (for a library, `sdk/`). It changes nothing in price or limits. It lets us see which integrations were built by an agent, which is how we decide what to write for agents next. Values outside `[a-z0-9._-]` are dropped, not stored. ## Access 1. Account at https://platform.nuasense.com (email, confirm). The catalogue, the docs and the market layer are open from that moment. 2. Key under **API Keys** (https://platform.nuasense.com/manage/keys). The console asks for a verified phone first. A console key carries `market:read`, `farm:read` and `location:read`. Tick **Alerts and webhooks** when creating it to add `alerts:write` (market watches, webhooks). `ingest:write` is granted on request to info@nuasense.com. 3. Send the key as a bearer token on every call. Never in the URL. ```bash curl https://api.nuasense.com/api/nuasense/v1/catalog \ -H "Authorization: Bearer nua_live_…" \ -H "X-NuaSense-Client: skill/0.1.0; agent=curl" ``` ### What is free and what draws on credit **You spend units, not calls.** A row of market or location data is one unit; your own farm data is one unit per call whatever it returns; a ready-made analysis is one unit and priced separately. | | rows per call | units per day | units per month | history | |---|---|---|---|---| | no credit | 100 | 200 | 1,000 | last 30 days of market and location data | | with credit or a station | 1,000 | 1,500 (raised per account) | no ceiling, billed against the balance | full | | your own farm data | 5,000 | 1 unit per call | | full | Credit is prepaid, by M-Pesa or card under **Billing & Pricing** (https://platform.nuasense.com/manage/billing); the rate card is on that page. Writing into the platform (sending readings as JSON, webhooks, exports) needs a funded account. Registering a station and its push token is free for the first three stations on an account. Every response carries `X-Daily-Limit`, `X-Daily-Remaining`, `X-Monthly-Remaining` where a monthly ceiling applies, `X-Credit-Balance` and the `X-RateLimit-*` family, so a client can back off before it is refused. 60 requests a minute per key. ## Reading data Identical on every dataset: | Parameter | Meaning | |---|---| | `start`, `end` | RFC3339, or a duration relative to now (`-7d`, `-24h`). Default `start=-24h`; slow datasets carry their own default. Without credit, market and location data cannot start more than 30 days back (`402`). | | `every` + `agg` | Downsample: `every=1h&agg=mean`. `agg` is one of mean, min, max, sum, last, first, count. | | `fields` | Comma-separated subset. It can only narrow what is published; naming a field you cannot reach answers `400`, so "not granted" is distinguishable from "no data". | | `limit` | Default 500. Ceiling per call: 100 rows without credit, 1,000 with, 5,000 for your own farm data. Counts rows in total. The call reserves `limit` against the budget before it runs and hands back what it did not use; a `limit` above what is left is refused whole (`429`), never part-served. | | `order` | `asc` for oldest-first. Newest-first is the default. | | any filter | Only the filters a dataset declares are accepted; they are listed per dataset below. `gateway_id` picks one of your own stations; omitted, the primary one. | Response shape: ```json { "dataset": "farm.weather.raw", "fields": [ "temperature", "humidity" ], "filters": { "gateway_id": [ "" ] }, "range": { "start": "-24h", "end": "now()" }, "count": 144, "limit": 500, "rows": [ { "time": "2026-07-28T10:00:00Z", "gateway_id": "", "temperature": 21.4, "humidity": 62 } ], "metering": { "tier": "paid", "unit": "call", "units_charged": 1, "max_rows_per_call": 5000, "history_days": null } } ``` `metering` says what the call cost: `unit` is `row` on market and location data and `call` on your own farm data. ### Errors | Status | Meaning | What to do | |---|---|---| | `400` | A field you cannot reach, a bad time or aggregation value, or a continent-wide dataset called without a filter. | Fix the request; the body names the problem. | | `401` | Missing, malformed, revoked or expired key. | Ask the human for a key. | | `402` | Market or location history beyond the free 30 days, prepaid credit spent, or a write on an account that never topped up. | Tell the human what needs credit. Do not retry. | | `403` | The key lacks the scope, the station is not approved for API exposure, or `gateway_id` names a station the key does not own. | Different key or different request; retrying changes nothing. | | `404` | The dataset exists but is not published to this key. The body names it. | An answer, not a routing accident. | | `429` | Per-minute budget, the daily unit budget or the monthly one. The body says which and how many units are left. | Wait for `Retry-After`; ask with a smaller `limit`. | | `451` | Dataset withheld on licence grounds. | Nothing; no key unlocks it. | ## Datasets Declared datasets are what the API can serve. What a given key actually reaches depends on its scopes and on per-field approval — call GET /catalog with your key for that answer. ### Farm (18 datasets, 192 fields) Your own stations and soil nodes: raw uplinks, hourly and daily roll-ups, derived agronomy, disease risk, forecast and field indices. Scope `farm:read`. Paths are relative to `https://api.nuasense.com/api/nuasense/v1`. | Path | Dataset | Updated | Filters | Note | Fields | |---|---|---|---|---|---| | `/farm/weather` | Weather station readings | ~10 min | `gateway_id` | | 20 | | `/farm/soil` | Soil node readings | ~10 min | `gateway_id`, `dev_eui`, `node_id`, `application` | | 14 | | `/farm/weather/hourly` | Weather — hourly roll-up | hourly | `gateway_id` | | 7 | | `/farm/soil/hourly` | Soil — hourly roll-up | hourly | `gateway_id`, `dev_eui` | | 4 | | `/farm/weather/daily` | Weather — daily roll-up | daily | `gateway_id` | | 6 | | `/farm/soil/daily` | Soil — daily roll-up | daily | `gateway_id`, `dev_eui`, `node_id`, `application` | | 5 | | `/farm/disease-risk` | Disease + pest risk (v2) | hourly | `gateway_id`, `kind`, `threat` | | 9 | | `/farm/spirulina` | Spirulina pond readings | ~10 min | `gateway_id`, `node_id` | | 4 | | `/farm/derived` | Derived weather variables | hourly | `gateway_id` | | 29 | | `/farm/forecast` | Weather forecast | 6 h | `gateway_id`, `source` | | 11 | | `/farm/water-balance` | Root-zone water balance | daily | `gateway_id` | | 6 | | `/farm/field-indices` | Satellite vegetation + SAR indices | weekly | `gateway_id`, `field_id`, `aoi_name`, `source` | | 9 | | `/farm/climate` | Long-horizon climate archive | daily top-up; reanalysis ends ~7 days before today | `gateway_id`, `source` | | 7 | | `/farm/soil-baseline` | Soil baseline | once per location | time only | | 8 | | `/farm/fields` | Field polygons | on edit | time only | | 8 | | `/farm/sensor-settings` | Sensor settings | on edit | time only | | 17 | | `/farm/alerts` | Alert history | 10 min engine cycle | time only | | 15 | | `/farm/advisories` | Advisory history | daily | time only | | 13 | ### Market (22 datasets, 150 fields) Prices, demand, trade, regulation, news signals and food security across Kenya, Tanzania, Uganda and Rwanda, with several layers covering all of Sub-Saharan Africa. Scope `market:read`. Paths are relative to `https://api.nuasense.com/api/nuasense/v1`. | Path | Dataset | Updated | Filters | Note | Fields | |---|---|---|---|---|---| | `/market/input-prices` | Crop-protection + input retail prices | daily | `source`, `country`, `category`, `product`, `formulation`, `pack_unit`, `brand` | | 12 | | `/market/prices` | Commodity + fertilizer prices | daily / weekly / monthly by source | `source`, `commodity`, `variety`, `market`, `county`, `country`, `currency`, `factory`, `unit`, `price_type` | | 20 | | `/market/news` | Agriculture news signals | daily 10:00 UTC | `source`, `commodity`, `variety`, `county`, `country`, `signal_type`, `direction`, `trust`, `horizon` | | 15 | | `/market/benchmarks` | Global commodity benchmarks | monthly | `source`, `scope`, `commodity`, `unit`, `kind` | | 1 | | `/market/trade` | Fertilizer trade flows | monthly | `source`, `country`, `hs4`, `flow`, `partner` | withheld, answers `451` | 2 | | `/market/demand-indices` | Satellite demand indices | 10-daily / weekly | `country`, `county`, `index`, `level`, `source` | | 1 | | `/market/cropland-extent` | County cropland extent | annual | `country`, `county`, `class`, `level`, `source` | | 7 | | `/market/crop-mix` | County crop mix | monthly | `country`, `county`, `crop`, `level`, `source` | | 5 | | `/market/field-structure` | County field structure | static | `country`, `county`, `stat`, `level`, `source` | withheld, answers `451` | 2 | | `/market/realtime-prices` | Real-time market prices | monthly | `source`, `country`, `adm1`, `market`, `commodity`, `currency` | | 3 | | `/market/food-security` | Food-security phase classification | per analysis round | `source`, `country`, `adm1`, `area`, `level`, `phase`, `validity` | needs `country` or `admin area` | 16 | | `/market/fews-outlook` | Food-security outlook (FEWS NET) | monthly (outlooks Feb, Jun, Oct; key message updates between) | `source`, `country`, `scenario`, `assistance`, `fnid`, `unit_type`, `adm1`, `area`, `scale` | needs `country` or `admin area` | 3 | | `/market/fews-population` | People in need of food assistance (FEWS NET) | monthly | `source`, `country`, `scenario`, `phase`, `fnid`, `adm1`, `area`, `document` | | 15 | | `/market/fews-prices` | Market prices hosted by FEWS NET | monthly | `source`, `publisher`, `country`, `adm1`, `market`, `commodity`, `cpc`, `price_type`, `product_source`, `unit`, `currency` | needs `country` or `market` or `commodity` | 3 | | `/market/fews-trade` | Cross-border trade flows (FEWS NET) | monthly (East Africa: to 09/2024) | `source`, `publisher`, `reporter`, `origin`, `destination`, `border_point`, `commodity`, `cpc`, `flow`, `trade_type`, `unit` | needs `country` or `border point` or `commodity` | 2 | | `/market/rainfall-anomaly` | Rainfall anomaly | per season/dekad | `source`, `country`, `adm1`, `adm2`, `adm_level`, `adm_pcode`, `season` | needs `country` or `admin area` | 3 | | `/market/rainfall-subnational` | Rainfall against normal, by admin unit | dekadal | `source`, `country`, `unit`, `pcode`, `adm_level`, `shared_with` | needs `country` | 11 | | `/market/agri-stress` | Agricultural stress | dekadal | `source`, `country`, `region`, `asap0_id` | | 6 | | `/market/production` | Sub-national crop production | per season, annual revisions | `source`, `country`, `admin1`, `admin2`, `fnid`, `product`, `crop_system`, `season` | needs `country` or `crop` | 3 | | `/market/fao-inputs` | FAO fertilizer + input statistics | annual | `source`, `country`, `dataset`, `element`, `item`, `unit` | needs `country` or `item` | 1 | | `/market/fao-crops` | FAO crop statistics | annual | `source`, `country`, `dataset`, `element`, `item`, `unit` | needs `country` or `item` | 1 | | `/market/regulatory` | Regulatory + legal signals | weekly, Saturday | `source`, `jurisdiction`, `country`, `commodity`, `regulation_type`, `instrument_type` | | 18 | Filter vocabulary worth knowing: fertilizer is `commodity=fertilizer` plus `variety=dap|urea|npk|can|mop|tsp|sulphate_of_ammonia|ammonia_anhydrous`; the continent-wide layers use ISO3 country codes (`ken`, `tza`, `uga`, `rwa`); annual statistics are stamped 1 January of the year they describe, so query them with a multi-year window. `/farm/soil-baseline` deliberately has no pH, organic carbon or N/P/K: modelled values cannot support a fertilizer decision, and current fertility comes only from a soil test. ## Ready-made analyses Questions with a measured answer, one call each, under `https://api.nuasense.com/api/partner/v1/market`. Same key, same header. Each is one unit and priced as an analysis. | Question | Path | Parameters | Example | |---|---|---|---| | What can this API do, and what are the valid names? | `/meta` | none | | | Which counties, regions and districts can I ask about? | `/units` | `country` | `?country=tz` | | What does DAP cost right now, and where? | `/fertilizer/price` | `variety`, `county`, `field`, `window_days` | `?variety=dap&county=nakuru` | | Which counties are dearest and which cheapest? | `/fertilizer/rank` | `variety`, `field`, `order`, `window_days` | `?variety=dap&order=desc` | | What does it cost in each individual market inside a county? | `/fertilizer/markets` | `variety`, `county`, `field`, `source`, `window_days` | `?variety=dap&county=kakamega` | | Is the price rising or falling, and by how much? | `/fertilizer/trend` | `variety`, `county`, `field`, `window_days` | `?variety=dap` | | Which month of the year is cheapest to buy? | `/fertilizer/seasonality` | `variety`, `county`, `field` | `?variety=dap` | | Would that seasonal rule actually have made money? | `/fertilizer/backtest` | `variety`, `county`, `field` | `?variety=dap` | | Where is the retail-minus-wholesale markup fattest? | `/fertilizer/margin` | `variety`, `window_days` | `?variety=dap` | | Do the official prices and the online asking prices agree? | `/fertilizer/source-compare` | `variety`, `county`, `window_days` | `?variety=dap` | | How does the local price compare to the world market? | `/fertilizer/global-benchmark` | `variety` | `?variety=dap` | | Can farmers here actually afford fertilizer this season? | `/fertilizer/affordability` | `variety`, `window_days` | `?variety=dap` | | Which counties are building demand right now? | `/fertilizer/demand-board` | `country`, `limit` | `?country=ke` | | Is demand rising in this one county, and how strongly? | `/fertilizer/demand-signal` | `county`, `country` | `?county=nakuru` | | Give me everything about one county in a single call. | `/fertilizer/county-brief` | `county`, `country`, `variety` | `?county=nakuru&country=ke&variety=dap` | | What is the farmer in this county actually earning? | `/fertilizer/crop-economy` | `county` | `?county=nakuru` | | How big is the fertilizer market in this country? | `/fertilizer/market-size` | `country` | `?country=ke` | | Who ships fertilizer into the country, and how much? | `/trade/imports` | `country`, `months` | `?country=ke` | | When in the year does inventory get built up? | `/trade/seasonality` | `country` | `?country=ke` | | Is importing worth it, and where does the margin sit? | `/trade/landed-cost` | `variety` | `?variety=dap` | | Does fertilizer pass through Kenya to its neighbours? | `/trade/transit` | none | | | Where can I buy cheap and sell dear — and does it cover the lorry? | `/analytics/spread` | `commodity`, `window_days`, `transport_cost_kes_per_kg`, `limit` | `?commodity=maize_dry&transport_cost_kes_per_kg=8` | | When Nairobi moves, how long until my market follows? | `/analytics/price-lag` | `commodity`, `reference`, `window_days`, `max_lag_days` | `?commodity=maize_dry&reference=nairobi` | | Which counties are getting expensive fastest? | `/analytics/inflation` | `commodity`, `window_days` | `?commodity=maize_dry` | | How reliable is this county's harvest, and which years failed? | `/analytics/yield-risk` | `county`, `product`, `season` | `?county=uasin_gishu&product=maize` | | Has the season started here — early or late, and is the rain that starts one coming? | `/analytics/season` | `county`, `country`, `index` | `?county=nakuru` | | What is registered against this pest on my crop, and how long before harvest? | `/crop-protection` | `crop`, `pest`, `country` | `?crop=tomato&pest=tuta absoluta` | | How much fertilizer for my crop, and what does it cost me today? | `/fertilizer/recommendation` | `county`, `crop`, `altitude_m`, `level` | `?county=nakuru&crop=maize&altitude_m=1850` | | Can I use this on my crop and still export to the EU? | `/export-residue` | `crop`, `active`, `limit` | `?crop=french_bean&active=lambda-cyhalothrin` | | Which varieties are released for my altitude, and how long do they take? | `/varieties` | `crop`, `altitude_m`, `max_maturity_months`, `seed_company`, `limit` | `?crop=maize&altitude_m=1800&max_maturity_months=5` | | What does coffee grade AA earn over the market? | `/analytics/coffee-grades` | `sales` | `?sales=20` | | Which tea factory beats its neighbours? | `/analytics/tea-league` | `grade`, `sales`, `min_sales` | `?grade=all` | | How is one county, region or district doing right now? | `/county-summary` | `county`, `country` | `?county=nakuru&country=ke` | | What is happening in the market right now? | `/news` | `commodity`, `county`, `country`, `signal_type`, `trust`, `days` | `?commodity=fertilizer&days=14` | | The same news signals as an RSS feed, for a reader or an inbox | `/news/feed.xml` | `api_key`, `keywords`, `commodity`, `county`, `trust`, `days` | | | Your standing watches — list them, or add a price watch | `/alerts` | none | | | Watch a county for a turn in demand | `/alerts/demand` | none | | | Watch for a high-trust news signal | `/alerts/news` | none | | | A recurring news digest by email | `/alerts/news-digest` | none | | | Remove a watch | `/alerts/:id` | none | | ## MCP server `https://mcp.nuasense.com/mcp` (Streamable HTTP). Sign-in is the console account; the tools carry read-only and destructive hints, and the server's own instructions tell the model when data is thin. Claude.ai and Claude Desktop: Settings → Connectors → add the URL. Claude Code: `claude mcp add --transport http nuasense https://mcp.nuasense.com/mcp`. Listed in the MCP Registry as `com.nuasense/agri-data`. ## Bring your own station Any station can feed the farm layer; the first three on an account connect free. In the console under **External stations** (https://platform.nuasense.com/stations) add a station and choose how it sends: - **Console with a custom-server screen** (Ecowitt, Froggit, Ambient, Wunderground mode): four values, server `ingest.nuasense.com`, path `/station/`, port 80, interval 60 s. - **A sensor you build** (ESP32, Arduino, Raspberry Pi; choose *I built it myself*): `POST https://api.nuasense.com/station/` with JSON such as `{"device_id": "garden-pi", "temperature": 21.4, "soil_moisture": 34}`, no key. Weather, soil, water, greenhouse, beehive, storage and more; names and units: https://github.com/nuasense/station-schema. In Python: `pip install nuasense`, then `nuasense.send("", "garden-pi", temperature=21.4, soil_moisture=34)`. - **LoRaWAN**: a webhook from The Things Stack or ChirpStack to `POST https://api.nuasense.com/lorawan/`. - **Your own code, with past timestamps**: `POST https://api.nuasense.com/api/nuasense/v1/ingest/readings` with `{station_id, readings:[{time, temperature, humidity, pressure, light, wind_speed, wind_gusts, wind_direction, rain_mm}]}` (funded account, `ingest:write`). - **Home Assistant, Node-RED, ioBroker, weewx, n8n, Python**: packages under https://github.com/nuasense; Python on PyPI as `nuasense`. What comes back: `GET https://api.nuasense.com/api/nuasense/v1/ingest/first-look?station_id=` (tonight's low, the next calm dry daylight window, a plausibility check of the latest reading, the garden's watering need) `GET https://api.nuasense.com/api/nuasense/v1/ingest/derived?station_id=` (ET0, VPD, delta T, leaf wetness, spray quality, degree days) and `GET https://api.nuasense.com/api/nuasense/v1/ingest/disease-risk?station_id=&crop=&planted_on=` (disease and pest risk per threat for a named crop from the station's own hours; threats it cannot judge, such as soil-borne ones without a soil probe, come back not_judged with no level). Reading your own station is free. ## Your data, and what you may do with ours - When you connect a station, NuaSense stores its readings and computes your forecast, spray windows and risks from them. - The readings are used aggregated and anonymised to improve forecasts and models for everyone; they are never passed on individually without your opt-in, and positions on public maps are blurred. - You can disconnect the station at any time and have all its data deleted. The price of a read buys use, not ownership. You may use everything you pull inside your own product, analysis and reporting, for as long as you like. You may not resell it, republish it or pass it on to a third party as data; if that is what you need, write to info@nuasense.com. Some sources beneath the platform carry their own terms, and those travel with the rows: `GET https://api.nuasense.com/api/nuasense/v1/attributions` lists the credits, readable without a key. ## Help info@nuasense.com, a person reads it. Console: https://platform.nuasense.com. Status of your own key and budget: `GET https://api.nuasense.com/api/nuasense/v1/usage`. ## Fields by dataset ### Weather station readings `GET https://api.nuasense.com/api/nuasense/v1/farm/weather` · scope `farm:read` · updated ~10 min Raw ~10-minute uplinks from the gateway weather station. Firmware-calibrated; the MQTT bridge is pass-through. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`. | Field | Unit | Note | |---|---|---| | `temperature` | °C | air temperature | | `humidity` | % | | | `pressure` | hPa | | | `light` | lux | | | `light_max` | lux | | | `rainfall` | mm | | | `wind_speed` | m/s | | | `wind_gusts` | m/s | | | `wind_direction` | ° | | | `gps_lat` | ° | only when gps_fix=true | | `gps_lon` | ° | only when gps_fix=true | | `gps_alt` | m | only when gps_fix=true | | `battery_voltage` | V | | | `battery_percent` | % | | | `lora_rx_count` | | link telemetry | | `fw_version` | | link telemetry | | `rain_clicks` | count | fw19 raw — ×0.2691 = rainfall mm | | `wind_clicks` | count | fw19 raw | | `wind_hz_avg` | Hz | fw19 raw — ×0.667 = wind_speed m/s | | `wind_hz_peak` | Hz | fw19 raw — peak, feeds wind_gusts | ### Soil node readings `GET https://api.nuasense.com/api/nuasense/v1/farm/soil` · scope `farm:read` · updated ~10 min Raw ~10-minute uplinks from soil probes. Nodes uplink independently of the gateway; gateway_id is a logical farm key only. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `dev_eui`, `node_id`, `application`. | Field | Unit | Note | |---|---|---| | `soil_moisture_1` | % | depth channel 1 | | `soil_moisture_2` | % | depth channel 2 | | `temperature_1` | °C | depth channel 1 | | `temperature_2` | °C | depth channel 2 | | `cw_humidity` | % | Comwintop probe — volumetric water content; same value as soil_moisture_1 on cw nodes | | `cw_temperature` | °C | Comwintop probe — soil temperature; fills temperature_1 when no DS18B20 probe is fitted | | `cw_ec` | µS/cm | Comwintop probe — bulk soil electrical conductivity, depth channel 1 | | `cw_ec_2` | µS/cm | Comwintop probe — bulk soil electrical conductivity, depth channel 2 (four-depth nodes) | | `cw_ec_3` | µS/cm | Comwintop probe — bulk soil electrical conductivity, depth channel 3 (four-depth nodes) | | `cw_ec_4` | µS/cm | Comwintop probe — bulk soil electrical conductivity, depth channel 4 (four-depth nodes) | | `battery_mv` | mV | | | `battery_pct` | % | | | `rssi` | dBm | | | `snr` | dB | | ### Weather — hourly roll-up `GET https://api.nuasense.com/api/nuasense/v1/farm/weather/hourly` · scope `farm:read` · updated hourly Pre-aggregated hourly means, rolled up server-side. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`. | Field | Unit | Note | |---|---|---| | `temperature` | °C | | | `humidity` | % | | | `pressure` | hPa | | | `rainfall` | mm | | | `wind_speed` | m/s | | | `wind_gusts` | m/s | | | `light` | lux | | ### Soil — hourly roll-up `GET https://api.nuasense.com/api/nuasense/v1/farm/soil/hourly` · scope `farm:read` · updated hourly Pre-aggregated hourly means, rolled up server-side. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `dev_eui`. | Field | Unit | Note | |---|---|---| | `soil_moisture_1` | % | | | `soil_moisture_2` | % | | | `temperature_1` | °C | | | `temperature_2` | °C | | ### Weather — daily roll-up `GET https://api.nuasense.com/api/nuasense/v1/farm/weather/daily` · scope `farm:read` · updated daily Pre-aggregated daily means, rolled up server-side. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`. | Field | Unit | Note | |---|---|---| | `temperature` | °C | | | `humidity` | % | | | `pressure` | hPa | | | `light` | lux | | | `battery_voltage` | V | | | `battery_percent` | % | | ### Soil — daily roll-up `GET https://api.nuasense.com/api/nuasense/v1/farm/soil/daily` · scope `farm:read` · updated daily Pre-aggregated daily means, rolled up server-side. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `dev_eui`, `node_id`, `application`. | Field | Unit | Note | |---|---|---| | `moisture_raw` | % | | | `temperature` | °C | | | `battery` | mV | | | `rssi` | dBm | | | `snr` | dB | | ### Disease + pest risk (v2) `GET https://api.nuasense.com/api/nuasense/v1/farm/disease-risk` · scope `farm:read` · updated hourly Risk Models v2 output per gateway and threat: risk percent, level, accumulated DSV, conducive hours and the data completeness behind the score. A gateway can carry several crops; research-pilot threats are keyed _ (tomato_tuta, kale_dbm, …) and carry an evidence grade in metadata_json. alertable=false marks a watch-only score. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `kind`, `threat`. | Field | Unit | Note | |---|---|---| | `risk_percent` | % | | | `risk_level` | | low/moderate/high | | `threat_score` | | | | `dsv_accumulated` | | disease severity values | | `conducive_hours` | h | | | `data_completeness_pct` | % | how much input data backed this score | | `prioritized` | 0/1 | | | `alertable` | 0/1 | false = watch only: computed and shown, never sent as an alert (pilot crop not switched on, evidence grade C / B-watch, greenhouse plot, insect clock without a field record) | | `metadata_json` | | model detail (crop, evidence grade, source, gates) | ### Spirulina pond readings `GET https://api.nuasense.com/api/nuasense/v1/farm/spirulina` · scope `farm:read` · updated ~10 min Pond telemetry for the spirulina vertical (Nasaru Naturals). Only visible to a key whose farm_access carries the pond gateway. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `node_id`. | Field | Unit | Note | |---|---|---| | `water_temp` | °C | | | `par` | µmol/m²/s | photosynthetically active radiation | | `turbidity` | NTU | | | `turbidity_v` | V | raw sensor voltage | ### Derived weather variables `GET https://api.nuasense.com/api/nuasense/v1/farm/derived` · scope `farm:read` · updated hourly Hourly physics-derived variables computed from the station's own readings (Risk Models v2). Every field carries a calibration tier — measured, physics, validated, literature or proxy. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`. | Field | Unit | Note | |---|---|---| | `temperature` | °C | | | `humidity` | % | | | `pressure` | hPa | | | `rainfall` | mm | | | `solar_radiation` | W/m² | | | `wind_speed` | m/s | | | `dew_point` | °C | | | `dew_point_depression` | °C | | | `vpd` | kPa | | | `pressure_trend_6h` | hPa/6h | | | `et0_hour` | mm/h | FAO-56 hourly | | `delta_t` | °C | dry- minus wet-bulb | | `spray_quality_index` | 0-100 | | | `spray_quality_label` | | ideal…unsuitable | | `spray_limiting_factor` | | wind/delta_t/inversion/rain | | `inversion_risk` | | low/moderate/high | | `lwd_hour` | 0/1 | | | `lwd_reason` | | | | `lwd_consecutive_hours` | h | | | `dd_potato_hour` | °C·h | degree-day contribution for potato | | `dd_aphid_hour` | °C·h | degree-day contribution for aphid | | `dd_whitefly_hour` | °C·h | degree-day contribution for whitefly | | `dd_ptm_hour` | °C·h | degree-day contribution for ptm | | `dd_faw_hour` | °C·h | degree-day contribution for faw | | `dd_armyworm_hour` | °C·h | degree-day contribution for armyworm | | `dd_dbm_hour` | °C·h | degree-day contribution for dbm | | `dd_tuta_hour` | °C·h | degree-day contribution for tuta | | `dd_thrips_hour` | °C·h | degree-day contribution for thrips | | `dd_cbb_hour` | °C·h | degree-day contribution for cbb | ### Weather forecast `GET https://api.nuasense.com/api/nuasense/v1/farm/forecast` · scope `farm:read` · updated 6 h Seven-day hourly forecast for the station's location, refreshed every six hours; the newest run wins and issued_at records when it was fetched. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `source`. | Field | Unit | Note | |---|---|---| | `temperature` | °C | | | `humidity` | % | | | `dew_point` | °C | | | `precipitation_mm` | mm | | | `precipitation_probability` | % | | | `cloud_cover` | % | | | `wind_speed` | m/s | | | `wind_gusts` | m/s | | | `wind_direction` | ° | | | `shortwave_radiation` | W/m² | historical only — not provided by the current source | | `et0_mm` | mm | historical only — not provided by the current source | ### Root-zone water balance `GET https://api.nuasense.com/api/nuasense/v1/farm/water-balance` · scope `farm:read` · updated daily One point per station per daily cycle, combining the soil's available water capacity, derived evapotranspiration and forecast rain. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`. | Field | Unit | Note | |---|---|---| | `depletion_mm` | mm | root-zone depletion | | `taw_mm` | mm | total available water | | `raw_mm` | mm | readily available water | | `et0_mm` | mm | | | `rain_mm` | mm | | | `deficit_ratio` | 0-1 | | ### Satellite vegetation + SAR indices `GET https://api.nuasense.com/api/nuasense/v1/farm/field-indices` · scope `farm:read` · updated weekly Optical and radar vegetation indices, averaged inside the field polygon. Weekly, using a 15-day temporal median to survive cloud. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `field_id`, `aoi_name`, `source`. | Field | Unit | Note | |---|---|---| | `ndvi` | | optical | | `evi` | | optical | | `savi` | | optical | | `ndwi` | | optical | | `ndre` | | optical | | `gndvi` | | optical | | `sar_vv_db` | dB | radar backscatter | | `sar_vh_db` | dB | radar backscatter | | `sar_rvi` | | radar vegetation index | ### Long-horizon climate archive `GET https://api.nuasense.com/api/nuasense/v1/farm/climate` · scope `farm:read` · updated daily top-up; reanalysis ends ~7 days before today Daily climate reanalysis from 1990 and daily rainfall from 1981, backfilled for each station's location. Narrowed to your own gateways and to devices approved for API exposure. Filters: `gateway_id`, `source`. | Field | Unit | Note | |---|---|---| | `temp_max` | °C | | | `temp_min` | °C | | | `temp_mean` | °C | | | `precip` | mm | | | `wind_max` | m/s | | | `radiation` | MJ/m²/day | | | `et0` | mm/day | | ### Soil baseline `GET https://api.nuasense.com/api/nuasense/v1/farm/soil-baseline` · scope `farm:read` · updated once per location Soil profile for a station's location, read once when it first reports its position: texture and the USDA class derived from it, depth to bedrock, stone content, bulk density, elevation and slope. Modelled at 30 m from continental soil mapping. Deliberately excludes pH, organic carbon and N/P/K — those move with liming, tillage and fertiliser, so a modelled value cannot support the decision it would be used for. Current fertility comes only from a soil test. Narrowed to your own gateways and to devices approved for API exposure. | Field | Unit | Note | |---|---|---| | `gateway_id` | | | | `lat` | ° | | | `lon` | ° | | | `alt` | m | | | `properties` | | physical soil layers per depth: texture, bedrock, stones, density, terrain | | `water_properties` | | water-retention profile per depth, Vol-% | | `fetched_at` | | | | `water_fetched_at` | | | ### Field polygons `GET https://api.nuasense.com/api/nuasense/v1/farm/fields` · scope `farm:read` · updated on edit User-drawn field boundaries (GeoJSON) consumed by the satellite pipeline. Narrowed to your own gateways and to devices approved for API exposure. | Field | Unit | Note | |---|---|---| | `id` | | | | `gateway_id` | | | | `field_name` | | | | `crop_label` | | | | `geometry` | | GeoJSON jsonb | | `area_ha` | ha | | | `created_at` | | | | `updated_at` | | | ### Sensor settings `GET https://api.nuasense.com/api/nuasense/v1/farm/sensor-settings` · scope `farm:read` · updated on edit Per-sensor display name, crop assignment and GDD accumulator. Narrowed to your own gateways and to devices approved for API exposure. | Field | Unit | Note | |---|---|---| | `gateway_id` | | | | `dev_eui` | | | | `node_id` | | | | `name` | | | | `crop_label` | | | | `crop_type_id` | | | | `planting_date` | | | | `emergence_date` | | | | `tuber_initiation_date` | | | | `row_closure_date` | | | | `haulm_kill_date` | | | | `last_spray_date` | | | | `gdd_base7_to_date` | °C·d | | | `gdd_last_accumulated_at` | | | | `location_lat` | ° | | | `location_lon` | ° | | | `updated_at` | | | ### Alert history `GET https://api.nuasense.com/api/nuasense/v1/farm/alerts` · scope `farm:read` · updated 10 min engine cycle Append-only audit of every threshold evaluation that produced a notification: value, direction, channel, delivery status. Narrowed to your own gateways and to devices approved for API exposure. | Field | Unit | Note | |---|---|---| | `id` | | | | `gateway_id` | | | | `dev_eui` | | | | `metric` | | | | `value` | | | | `direction` | | | | `triggered_at` | | | | `aez_zone_id` | | | | `crop_type_id` | | | | `threshold_rule_id` | | | | `notification_type` | | | | `channel` | | | | `status` | | | | `message_text` | | | | `created_at` | | | ### Advisory history `GET https://api.nuasense.com/api/nuasense/v1/farm/advisories` · scope `farm:read` · updated daily Irrigation / spray-window / frost / NDVI-anomaly advisories, including dry-run rows with suppressed_reason set. Narrowed to your own gateways and to devices approved for API exposure. | Field | Unit | Note | |---|---|---| | `id` | | | | `gateway_id` | | | | `advisory_type` | | | | `severity` | | | | `valid_from` | | | | `valid_until` | | | | `message_text` | | | | `payload` | | model detail jsonb | | `notification_sent` | | | | `notification_sent_at` | | | | `channel` | | | | `suppressed_reason` | | set when the advisory was generated but not sent | | `created_at` | | | ### Crop-protection + input retail prices `GET https://api.nuasense.com/api/nuasense/v1/market/input-prices` · scope `market:read` · updated daily Retail shelf prices and stock availability for crop-protection products, seeds and foliar feeds, read daily from East African agro-dealer catalogues — Kenya and Uganda today. Priced per pack and, where the pack is a bulk substance, per litre or kilo. Every price is in the currency of the row's country (KES, UGX), which the `country` tag names. Availability is the point as much as price: a product that vanishes from every dealer in a week is a supply signal the price series never shows. Global reference data — the same rows for every caller. Filters: `source`, `country`, `category`, `product`, `formulation`, `pack_unit`, `brand`. | Field | Unit | Note | |---|---|---| | `price` | local currency | robust median across a dealer's offers for this product, in the currency of the row's country — read this one | | `price_kes` | KES | the older name for the same median, written ONLY where the row really is in KES. Kenyan rows have it; Ugandan rows do not. Kept because consumers already read it | | `price_min` | local currency | | | `price_max` | local currency | | | `price_per_unit` | per kg or per l, in the row's currency | only where the pack is a bulk substance — never for seed, where it is arithmetically valid and meaningless | | `pack_size` | kg or l | | | `concentration_pct` | | active-ingredient loading read off the formulation code | | `n_offers` | | listings behind the median | | `discount_pct` | % | comparable WITHIN a dealer only — some discount permanently | | `in_stock_rate` | | share of this product's listings currently purchasable, 0-1 | | `on_backorder_rate` | | 0-1 | | `units_left` | | rare — well under 1% of listings publish a unit count | ### Commodity + fertilizer prices `GET https://api.nuasense.com/api/nuasense/v1/market/prices` · scope `market:read` · updated daily / weekly / monthly by source Official recorded prices, online marketplace asking prices, a monthly humanitarian series, and coffee and tea auction results — merged into one vocabulary and told apart by the source tag. Kenya, Tanzania, Uganda and Rwanda. PRICES ARE IN THE CURRENCY OF THE ROW'S COUNTRY, never converted: filter on `country` (Kenyan rows predate the tag and carry none) and read `currency`. Global reference data — the same rows for every caller. Filters: `source`, `commodity`, `variety`, `market`, `county`, `country`, `currency`, `factory`, `unit`, `price_type`. | Field | Unit | Note | |---|---|---| | `wholesale` | currency of the row's country, per unit | recorded market prices | | `retail` | currency of the row's country, per unit | recorded market prices | | `wholesale_min` | currency of the row's country, per unit | Tanzania's official bulletins quote a min-max band per market rather than one number; `wholesale` is the midpoint and these two are the band as published | | `wholesale_max` | currency of the row's country, per unit | | | `supply_volume` | | official series only | | `min_price_usd` | USD/kg | coffee auction | | `avg_price_usd` | USD/kg | coffee and tea auctions | | `max_price_usd` | USD/kg | coffee auction | | `min_price_kes` | KES/kg | coffee auction | | `avg_price_kes` | KES/kg | coffee and tea auctions | | `max_price_kes` | KES/kg | coffee auction | | `value_usd` | USD | | | `value_kes` | KES | | | `usd_kes_rate` | | FX as of the sale date — makes KES auditable | | `bags_offered` | | coffee auction | | `weight_offered_kg` | kg | coffee auction | | `kg_sold` | kg | tea | | `kg_offered` | kg | tea auction | | `pct_unsold` | % | tea auction | | `sale_no` | | | ### Agriculture news signals `GET https://api.nuasense.com/api/nuasense/v1/market/news` · scope `market:read` · updated daily 10:00 UTC Typed, source-traceable signals extracted daily from East African agriculture news, keyed to the same county + commodity vocabulary as the price data. Every signal carries a source URL and a verbatim quote. Global reference data — the same rows for every caller. Filters: `source`, `commodity`, `variety`, `county`, `country`, `signal_type`, `direction`, `trust`, `horizon`. | Field | Unit | Note | |---|---|---| | `confidence` | 0-1 | | | `cluster_size` | | articles merged into this signal | | `value_kes` | KES | | | `db_reference_value` | | | | `reason` | | | | `supporting_quote` | | verbatim | | `source_url` | | | | `source_domain` | | | | `source_name` | | | | `article_title` | | | | `db_alignment` | | | | `model` | | | | `extractor_version` | | | | `unit` | | | | `magnitude` | | | ### Global commodity benchmarks `GET https://api.nuasense.com/api/nuasense/v1/market/benchmarks` · scope `market:read` · updated monthly Monthly world commodity benchmark prices in nominal US dollars, back to 1960. Global by nature, deliberately kept out of the county-level series. Global reference data — the same rows for every caller. Filters: `source`, `scope`, `commodity`, `unit`, `kind`. | Field | Unit | Note | |---|---|---| | `price` | USD/mt or index | | ### Fertilizer trade flows `GET https://api.nuasense.com/api/nuasense/v1/market/trade` · scope `market:read` · updated monthly Monthly fertilizer imports into Kenya, Tanzania, Uganda and Rwanda from international customs statistics. flow=mirror is what exporters declare shipping in (current); flow=reported is the market's own customs record (deeper history). Global reference data — the same rows for every caller. Filters: `source`, `country`, `hs4`, `flow`, `partner`. | Field | Unit | Note | |---|---|---| | `value_usd` | USD | | | `qty_kg` | kg | | ### Satellite demand indices `GET https://api.nuasense.com/api/nuasense/v1/market/demand-indices` · scope `market:read` · updated 10-daily / weekly Cropland vegetation indices per administrative unit against that unit's own seasonal normal — the input to the fertilizer demand signal. Kenya plus TZ/UG/RW. Global reference data — the same rows for every caller. Filters: `country`, `county`, `index`, `level`, `source`. | Field | Unit | Note | |---|---|---| | `value` | | index value; see the index tag for which | ### County cropland extent `GET https://api.nuasense.com/api/nuasense/v1/market/cropland-extent` · scope `market:read` · updated annual How much of each county is cropped, in percent and in square kilometres, plus the full land-cover breakdown behind it. `class` selects the reading: `cropland_anchored` is the one to use — the satellite distribution scaled so the national total matches the official arable area — while `cropland_low` and `cropland_high` are the two source layers unadjusted and bracket it. The remaining classes (tree, shrub, grass, built, bare, water, wetland) are the land-cover census. A county figure is an estimate with a published method, not a land survey: the scaling assumes the satellite layer's bias is even across counties, and it is strongest in the humid west. Quote the bracket where the decision is close. Global reference data — the same rows for every caller. Filters: `country`, `county`, `class`, `level`, `source`. | Field | Unit | Note | |---|---|---| | `value` | fraction | share of the county in this class, 0-1 | | `area_km2` | km2 | area in this class; present on the census and anchored rows | | `n_px_100m` | | 100 m pixels counted, on the land-cover census rows | | `share_raw` | fraction | the reading before any adjustment, where one was made | | `se` | fraction | standard error, on rows that carry one | | `n_points` | | sample points behind the row, where it is sample-based | | `reliable` | | false when the row's own error makes it not worth quoting | ### County crop mix `GET https://api.nuasense.com/api/nuasense/v1/market/crop-mix` · scope `market:read` · updated monthly Which annual crops are grown where, as each crop's share of a county's cropped land, with a standard error and a `reliable` flag per crop. Shares are corrected for the classifier's own confusion matrix rather than counted raw. PRELIMINARY: the current run carries wide error bars on a first sample and is published so it can be checked against what buyers see on the ground; it is rebuilt monthly and the errors narrow as the sample and the labels grow. Read `reliable` before quoting a crop, and prefer the ranking over the decimals. Perennials (tea, coffee, sugarcane, banana) are NOT in this layer — the cropland definition behind it excludes them, and they get their own product. Global reference data — the same rows for every caller. Filters: `country`, `county`, `crop`, `level`, `source`. | Field | Unit | Note | |---|---|---| | `value` | fraction | corrected share of the county's cropped land under this crop, 0-1 | | `share_raw` | fraction | uncorrected count of classified sample points | | `se` | fraction | standard error of the corrected share | | `n_points` | | sample points behind the estimate | | `reliable` | | false when the standard error exceeds half the share | ### County field structure `GET https://api.nuasense.com/api/nuasense/v1/market/field-structure` · scope `market:read` · updated static Farm structure per county: median field size, the quartiles around it, and the share of fields below half a hectare and above two. The question behind a pack size, a delivery round and a field-agent's daily reach. WITHHELD: built on field boundaries digitised over licensed imagery whose terms exclude commercial derivatives, so the route answers 451 until it is relicensed or rebuilt from open field data. Declared so the surface is visible. Global reference data — the same rows for every caller. Filters: `country`, `county`, `stat`, `level`, `source`. | Field | Unit | Note | |---|---|---| | `value` | | the statistic named by the stat tag; hectares, or a fraction for the share stats | | `n_points` | | digitised fields behind the statistic | ### Real-time market prices `GET https://api.nuasense.com/api/nuasense/v1/market/realtime-prices` · scope `market:read` · updated monthly A faster-moving East African price feed at market granularity — a second reading alongside the official series. `price_est` is the publisher's gap-filled monthly estimate, complete for every market up to the publication month; `price` is the raw survey observation, which arrives one to two months later and is sparse. `_fao` commodity slugs are the FAO-harmonised series kept apart from the local definition. Global reference data — the same rows for every caller. Filters: `source`, `country`, `adm1`, `market`, `commodity`, `currency`. | Field | Unit | Note | |---|---|---| | `price` | local currency | observed survey price; sparse, 1-2 months late | | `price_est` | local currency | Publisher's gap-filled monthly estimate; complete | | `trust` | | confidence score of the estimate, 0-1 | ### Food-security phase classification `GET https://api.nuasense.com/api/nuasense/v1/market/food-security` · scope `market:read` · updated per analysis round Standardised acute food-insecurity classification by administrative area — phases 1 to 5, as absolute numbers and percentages. Covers all of sub-Saharan Africa; `country` uses ISO3 codes (ken, tza, uga, rwa). Global reference data — the same rows for every caller. Filters: `source`, `country`, `adm1`, `area`, `level`, `phase`, `validity` (one of `country`, `admin area` is required). | Field | Unit | Note | |---|---|---| | `total_population` | people | | | `analysed_num` | people | | | `number` | people | | | `percentage` | % | | | `p1_num` | people | | | `p1_pct` | % | | | `p2_num` | people | | | `p2_pct` | % | | | `p3_num` | people | | | `p3_pct` | % | | | `p4_num` | people | | | `p4_pct` | % | | | `p5_num` | people | | | `p5_pct` | % | | | `p3plus_num` | people | phase 3 and above — the crisis headline | | `p3plus_pct` | % | | ### Food-security outlook (FEWS NET) `GET https://api.nuasense.com/api/nuasense/v1/market/fews-outlook` · scope `market:read` · updated monthly (outlooks Feb, Jun, Oct; key message updates between) FEWS NET's own IPC-compatible phase (1 minimal, 2 stressed, 3 crisis, 4 emergency, 5 famine) for each livelihood zone or admin area, with its projections: `scenario` cs = current situation, ml1 = the next four months, ml2 = the four after that. Each point is timed at the report month; `proj_start_ts`/`proj_end_ts` give the period the phase describes, so earlier projections stay readable next to what followed. `assistance` separates the classification with and without planned humanitarian aid. Kenya, Uganda, Burundi, Ethiopia, Somalia, South Sudan and Sudan; `country` is ISO alpha-2 (ke, ug); for Kenya `adm1` is the county. Global reference data — the same rows for every caller. Filters: `source`, `country`, `scenario`, `assistance`, `fnid`, `unit_type`, `adm1`, `area`, `scale` (one of `country`, `admin area` is required). | Field | Unit | Note | |---|---|---| | `phase` | IPC phase 1-5 | | | `proj_start_ts` | unix s | first day of the period the phase describes | | `proj_end_ts` | unix s | last day of that period | ### People in need of food assistance (FEWS NET) `GET https://api.nuasense.com/api/nuasense/v1/market/fews-population` · scope `market:read` · updated monthly FEWS NET's estimate of how many people are in IPC Phase 3 or worse, as the low-high range it publishes (`low`/`high`; `value` is the low end). `scenario` cs = this month, ml = projected, the month given by `proj_start_ts`, usually six months ahead; pn = the peak need over the period `proj_start_ts`-`proj_end_ts`. Each point is timed at the report month. National for most countries; `document` names the report family. `country` is ISO alpha-2. Global reference data — the same rows for every caller. Filters: `source`, `country`, `scenario`, `phase`, `fnid`, `adm1`, `area`, `document`. | Field | Unit | Note | |---|---|---| | `value` | people | the low end of the published range | | `low` | people | | | `high` | people | | | `p3_low` | people | | | `p3_high` | people | | | `p4_low` | people | | | `p4_high` | people | | | `p5_low` | people | | | `p5_high` | people | | | `pct_min` | % | share of the population, low end | | `pct_max` | % | share of the population, high end | | `proj_start_ts` | unix s | first day of the period the estimate describes | | `proj_end_ts` | unix s | last day of that period | | `peak_start_ts` | unix s | start of the peak-need months | | `peak_end_ts` | unix s | end of the peak-need months | ### Market prices hosted by FEWS NET `GET https://api.nuasense.com/api/nuasense/v1/market/fews-prices` · scope `market:read` · updated monthly Monthly market prices FEWS NET collects or republishes for East Africa — notably NDMA's pastoral-county markets (livestock, staples) in Kenya, Rwanda's ministry markets, Ethiopia, Somalia and South Sudan. `price` is in `currency` per `unit` as published; `price_cu` is the same price per common unit (kg, litre) and `usd_cu` that in US dollars at FEWS NET's rate for the month. `publisher` names who collected the price; `country` is ISO alpha-2 and for Kenya `adm1` is the county. Tanzania and Uganda carry no prices here. Global reference data — the same rows for every caller. Filters: `source`, `publisher`, `country`, `adm1`, `market`, `commodity`, `cpc`, `price_type`, `product_source`, `unit`, `currency` (one of `country`, `market`, `commodity` is required). | Field | Unit | Note | |---|---|---| | `price` | local currency per unit | | | `price_cu` | local currency per common unit | per kg or litre | | `usd_cu` | USD per common unit | at FEWS NET's exchange rate for the period | ### Cross-border trade flows (FEWS NET) `GET https://api.nuasense.com/api/nuasense/v1/market/fews-trade` · scope `market:read` · updated monthly (East Africa: to 09/2024) Monthly quantities of staple crops crossing East African borders, formal and informal, by border point, as monitored by FEWS NET and partners. The East African monitoring ends in September 2024; later rows are South African maize exports (SAGIS). `origin`/`destination`/`reporter` are ISO alpha-2; `quantity` is in `unit`, `quantity_kg` the same in kilograms. Global reference data — the same rows for every caller. Filters: `source`, `publisher`, `reporter`, `origin`, `destination`, `border_point`, `commodity`, `cpc`, `flow`, `trade_type`, `unit` (one of `country`, `border point`, `commodity` is required). | Field | Unit | Note | |---|---|---| | `quantity` | unit as tagged | | | `quantity_kg` | kg | | ### Rainfall anomaly `GET https://api.nuasense.com/api/nuasense/v1/market/rainfall-anomaly` · scope `market:read` · updated per season/dekad Seasonal rainfall anomaly versus the long-term normal, by admin unit — the weather side of a demand call. Covers all of sub-Saharan Africa. The upstream snapshot has not updated since July 2024: its latest seasons are Oct–Dec 2023 and Mar–May 2024, and each row's time is the date we re-read it, not the season's. Global reference data — the same rows for every caller. Filters: `source`, `country`, `adm1`, `adm2`, `adm_level`, `adm_pcode`, `season` (one of `country`, `admin area` is required). | Field | Unit | Note | |---|---|---| | `anomaly_mean` | mm | season-to-date accumulation vs the long-term average | | `anomaly_min` | mm | | | `anomaly_max` | mm | | ### Rainfall against normal, by admin unit `GET https://api.nuasense.com/api/nuasense/v1/market/rainfall-subnational` · scope `market:read` · updated dekadal Rain over the last 10 days, 1 month and 3 months against the long-term average for the same days, for every county, region and district in Kenya, Tanzania, Uganda and Rwanda — one point per dekad, timed at the dekad's first day. `rfq`/`r1q`/`r3q` are the publisher's percentage of normal, 100 × (rain + 5) / (average + 5). `final` is 0 until the publisher replaces the preliminary figure. `shared_with` names the other unit where the publisher's older boundary makes one reading cover two of ours. Global reference data — the same rows for every caller. Filters: `source`, `country`, `unit`, `pcode`, `adm_level`, `shared_with` (one of `country` is required). | Field | Unit | Note | |---|---|---| | `rfh` | mm | rain in the dekad | | `rfh_avg` | mm | long-term average for the dekad | | `rfq` | % | dekad rain as a percentage of normal | | `r1h` | mm | rain over the last month (three dekads) | | `r1h_avg` | mm | long-term average for that month | | `r1q` | % | month rain as a percentage of normal | | `r3h` | mm | rain over the last three months (nine dekads) | | `r3h_avg` | mm | long-term average for those three months | | `r3q` | % | three-month rain as a percentage of normal | | `n_pixels` | | satellite pixels averaged over the unit | | `final` | | 1 = final, 0 = preliminary | ### Agricultural stress `GET https://api.nuasense.com/api/nuasense/v1/market/agri-stress` · scope `market:read` · updated dekadal Early-warning hotspot flags per region: warning levels for cropland and rangeland where the season is going badly. Global reference data — the same rows for every caller. Filters: `source`, `country`, `region`, `asap0_id`. | Field | Unit | Note | |---|---|---| | `g1_w_any` | | warning level — any land cover | | `g1_w_crop` | | warning level — cropland | | `g1_w_range` | | warning level — rangeland | | `hs_code` | | hotspot code | | `hs_name` | | hotspot name | | `comment` | | | ### Sub-national crop production `GET https://api.nuasense.com/api/nuasense/v1/market/production` · scope `market:read` · updated per season, annual revisions Area, production and yield by admin unit, crop and season — the ground truth behind a demand estimate. Covers all of sub-Saharan Africa. Global reference data — the same rows for every caller. Filters: `source`, `country`, `admin1`, `admin2`, `fnid`, `product`, `crop_system`, `season` (one of `country`, `crop` is required). | Field | Unit | Note | |---|---|---| | `area` | ha | | | `production` | mt | | | `yield` | mt/ha | | ### FAO fertilizer + input statistics `GET https://api.nuasense.com/api/nuasense/v1/market/fao-inputs` · scope `market:read` · updated annual National fertilizer use, imports and related agricultural input series — the multi-year backdrop to the monthly trade flows. Global reference data — the same rows for every caller. Filters: `source`, `country`, `dataset`, `element`, `item`, `unit` (one of `country`, `item` is required). | Field | Unit | Note | |---|---|---| | `value` | | see the unit tag | ### FAO crop statistics `GET https://api.nuasense.com/api/nuasense/v1/market/fao-crops` · scope `market:read` · updated annual National crop area, production and yield series over the long run. Global reference data — the same rows for every caller. Filters: `source`, `country`, `dataset`, `element`, `item`, `unit` (one of `country`, `item` is required). | Field | Unit | Note | |---|---|---| | `value` | | see the unit tag | ### Regulatory + legal signals `GET https://api.nuasense.com/api/nuasense/v1/market/regulatory` · scope `market:read` · updated weekly, Saturday Typed, citable signals extracted weekly from the East African legal record — official notices, bills in progress, trade-standard notifications and import-rejection alerts — keyed to the same country + commodity vocabulary as the price and news layers. Every signal carries a document reference, a source URL and a verbatim quote. Global reference data — the same rows for every caller. Filters: `source`, `jurisdiction`, `country`, `commodity`, `regulation_type`, `instrument_type`. | Field | Unit | Note | |---|---|---| | `confidence` | 0-1 | | | `value` | | the number a measure names — a rate, levy or limit | | `effective_ts` | unix s | when the measure takes effect | | `comment_deadline_ts` | unix s | last day to respond to a consultation | | `status` | | stage of the instrument; a field so a stage change overwrites in place | | `title` | | | | `summary` | | | | `obligation` | | what someone must actually do | | `instrument` | | the document this comes from | | `supporting_quote` | | verbatim | | `source_url` | | | | `doc_ref` | | official document reference | | `source_stage` | | | | `effective_date` | | human-readable form of effective_ts | | `comment_deadline` | | human-readable form of comment_deadline_ts | | `value_unit` | | | | `model` | | | | `extractor_version` | | |