# Gross Margin Return on Inventory (GMROI) - Distribution Histogram

> Gross Margin Return on Inventory (GMROI) - Distribution Histogram is a paid API for AI agents from market.datapackvibe.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-24).

Computes a distribution histogram of Gross Margin Return on Inventory (GMROI) values across multiple retail inventory data rows, bucketed into a configurable number of bins.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-sector-retail-inventory-margin-return-histogram?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gross-margin-return-on-inventory-gmroi-distribution-histogram-bc471ddc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4FGXil0F4m85EoedEiFm3

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 gross-margin-return-on-inventory-gmroi-distribution-histogram-bc471ddc -d '<json body>'
```

Example prompt: Can you generate a GMROI distribution histogram using 8 bins for these 5 product lines: gross profits of $4,200, $6,800, $3,100, $9,500, $5,600 with average inventory costs of $2,100, $3,400, $1,550, $4,750, $2,800?

## When to prefer this

Choose this endpoint when you need a statistical frequency distribution of GMROI values across multiple retail inventory data points — especially for scenario analysis, performance benchmarking, or identifying clusters and outliers in inventory efficiency. It is ideal for offline/local calculation using supplied figures when no live inventory system access is needed. Prefer it over simple summary statistics when the shape of the GMROI distribution matters, not just the mean or median.

## Known failure modes

- Fewer than 2 rows provided — minimum 2 rows required
- average_inventory_cost of zero or negative — excluded by schema (exclusiveMinimum: 0)
- More than 200 rows submitted — exceeds maxItems limit
- Bins value outside 1–30 range — rejected by schema bounds
- Missing required fields gross_profit or average_inventory_cost in any row — validation error
- All GMROI values identical — histogram may collapse to a single bin with no useful spread

## How this service works

Gross margin return on inventory - Distribution histogram: Distribution histogram for Gross margin return on inventory. Supplied retail figures only. Local calculation and scenario analysis; no live inventory, account access, platform fee lookup or order execution. One of 25 profiles or calculations across 20 shared operations in this sector. 0.01 USDC includes one bounded distribution histogram deliverable.

## Output

A bounded distribution histogram showing how GMROI values (gross_profit / average_inventory_cost) are distributed across the input rows, organized into the specified number of bins. Each bin includes its range boundaries and the count (frequency) of data points falling within it, enabling visual or analytical assessment of inventory margin performance spread.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bins": {
   "type": "integer",
   "default": 5,
   "maximum": 30,
   "minimum": 1
  },
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "gross_profit",
     "average_inventory_cost"
    ],
    "properties": {
     "gross_profit": {
      "type": "number",
      "default": 5000,
      "maximum": 1000000000000,
      "minimum": -1000000000000
     },
     "average_inventory_cost": {
      "type": "number",
      "default": 2500,
      "maximum": 1000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "gross_profit": 5000,
     "average_inventory_cost": 2500
    },
    {
     "gross_profit": 5500,
     "average_inventory_cost": 2750
    },
    {
     "gross_profit": 5000,
     "average_inventory_cost": 2500
    },
    {
     "gross_profit": 5500,
     "average_inventory_cost": 2750
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gross-margin-return-on-inventory-gmroi-distribution-histogram-bc471ddc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market.datapackvibe.com](https://www.zero.xyz/host/market.datapackvibe.com/llms.txt)
