{"uid":"cap_-tEL8YvV6OO7qPAXz_WTD","slug":"prop-halowerk-yield-forecast-8e825adc","name":"Prop Halowerk Yield Forecast","description":"Compounds supplied rent and expense growth assumptions, applies vacancy and collection loss, subtracts operating expenses and capital reserve, and divides net operating income by a caller-supplied property value. This is scenario arithmetic, not a valuation, market forecast, investment recommendation, tax calculation or guarantee of income.","url":"https://prop.halowerk.com/v1/yield-forecast","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"property_value":{"type":"number","maximum":1000000000000000,"minimum":0.01,"description":"Value in a caller-selected currency."},"projection_years":{"type":"integer","maximum":50,"minimum":1},"vacancy_fraction":{"type":"number","maximum":1,"minimum":0},"annual_capital_reserve":{"type":"number","maximum":1000000000000000,"minimum":0},"collection_loss_fraction":{"type":"number","maximum":1,"minimum":0},"current_annual_gross_rent":{"type":"number","maximum":1000000000000000,"minimum":0},"annual_rent_growth_fraction":{"type":"number","maximum":10,"minimum":-0.99},"annual_expense_growth_fraction":{"type":"number","maximum":10,"minimum":-0.99},"current_annual_operating_expenses":{"type":"number","maximum":1000000000000000,"minimum":0}}},"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_hNIkQgjYd73KEiyprrcFB","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":"Projects net operating income and cap rate yield over multiple years by compounding rent and expense growth, applying vacancy and collection loss, and dividing by a caller-supplied property value.","exampleAgentPrompt":"Run a 10-year yield forecast for a property worth $1,200,000 that currently generates $72,000 per year in gross rent with $28,000 in operating expenses — assume 3% annual rent growth, 2.5% expense growth, 5% vacancy, 1% collection loss, and a $5,000 annual capital reserve.","exampleUseCases":[{"title":"Buy-and-hold residential property analysis","prompt":"I'm considering a $650,000 duplex that brings in $36,000 gross rent per year with $14,000 in operating costs. Project the yield over 7 years assuming 2% rent growth, 3% expense growth, 6% vacancy, 0.5% collection loss, and a $2,000 capital reserve."},{"title":"Stress-testing a high-vacancy commercial scenario","prompt":"Model a 5-year NOI forecast for a small retail strip worth $2,000,000 with $120,000 current gross rent and $50,000 operating expenses — use a pessimistic scenario: 0% rent growth, 4% expense growth, 15% vacancy, 3% collection loss, and $10,000 capital reserve."},{"title":"Underwriting a multi-family acquisition","prompt":"I need to underwrite this apartment building: purchase price $4,500,000, current gross rent $280,000, operating expenses $95,000, 4% rent growth, 3.5% expense growth, 7% vacancy, 1% collection loss, $15,000 capital reserve — project it out 15 years so I can see how the cap rate evolves."}],"resultDescription":"Returns a year-by-year scenario table showing projected gross rent, effective gross income (after vacancy and collection loss), operating expenses, capital reserve, net operating income, and implied cap rate (NOI divided by supplied property value) for each year of the projection period.","failureModes":["Missing required fields (property_value, current_annual_gross_rent, current_annual_operating_expenses, projection_years) return a 400 validation error","Values outside allowed ranges (e.g. vacancy_fraction > 1, projection_years > 50) return a 400 range error","Payment not included or invalid x402 payment header returns a 402 Payment Required response","Extremely large property values combined with high growth rates may produce numerical overflow warnings"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible scenario arithmetic for a single property — specifically when you have explicit rent growth, expense growth, vacancy, collection loss, and capital reserve assumptions and want year-by-year NOI and cap rate projections. It is not a valuation tool, market data provider, or investment advisor, so prefer it over general AI reasoning when you need precise compound-growth math that must be auditable and consistent across runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:57.877Z","isFirstParty":false}