Detect excess inventory API

Flag SKUs whose days of cover from supplied on-hand and average daily demand exceed the disclosed excessDaysCover threshold.

The Detect excess inventory operation is part of the Inventory Intelligence API on BRAINIAC.software. Flag SKUs whose days of cover from supplied on-hand and average daily demand exceed the disclosed excessDaysCover threshold. It is exposed as POST /api/v1/inventory-intelligence/excess-detect and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied sales history Current inventory Supplier lead times Purchase records Limitations: Lead times, demand, and prices are never invented. Reorder point and safety stock use explicit disclosed formulas. Forecasts use a simple historical average only. Seasonality is not modeled beyond variation already in the history. No purchase order is created and no inventory system is accessed. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Normalize inventory data, Calculate stockout risk, Calculate reorder points, Calculate safety stock. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.04 USDC
/api/v1/inventory-intelligence/excess-detect

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/inventory-intelligence/excess-detect" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-10",
  "historyDays": 5,
  "excessDaysCover": 30,
  "products": [
    {
      "sku": "SKU-1",
      "name": "Widget",
      "onHand": 500
    },
    {
      "sku": "SKU-2",
      "name": "Gadget",
      "onHand": 20
    }
  ],
  "sales": [
    {
      "sku": "SKU-1",
      "date": "2026-11-06",
      "units": 2
    },
    {
      "sku": "SKU-1",
      "date": "2026-11-07",
      "units": 2
    },
    {
      "sku": "SKU-1",
      "date": "2026-11-08",
      "units": 2
    },
    {
      "sku": "SKU-1",
      "date": "2026-11-09",
      "units": 2
    },
    {
      "sku": "SKU-1",
      "date": "2026-11-10",
      "units": 2
    },
    {
      "sku": "SKU-2",
      "date": "2026-11-06",
      "units": 5
    },
    {
      "sku": "SKU-2",
      "date": "2026-11-07",
      "units": 5
    },
    {
      "sku": "SKU-2",
      "date": "2026-11-08",
      "units": 5
    },
    {
      "sku": "SKU-2",
      "date": "2026-11-09",
      "units": 5
    },
    {
      "sku": "SKU-2",
      "date": "2026-11-10",
      "units": 5
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Inventory Intelligence APIFull docsHow it works