{"uid":"cap_eBuv1WM5_N12B9HKcGOEQ","slug":"solar-autonomy-forecast-75724424","name":"Solar Autonomy Forecast","description":"Daily energy balance and straight run-down from the figures supplied. Solar input is caller data in watt-hours per day; nothing is fetched and no weather is assumed. Time to empty means time to the reserve floor, not to zero. Idle draw and conversion efficiency apply to AC loads only. Ageing, temperature and Peukert behaviour are not modelled, which matters for lead acid far more than for LiFePO4.","url":"https://solar.halowerk.com/autonomy-forecast","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"loads":{"type":"array","items":{"type":"object","required":["name","watts"],"properties":{"dc":{"type":"boolean","default":false,"description":"True for loads fed straight from the battery."},"name":{"type":"string"},"watts":{"type":"number","maximum":50000,"minimum":0},"hours_per_day":{"type":"number","default":24,"maximum":24,"minimum":0}},"additionalProperties":false},"maxItems":60,"minItems":1},"battery":{"type":"object","required":["soc_percent"],"properties":{"capacity_ah":{"type":"number","maximum":100000,"minimum":1},"capacity_wh":{"type":"number","maximum":10000000,"minimum":10},"soc_percent":{"type":"number","maximum":100,"minimum":0},"nominal_voltage_v":{"type":"number","default":12,"maximum":1000,"minimum":6},"reserve_soc_percent":{"type":"number","default":20,"maximum":90,"minimum":0,"description":"Floor not to be crossed."}},"additionalProperties":false},"inverter":{"type":"object","properties":{"idle_w":{"type":"number","default":15,"maximum":500,"minimum":0},"efficiency":{"type":"number","default":0.9,"maximum":1,"minimum":0.5},"hours_powered_per_day":{"type":"number","default":24,"maximum":24,"minimum":0}},"additionalProperties":false},"daily_solar_input_wh":{"type":"number","default":0,"maximum":1000000,"minimum":0,"description":"Expected harvest per day."}}},"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_BQ6u04DAbND4-nGX7nKSw","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":"Calculates how many days a battery system can run autonomously given daily solar harvest, load profile, and battery state — no weather data fetched, pure energy balance computation.","exampleAgentPrompt":"How many days of autonomy do I have? My battery is 200Ah at 12V nominal, currently at 80% SOC with a 20% reserve floor. I'm getting 1200Wh of solar per day. My loads are a fridge at 45W running 24 hours (DC), and lights at 30W for 6 hours (AC). My inverter runs 8 hours a day, idles at 15W, and is 90% efficient.","exampleUseCases":[{"title":"Camper van off-grid trip planning","prompt":"I'm heading off-grid for a week in my van. My 100Ah lithium battery is at 12V and fully charged, reserve at 20%. I expect about 800Wh of solar per day. My loads are a 12V compressor fridge at 40W running 24h DC, a laptop at 60W for 4h AC, and LED lights at 20W for 5h AC. Inverter idles at 20W, runs 9 hours a day at 88% efficiency. How many days will I last before hitting my reserve?"},{"title":"Remote cabin power sufficiency check","prompt":"My off-grid cabin has a 400Ah 24V battery bank at 60% SOC with a 25% reserve floor. I generate roughly 2500Wh of solar daily. Loads are a refrigerator at 80W DC all day, a water pump at 200W for 1 hour AC, and lighting at 50W for 4 hours AC. Inverter idles at 30W, 9 hours powered, 92% efficiency. Can you compute my autonomy forecast?"},{"title":"Emergency backup power duration estimate","prompt":"The grid is down and I'm running on my solar backup — 150Ah 12V battery at 45% SOC, reserve floor 15%, and I'm getting zero solar today. My loads are a router at 10W DC for 24h and a fan at 60W AC for 8h. Inverter idles at 15W, runs 8h, 90% efficiency. How long until I hit my reserve floor?"}],"resultDescription":"Returns a daily energy balance breakdown showing net Wh generated vs consumed, the number of days of autonomy remaining before the battery reaches the reserve SOC floor, and the effective daily surplus or deficit — all based purely on the caller-supplied figures with no external data fetched.","failureModes":["Missing required soc_percent field returns a validation error","Providing neither capacity_ah nor capacity_wh makes battery size indeterminate","Loads array empty or missing causes rejection (minItems: 1)","Specifying hours_per_day > 24 or watts < 0 fails schema validation","Very high daily_solar_input_wh exceeding total load results in infinite autonomy (may return unbounded or max value)","Inverter efficiency below 0.5 rejected by schema"],"whenToPreferThis":"Choose this endpoint when you need a fast, deterministic energy balance calculation from known figures — no weather API, no location, no assumptions. Ideal for off-grid solar sizing checks, trip planning, and autonomy estimation when the user already has their solar harvest figure. Prefer over weather-integrated solar forecasts when the user controls the input data and wants a pure arithmetic result. Does not model battery ageing, temperature, or Peukert effects, so best suited for LiFePO4 chemistries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:38.601Z","isFirstParty":false}