# Buy-X-Get-Y-Free Merchandise Total — Batch Calculation

> Buy-X-Get-Y-Free Merchandise Total — Batch Calculation 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-28).

Calculates the effective merchandise total for Buy-X-Get-Y-Free promotions across a batch of up to 200 retail line items, given unit prices, basket quantities, and deal group parameters.

## Facts

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

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-batch-calculation-390bbcef -d '<json body>'
```

Example prompt: Calculate the buy-2-get-1-free merchandise totals for these 3 product lines: 10 units at $25 each, 15 units at $18 each, and 8 units at $40 each — all with buy 2 get 1 free pricing.

## When to prefer this

Choose this endpoint when you need to compute effective retail totals for Buy-X-Get-Y-Free promotions in bulk (up to 200 rows) using only supplied figures — no live pricing feeds, platform integrations, or order execution involved. Ideal for offline pricing simulations, promotional validation, or building discount logic into a retail agent pipeline. Prefer this over single-row calculations when processing multiple SKUs or basket configurations simultaneously.

## Known failure modes

- Row missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) — validation error returned
- paid_units_per_group set to 0 — fails minimum constraint of 1
- Batch exceeds 200 rows — rejected with maxItems error
- unit_price or basket_units out of allowed range — schema validation failure
- Malformed JSON body — 400 bad request
- Payment not fulfilled via x402 protocol — 402 Payment Required

## How this service works

Buy-X-get-Y-free merchandise total - Batch calculation: Batch calculation 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 batch calculation report.

## Output

A bounded batch calculation report containing the effective merchandise total for each supplied row, factoring in the buy-X-get-Y-free deal structure (paid units per group, free units per group, basket quantity, and unit price). Returns one result record per input row, up to 200 rows per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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
    }
   ],
   "maxItems": 200,
   "minItems": 1
  }
 }
}
```

## More

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