# Buy-X-Get-Y-Free Merchandise Total — Named Scenario Comparison

> Buy-X-Get-Y-Free Merchandise Total — Named Scenario Comparison 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-19).

Compares named retail pricing scenarios for buy-X-get-Y-free promotions, calculating merchandise totals across a baseline and up to 20 labeled override scenarios.

## Facts

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

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-named-scenario-comparison-a4212eb6 -d '<json body>'
```

Example prompt: Compare three buy-X-get-Y-free scenarios for a product priced at $25 per unit with a basket of 10 units: baseline is buy 2 get 1 free, then compare buy 3 get 1 free labeled 'Conservative Promo', and buy 1 get 1 free labeled 'Aggressive BOGO'.

## When to prefer this

Choose this endpoint when you need to compare multiple named buy-X-get-Y-free promotional structures side-by-side using supplied retail figures, without needing live pricing data or order execution. Ideal for offline retail promotion modeling, pricing team reports, and scenario planning where up to 20 labeled configurations must be evaluated against a common baseline. Prefer this over generic discount calculators when the multibuy (quantity-gated free units) mechanic is specifically required.

## Known failure modes

- Validation error if paid_units_per_group is less than 1
- Error if scenarios array is empty or exceeds 20 items
- Error if scenario label exceeds 80 characters or is empty
- Error if overrides object has no properties specified
- Numeric overflow if unit_price or basket_units exceed maximums
- Malformed request if required baseline fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) are missing

## How this service works

Buy-X-get-Y-free merchandise total - Named scenario comparison: Named scenario comparison 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 named scenario comparison report.

## Output

A named scenario comparison report containing the merchandise total for the baseline configuration and each labeled override scenario, showing the financial impact of different buy-X-get-Y-free promotional structures across up to 20 named scenarios. No live rates, order execution, or platform data is included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "baseline": {
   "type": "object",
   "default": {
    "unit_price": 25,
    "basket_units": 10,
    "free_units_per_group": 1,
    "paid_units_per_group": 2
   },
   "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
  },
  "scenarios": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "label",
     "overrides"
    ],
    "properties": {
     "label": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "overrides": {
      "type": "object",
      "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
       }
      },
      "minProperties": 1,
      "additionalProperties": false
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "label": "Supplied alternative",
     "overrides": {
      "basket_units": 11
     }
    }
   ],
   "maxItems": 20,
   "minItems": 1
  }
 }
}
```

## More

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