# Buy-X-Get-Y-Free Merchandise Total — Target Gap Calculator

> Buy-X-Get-Y-Free Merchandise Total — Target Gap 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-19).

Calculates the gap between a target revenue figure and the actual merchandise total under a buy-X-get-Y-free promotional pricing structure.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-target-gap?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-target-gap-calculator-20a585eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dJvQFlXXcR2RARgTiIoj6

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-target-gap-calculator-20a585eb -d '<json body>'
```

Example prompt: I'm running a buy-2-get-1-free promotion with a unit price of $25, a basket of 10 units, and a revenue target of $100 — can you calculate the merchandise total and tell me how far off the target I am?

## When to prefer this

Choose this endpoint when you need a quick, bounded calculation of the effective merchandise total and revenue gap for a buy-X-get-Y-free retail promotion against a known target. It is purpose-built for multibuy promotional arithmetic (not general discount or coupon types) and is ideal for pre-campaign analysis, reporting, or agent-driven retail planning workflows where live order execution is not needed.

## Known failure modes

- Invalid basket_units (negative or non-integer) returns a validation error
- paid_units_per_group of zero is not permitted (minimum 1) and will be rejected
- Target or unit_price values outside allowed numeric bounds return a schema error
- Requests exceeding 200 records are not supported
- Missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price) return a 422 error
- Payment failure or insufficient USDC balance prevents report generation

## How this service works

Buy-X-get-Y-free merchandise total - Target gap calculation: Target gap 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 target gap calculation report.

## Output

Returns a bounded target gap calculation report showing the effective merchandise total under the buy-X-get-Y-free promotion (accounting for free units) and the numerical gap between that total and the supplied target figure. Limited to supplied retail figures only; no live rates, platform access, or order execution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "number",
   "default": 100,
   "maximum": 1000000000000000000,
   "minimum": -1000000000000000000
  },
  "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-target-gap-calculator-20a585eb/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)