{"uid":"cap_JbOo2eS85iodzrVr9J6K1","slug":"halowerk-demand-forecast-b07f5f39","name":"HALOWERK Demand Forecast","description":"Forecasts one SKU from a history you supply. The pipeline is fixed and fully disclosed in the response rather than hidden behind a score. The series is decomposed multiplicatively while every observation is positive and additively as soon as a zero or a negative appears, because a ratio is not defined there; the seasonal index is the median ratio per phase against a centred moving average, estimated only on periods that carry no promotion and no holiday so that a campaign in week twelve does…","url":"https://handel.halowerk.com/v1/demand-forecast?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"history":{"type":"array","items":{"type":"object","required":["period_start","quantity"],"properties":{"holiday":{"type":"boolean","default":false,"description":"Whether that period contained a holiday you consider relevant. The calendar is yours; no holiday list is looked up."},"quantity":{"type":"number","maximum":1000000000,"minimum":-1000000000,"description":"Units sold in that period. Zero is allowed and switches the decomposition to additive."},"promotion":{"type":"boolean","default":false,"description":"Whether the SKU was on promotion in that period."},"period_start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day of the period as YYYY-MM-DD."}},"additionalProperties":false},"maxItems":520,"minItems":4,"description":"The demand history, one entry per period, oldest first. Periods must be consecutive and each period_start must be unique and ascending."},"frequency":{"enum":["daily","weekly","monthly"],"type":"string","description":"Length of one period. Sets the default season length: 7 for daily, 52 for weekly, 12 for monthly."},"future_events":{"type":"array","items":{"type":"object","required":["period_start"],"properties":{"holiday":{"type":"boolean","default":false},"promotion":{"type":"boolean","default":false},"period_start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day of the forecast period this applies to."}},"additionalProperties":false},"maxItems":104,"description":"Promotions and holidays you already know about for the forecast periods. Matched on period_start against the generated periods; an entry that matches no period is reported back as unmatched."},"horizon_periods":{"type":"integer","default":8,"maximum":104,"minimum":1,"description":"How many periods to forecast."},"backtest_periods":{"type":"integer","default":0,"maximum":52,"minimum":0,"description":"How many of the last periods to hold back for the comparison against the baselines. Zero picks a quarter of the history, capped at the horizon."},"confidence_level":{"enum":[0.8,0.9,0.95],"type":"number","default":0.9,"description":"Confidence level of the prediction interval."},"season_length_periods":{"type":"integer","maximum":53,"minimum":0,"description":"Override the season length in periods. Zero switches seasonality off. Omitted uses the default for the frequency."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tMKH-Nos8IVDaU-vPs-dB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Forecasts future demand for a single SKU using multiplicative or additive decomposition, with the full pipeline logic disclosed in the response.","exampleAgentPrompt":"Forecast weekly demand for the next 8 weeks for my product using this sales history — weeks 1 through 52 of last year with quantities, noting that weeks 10 and 24 had promotions and week 15 was a holiday — and backtest against the last 4 periods so I can see how accurate it is.","exampleUseCases":[{"title":"Retail inventory replenishment planning","prompt":"I have 52 weeks of weekly sales data for one of my SKUs and I need to forecast the next 12 weeks of demand. Weeks 3, 15, and 40 had promotions, week 50 was a holiday, and I already know there's a promotion planned for week 55. Can you run the forecast and backtest against the last 4 weeks?"},{"title":"Monthly demand forecast with seasonal decomposition","prompt":"Forecast the next 6 months of demand for my product using the last 24 months of sales history I'll provide. Use monthly frequency, and flag months 11 and 12 as holiday periods. I want to see the decomposition method and seasonal indices in the response."},{"title":"Promotion-adjusted demand forecast for campaign planning","prompt":"I'm planning a marketing campaign and need to forecast daily demand for the next 14 days for one SKU. Here's the last 90 days of daily sales. Days 20 through 30 were on promotion — exclude those from the seasonal baseline — and flag the upcoming day 7 as a holiday so the forecast adjusts for it."}],"resultDescription":"Returns a per-period demand forecast for the requested horizon, the decomposition method used (multiplicative or additive), seasonal indices per phase, trend component, and optionally backtest accuracy metrics comparing the model against held-out periods and baseline models. Any future_events entries that did not match a forecast period are returned as unmatched.","failureModes":["Fewer than 4 history entries provided — returns validation error","Non-consecutive or non-unique period_start values — returns validation error","All quantities are zero preventing meaningful decomposition — may return degenerate forecast","Horizon exceeds 104 periods — returns validation error","Backtest periods exceed available history — returns validation error","Unmatched future_events entries reported in response but do not cause failure"],"whenToPreferThis":"Choose this endpoint when you need a transparent, interpretable single-SKU demand forecast where the pipeline logic (decomposition method, seasonal index calculation) is fully disclosed rather than hidden behind a black-box score. It is especially suited for cases where promotion and holiday periods must be excluded from baseline seasonality estimation, and where backtest comparison against naive baselines is needed to validate forecast quality.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:31:17.722Z","isFirstParty":false,"canonicalSlug":"halowerk-demand-forecast-b07f5f39"}