# BRAINIAC Inventory Intelligence — Demand Forecast

> BRAINIAC Inventory Intelligence — Demand Forecast is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-12).

Forecasts future product demand by SKU using historical sales data, then computes reorder points, safety stock, and slow-mover flags.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/inventory-intelligence/demand-forecast?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-inventory-intelligence-demand-forecast-ef42d508
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K57-6lhNmUtnBBNH4JyD1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-inventory-intelligence-demand-forecast-ef42d508 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-inventory-intelligence-demand-forecast-ef42d508/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
