# Buy-X-Get-Y-Free Merchandise Total – Two-Input Scenario Grid

> Buy-X-Get-Y-Free Merchandise Total – Two-Input Scenario Grid 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).

Generates a two-dimensional scenario grid showing effective merchandise totals under buy-X-get-Y-free pricing across combinations of two variable inputs

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-stress-grid?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-two-input-scenario-grid-c3282ff9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S-t413ffWhXphqa1bWGEG

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-two-input-scenario-grid-c3282ff9 -d '<json body>'
```

Example prompt: Generate a scenario grid for a buy-2-get-1-free promotion where I vary basket_units from 6 to 12 and unit_price from 10 to 50, using a baseline of 10 basket units, 2 paid units per group, 1 free unit per group, and a unit price of $25.

## When to prefer this

Choose this endpoint when you need a structured two-dimensional sensitivity grid for buy-X-get-Y-free retail promotions and want to see how two parameters interact simultaneously across multiple values. It is ideal for merchandise planning, promotion stress-testing, and retail scenario modeling without requiring live platform access or order execution. Prefer it over single-scenario calculators when you need a matrix view of outcomes, and over named-scenario comparison endpoints when your goal is a grid sweep of two numeric axes rather than discrete named configurations.

## Known failure modes

- Invalid field_x/field_y enum values cause schema validation errors
- field_x and field_y set to the same field may produce degenerate or redundant output
- values_x or values_y arrays exceeding 10 items are rejected
- Baseline object missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) causes request failure
- paid_units_per_group of 0 is rejected (minimum is 1)
- Extremely large unit_price or basket_units values may produce overflow-like numeric results
- Non-integer values for integer fields (basket_units, free_units_per_group, paid_units_per_group) cause validation errors
- Payment failure or insufficient USDC balance prevents result delivery

## How this service works

Buy-X-get-Y-free merchandise total - Two-input scenario grid: Two-input scenario grid 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 two-input scenario grid report.

## Output

Returns a bounded two-input scenario grid report (up to 200 records) showing computed effective merchandise totals for each combination of the two selected variable fields, given the baseline parameters and the specified arrays of x- and y-axis values. Output is a matrix of buy-X-get-Y-free cost outcomes suitable for retail planning and promotional analysis.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "field_x": {
   "enum": [
    "basket_units",
    "paid_units_per_group",
    "free_units_per_group",
    "unit_price"
   ],
   "type": "string",
   "default": "basket_units"
  },
  "field_y": {
   "enum": [
    "basket_units",
    "paid_units_per_group",
    "free_units_per_group",
    "unit_price"
   ],
   "type": "string",
   "default": "paid_units_per_group"
  },
  "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
  },
  "values_x": {
   "type": "array",
   "items": {
    "type": "number",
    "default": 1,
    "maximum": 1000000000000,
    "minimum": -1000000000000
   },
   "default": [
    10,
    11
   ],
   "maxItems": 10,
   "minItems": 1
  },
  "values_y": {
   "type": "array",
   "items": {
    "type": "number",
    "default": 1,
    "maximum": 1000000000000,
    "minimum": -1000000000000
   },
   "default": [
    2,
    2
   ],
   "maxItems": 10,
   "minItems": 1
  }
 }
}
```

## More

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