{"uid":"cap_YSypb0cWKhtpoHSKECx-r","slug":"buy-x-get-y-free-merchandise-total-calculator-b4fdf9fe","name":"Buy-X-Get-Y-Free Merchandise Total Calculator","description":"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.","url":"https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-calculate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"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_qEgvFxH2mAHXmXlSMNrdz","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":"Calculates the total merchandise cost after applying a buy-X-get-Y-free discount structure to a basket of retail items.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Retail promotion pricing check","prompt":"I have 10 items at $25 each and I'm running a buy-2-get-1-free deal — what's the total merchandise cost after the free units are applied?"},{"title":"E-commerce basket discount estimate","prompt":"Can you work out the total price for a basket of 50 units at $8.99 each under a buy-3-get-1-free promotion?"},{"title":"Wholesale bundle cost calculation","prompt":"What would a customer pay for 30 units at $40 each if I offer buy-4-get-2-free deals on those items?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T00:55:01.667Z","isFirstParty":false,"canonicalSlug":"buy-x-get-y-free-merchandise-total-calculator-b4fdf9fe"}