{"uid":"cap_K57-6lhNmUtnBBNH4JyD1","slug":"brainiac-inventory-intelligence-demand-forecast-ef42d508","name":"BRAINIAC Inventory Intelligence — Demand Forecast","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/inventory-intelligence/demand-forecast?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"sales":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"units":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"products":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"onHand":{"type":"number","maximum":1000000000,"minimum":0},"onOrder":{"type":"number","maximum":1000000000,"minimum":0},"unitCost":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"slowDays":{"type":"number","maximum":3650,"minimum":1},"purchases":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"units":{"type":"number","maximum":1000000000,"minimum":0},"unitPrice":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500},"slowUnits":{"type":"number","maximum":1000000000,"minimum":0},"suppliers":{"type":"array","items":{"type":"object","properties":{"moq":{"type":"number","maximum":1000000000,"minimum":0},"sku":{"type":"string","maxLength":80},"supplierId":{"type":"string","maxLength":80},"leadTimeDays":{"type":"number","maximum":3650,"minimum":0}},"additionalProperties":false},"maxItems":200},"reviewDays":{"type":"number","maximum":365,"minimum":0},"historyDays":{"type":"integer","maximum":3650,"minimum":1},"forecastDays":{"type":"integer","maximum":365,"minimum":1},"serviceLevelZ":{"type":"number","maximum":5,"minimum":0},"excessDaysCover":{"type":"number","maximum":3650,"minimum":1}}},"responseSchema":{"type":"json","example":{"items":[{"sku":"SKU-1","name":"SKU-1","method":"simple_daily_average","assumption":"forecastUnits = averageDailyDemand × forecastDays, using only sales dated on or before 2026-11-10.","demandStdev":1.7889,"uncertainty":"high","forecastDays":7,"forecastUnits":70,"demandSupplied":true,"historyDaysUsed":5,"averageDailyDemand":10,"seasonalityModeled":false,"forecastUnitsSupplied":true}],"status":"forecasted","findings":[{"code":"forecast_uncertainty","kind":"observation","detail":"Forecast uses a simple average over 5 day(s). Seasonality is not modeled. Uncertainty=high.","subject":"SKU-1"}],"checkedAt":"2026-11-04T19:00:00.000Z","assumptions":["serviceLevelZ=1.65 (explicit normal z factor for safety stock)","reviewDays=0","historyDays=5","forecastDays=7","excessDaysCover=90","slowUnits=5 over slowDays=90","Daily demand average fills missing days in the history window with zero when a history end date exists.","Seasonality is not added. Only variation already present in the supplied history affects the standard deviation.","Forecast method is a simple historical daily average. No external demand signal is used."],"historyDays":5,"limitations":["Products, sales, supplier lead times, and purchases are copied only from labeled fields supplied by the caller.","Reorder point = average daily demand × (lead time days + review days) + safety stock.","Safety stock = service-level z × daily demand standard deviation × square root of lead time days.","Demand forecasts use a simple average of available history only. Seasonality is not modeled unless present in that history.","Lead times, demand, and purchase prices are never invented. No purchase order is created and no inventory system is accessed."],"forecastDays":7,"priceInvented":false,"demandInvented":false,"leadTimeInvented":false,"purchaseOrderCreated":false,"inventorySystemAccessed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ECjJIQ7U9vf34BrN21gkp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Forecasts future product demand by SKU using historical sales data, then computes reorder points, safety stock, and slow-mover flags.","exampleAgentPrompt":"Using our sales history for the last 90 days across these SKUs, forecast demand for the next 14 days, flag any slow movers (fewer than 5 units over 90 days), and calculate reorder points assuming a 95% service level and the lead times and minimum order quantities I'll paste in for each supplier.","exampleUseCases":[{"title":"Weekly restock planning for e-commerce","prompt":"I have 30 SKUs in my Shopify store. Here's a CSV of daily sales for the past 60 days. Forecast demand for the next 7 days, flag anything that looks like a slow mover (under 3 units in 90 days), and tell me which SKUs I need to reorder given current on-hand quantities and a 10-day supplier lead time."},{"title":"Safety stock calculation for seasonal products","prompt":"Our peak season is coming up. Can you analyze 180 days of sales history for these 15 SKUs and compute safety stock and reorder points assuming a 98% service level? Supplier lead time is 14 days and we do restocking reviews every 7 days."},{"title":"Identifying dead stock before year-end","prompt":"Before we do our year-end inventory audit, can you look at the last 365 days of sales for all our SKUs and flag anything that sold fewer than 10 units total over that period as a slow mover? I'll paste in the product list and sales data as JSON."}],"resultDescription":"Returns a JSON object with per-SKU forecast results including forecasted units, average daily demand, demand standard deviation, uncertainty level, forecast method used, and history days used. Also includes top-level findings (e.g. slow movers, high uncertainty flags), a list of assumptions and limitations applied, the forecast horizon in days, and boolean flags confirming no data was invented and no purchase orders were created.","failureModes":["Insufficient sales history for a SKU results in high-uncertainty forecasts using minimal data points","Missing supplier lead time data means reorder points cannot be computed for affected SKUs","Malformed or mismatched SKU identifiers between products, sales, and supplier arrays cause items to be excluded","CSV or JSON payload exceeds 200,000 character limit causing request rejection","Seasonality is not modeled — forecasts during holiday or seasonal peaks may be systematically low","More than 2000 sales records or 200 products/suppliers triggers maxItems validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, structured demand forecast with explicit assumptions and no-invention guarantees — especially useful for AI agents that must audit what was inferred vs supplied. It is well-suited for small-to-medium catalogs (up to 200 SKUs) where you can supply raw sales history directly in the request payload. Prefer it over generic LLM forecasting when you need deterministic reorder-point and safety-stock calculations with traceable methodology. It is not suited for large enterprise catalogs, real-time POS integration, or multi-echelon supply chains requiring complex seasonality modeling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:59.848Z","isFirstParty":false,"canonicalSlug":"brainiac-inventory-intelligence-demand-forecast-ef42d508"}