# Buy-X-Get-Y-Free Merchandise Total Calculator

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

Calculates the total merchandise cost after applying a buy-X-get-Y-free discount structure to a basket of retail items.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-calculate?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/buy-x-get-y-free-merchandise-total-calculator-b4fdf9fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YSypb0cWKhtpoHSKECx-r

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-calculator-b4fdf9fe -d '<json body>'
```

Example prompt: Calculate the buy-2-get-1-free total for a basket of 10 units priced at $25 each, where every group of 2 paid units includes 1 free unit.

## When to prefer this

Choose this endpoint when you need a quick, one-off calculation of retail merchandise totals under a buy-X-get-Y-free promotional structure, supplying your own retail figures without needing live pricing data, platform integration, or order execution. It is ideal for agents computing promotional basket totals programmatically at very low cost ($0.01 USDC per call).

## Known failure modes

- Invalid or missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) return validation errors
- paid_units_per_group set to zero causes division error (minimum is 1)
- Values exceeding maximum bounds (e.g. unit_price above 1e12) are rejected
- Non-integer values for basket_units or group counts are rejected
- Payment not provided or insufficient USDC causes 402 response

## How this service works

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

## Output

A single calculation report returning the discounted merchandise total after applying the buy-X-get-Y-free promotion, including how many units are charged at full price and how many are provided free, given the basket size and unit price supplied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "values": {
   "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
  }
 }
}
```

## More

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