# Buy-X-Get-Y-Free Merchandise Total Threshold Classifier

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

Classifies buy-X-get-Y-free retail basket totals against a numeric threshold range, returning a bounded classification report for up to 200 records.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-threshold?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-threshold-classifier-8b7dadf0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r74FyApwJpApxVDzXKem6

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-threshold-classifier-8b7dadf0 -d '<json body>'
```

Example prompt: Can you classify these 5 buy-2-get-1-free basket records against a lower threshold of 50 and upper threshold of 300? Each basket has 10 units at $25 each, with 2 paid units and 1 free unit per group.

## When to prefer this

Choose this endpoint when you need to classify buy-X-get-Y-free promotional basket totals against numeric thresholds in batch (up to 200 records) using only supplied retail figures, without requiring platform access, live pricing feeds, or order execution. It is well-suited for auditing, segmentation, and validation of multibuy promotions offline.

## Known failure modes

- Fewer than 2 rows submitted — minimum row count not met
- More than 200 rows submitted — exceeds maximum batch size
- paid_units_per_group set to 0 — violates minimum of 1
- unit_price or basket_units out of allowed numeric range
- lower threshold greater than upper threshold — logically invalid range
- Malformed row objects missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price)

## How this service works

Buy-X-get-Y-free merchandise total - Threshold classification: Threshold classification 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 threshold classification report.

## Output

A bounded threshold classification report for each submitted row, indicating whether the computed buy-X-get-Y-free merchandise total falls below, within, or above the specified lower and upper thresholds. Up to 200 records processed 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
    },
    {
     "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": 2
  },
  "lower": {
   "type": "number",
   "default": 0,
   "maximum": 1000000000000000000,
   "minimum": -1000000000000000000
  },
  "upper": {
   "type": "number",
   "default": 100,
   "maximum": 1000000000000000000,
   "minimum": -1000000000000000000
  }
 }
}
```

## More

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