{"uid":"cap_1RTtxpXAJRkLgteWiZ2RF","slug":"buy-x-get-y-free-merchandise-total-distribution-histogram-f06163aa","name":"Buy-X-Get-Y-Free Merchandise Total Distribution Histogram","description":"Buy-X-get-Y-free merchandise total - Distribution histogram: Distribution histogram 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 distribution histogram report.","url":"https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-histogram?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"bins":{"type":"integer","default":5,"maximum":30,"minimum":1},"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uK_x6bbL_zsPqcmwDEXST","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a distribution histogram of Buy-X-get-Y-free promotional merchandise totals across up to 200 retail basket records, grouped into configurable bins.","exampleAgentPrompt":"Can you show me a distribution histogram in 8 bins for these buy-2-get-1-free retail baskets: 10 units at $25 each, 11 units at $27.50 each, and 12 units at $30 each — all with 2 paid units per group and 1 free unit per group?","exampleUseCases":[{"title":"Promotional pricing spread analysis","prompt":"I have 50 retail transactions under a buy-3-get-1-free deal — unit prices range from $10 to $80, basket sizes from 4 to 60 units — can you bin the merchandise totals into 10 histogram buckets so I can see where spend clusters?"},{"title":"Comparing multibuy tier distributions","prompt":"Run a distribution histogram with 5 bins for these buy-2-get-1-free baskets: 8 units at $15, 16 units at $15, 24 units at $15, 10 units at $20, and 20 units at $20 — all with paid_units_per_group 2 and free_units_per_group 1."},{"title":"Retail markdown impact histogram","prompt":"We're evaluating a buy-4-get-2-free promotion across 30 transactions with mixed basket sizes and unit prices between $5 and $50 — can you generate a 7-bin histogram of the effective merchandise totals so we can assess the discount distribution?"}],"resultDescription":"A bounded distribution histogram report showing how Buy-X-get-Y-free merchandise totals are distributed across configurable bins, including bin ranges and frequency counts derived from up to 200 supplied retail basket records.","failureModes":["Fewer than 2 rows supplied — minimum 2 records required","More than 200 rows supplied — exceeds maximum item limit","paid_units_per_group set to 0 — minimum value is 1","bins value out of range (must be 1–30)","unit_price or basket_units negative — minimum is 0","Malformed row objects missing required fields (basket_units, paid_units_per_group, free_units_per_group, unit_price)","Payment not completed via x402 protocol — endpoint requires 0.01 USDC per call"],"whenToPreferThis":"Choose this endpoint when you need a statistical frequency distribution of merchandise totals specifically for Buy-X-get-Y-free promotions from your own supplied retail data. It is ideal for offline analysis of existing basket-level transaction records when you do not need live pricing, platform connectivity, or order execution — just a bounded histogram computation over up to 200 rows at minimal cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T19:07:41.109Z","isFirstParty":false,"canonicalSlug":"buy-x-get-y-free-merchandise-total-distribution-histogram-f06163aa"}