{"uid":"cap_kCG8GPgORjLZDKhz7ZLfR","slug":"halowerk-agri-soil-moisture-bucket-balance-model-c121cd0d","name":"Halowerk Agri Soil Moisture Bucket Balance Model","description":"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.","url":"https://agri.halowerk.com/v1/soil-moisture","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cBfgimpmwHDvCEYcucNYp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Irrigation scheduling for a crop season","prompt":"I have 120 days of daily rainfall, irrigation, and ET estimates for my maize field. Can you run a root-zone bucket balance with a field capacity of 200 mm, starting water of 60 mm, and a runoff fraction of 0.15 to show me daily soil moisture storage and when drainage occurs?"},{"title":"Assessing drought stress periods","prompt":"Using my 60-day daily rainfall and ET records with no irrigation applied, field capacity of 100 mm, initial water of 90 mm, and a runoff fraction of 0.1, compute the daily soil water balance so I can see which days the root zone hits zero available water."},{"title":"Evaluating heavy rain drainage events","prompt":"I want to know how much water drains past the root zone during a rainy month — I have 30 days of daily rainfall up to 80 mm, ET around 3 mm/day, no irrigation, field capacity of 120 mm, starting water of 100 mm, and a runoff fraction of 0.25. Can you run the bucket model?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:54.623Z","isFirstParty":false}