# Buy-X-Get-Y-Free Merchandise Total Distribution Histogram

> Buy-X-Get-Y-Free Merchandise Total 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-15).

Computes a distribution histogram of Buy-X-get-Y-free promotional merchandise totals across up to 200 retail basket records, grouped into configurable bins.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-histogram?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/buy-x-get-y-free-merchandise-total-distribution-histogram-f06163aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1RTtxpXAJRkLgteWiZ2RF

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 buy-x-get-y-free-merchandise-total-distribution-histogram-f06163aa -d '<json body>'
```

Example prompt: Can you show me a distribution histogram in 8 bins for these buy-2-get-1-free retail baskets: 10 units at $25 each, 11 units at $27.50 each, and 12 units at $30 each — all with 2 paid units per group and 1 free unit per group?

## When to prefer this

Choose this endpoint when you need a statistical frequency distribution of merchandise totals specifically for Buy-X-get-Y-free promotions from your own supplied retail data. It is ideal for offline analysis of existing basket-level transaction records when you do not need live pricing, platform connectivity, or order execution — just a bounded histogram computation over up to 200 rows at minimal cost.

## Known failure modes

- Fewer than 2 rows supplied — minimum 2 records required
- More than 200 rows supplied — exceeds maximum item limit
- paid_units_per_group set to 0 — minimum value is 1
- bins value out of range (must be 1–30)
- unit_price or basket_units negative — minimum is 0
- Malformed row objects missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price)
- Payment not completed via x402 protocol — endpoint requires 0.01 USDC per call

## How this service works

Buy-X-get-Y-free merchandise total - Distribution histogram: Distribution histogram for Buy-X-get-Y-free merchandise total. Supplied retail figures only, up to 200 records. No platform access, live rates or order execution. One of 25 new profiles across 20 shared operations in this industry. 0.01 USDC includes one bounded distribution histogram report.

## Output

A bounded distribution histogram report showing how Buy-X-get-Y-free merchandise totals are distributed across configurable bins, including bin ranges and frequency counts derived from up to 200 supplied retail basket records.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bins": {
   "type": "integer",
   "default": 5,
   "maximum": 30,
   "minimum": 1
  },
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "basket_units",
     "paid_units_per_group",
     "free_units_per_group",
     "unit_price"
    ],
    "properties": {
     "unit_price": {
      "type": "number",
      "default": 25,
      "maximum": 1000000000000,
      "minimum": 0
     },
     "basket_units": {
      "type": "integer",
      "default": 10,
      "maximum": 1000000,
      "minimum": 0
     },
     "free_units_per_group": {
      "type": "integer",
      "default": 1,
      "maximum": 1000000,
      "minimum": 0
     },
     "paid_units_per_group": {
      "type": "integer",
      "default": 2,
      "maximum": 1000000,
      "minimum": 1
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "unit_price": 25,
     "basket_units": 10,
     "free_units_per_group": 1,
     "paid_units_per_group": 2
    },
    {
     "unit_price": 27.500000000000004,
     "basket_units": 11,
     "free_units_per_group": 1,
     "paid_units_per_group": 2
    },
    {
     "unit_price": 25,
     "basket_units": 10,
     "free_units_per_group": 1,
     "paid_units_per_group": 2
    },
    {
     "unit_price": 27.500000000000004,
     "basket_units": 11,
     "free_units_per_group": 1,
     "paid_units_per_group": 2
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/buy-x-get-y-free-merchandise-total-distribution-histogram-f06163aa/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)