# Halowerk Agri Soil Moisture Bucket Balance Model

> Halowerk Agri Soil Moisture Bucket Balance Model is a paid API for AI agents from agri.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Runs a deterministic daily root-zone water bucket balance, computing soil moisture storage, drainage, and water availability from rainfall, irrigation, evapotranspiration, runoff, and field capacity inputs.

## Facts

- Endpoint: POST https://agri.halowerk.com/v1/soil-moisture
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-agri-soil-moisture-bucket-balance-model-c121cd0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kCG8GPgORjLZDKhz7ZLfR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-agri-soil-moisture-bucket-balance-model-c121cd0d -d '<json body>'
```

Example prompt: Run a daily soil moisture bucket balance for a 90-day season: rainfall is [5, 0, 12, ...] mm/day, irrigation is [0, 10, 0, ...] mm/day, ET is [4, 4, 5, ...] mm/day, runoff fraction is 0.2, initial water is 80 mm, and field capacity is 150 mm — tell me the daily storage and any drainage events.

## When to prefer this

Choose this endpoint when you need a fast, deterministic, physics-inspired daily root-zone water balance without sensor data, real-time weather feeds, or hydraulic simulation. Ideal for agronomic planning, irrigation scheduling analysis, and drought stress assessment using existing rainfall, ET, and irrigation time series. Not a substitute for sensor readings, weather forecasts, or full hydraulic models.

## Known failure modes

- Array length mismatch between rainfall_mm, irrigation_mm, and evapotranspiration_mm causes validation error
- field_capacity_mm of zero or below minimum causes rejection
- rainfall or ET values exceeding per-item maximums (5000 mm rain, 500 mm ET) rejected
- runoff_fraction outside [0,1] range rejected
- Providing more than 3660 days in any array causes error
- Missing required arrays returns 4xx validation error

## How this service works

Runs a deterministic bucket balance for each supplied day. Rain is reduced by a caller-selected runoff fraction, evapotranspiration is subtracted, water above field capacity is reported as drainage, and storage is bounded at zero. This is a root-zone accounting model, not a sensor reading, weather forecast, hydraulic simulation or irrigation command.

## Output

Returns a per-day time series of plant-available water storage in the root zone (mm), water drained beyond field capacity (mm), and bounds storage at zero, reflecting the deterministic bucket balance after applying runoff reduction, irrigation addition, and ET subtraction.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rainfall_mm": {
   "type": "array",
   "items": {
    "type": "number",
    "maximum": 5000,
    "minimum": 0
   },
   "maxItems": 3660,
   "minItems": 1
  },
  "irrigation_mm": {
   "type": "array",
   "items": {
    "type": "number",
    "maximum": 5000,
    "minimum": 0
   },
   "maxItems": 3660,
   "minItems": 1
  },
  "runoff_fraction": {
   "type": "number",
   "maximum": 1,
   "minimum": 0,
   "description": "Fraction of rainfall excluded as runoff."
  },
  "initial_water_mm": {
   "type": "number",
   "maximum": 10000,
   "minimum": 0,
   "description": "Initial plant-available water in the modeled root zone."
  },
  "field_capacity_mm": {
   "type": "number",
   "maximum": 10000,
   "minimum": 0.001,
   "description": "Maximum water stored by the modeled bucket."
  },
  "evapotranspiration_mm": {
   "type": "array",
   "items": {
    "type": "number",
    "maximum": 500,
    "minimum": 0
   },
   "maxItems": 3660,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-agri-soil-moisture-bucket-balance-model-c121cd0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agri.halowerk.com](https://www.zero.xyz/host/agri.halowerk.com/llms.txt)