{"uid":"cap_xhGu7qLL0P1ELTrI_S8LX","slug":"buy-x-get-y-free-merchandise-total-sequential-input-change-attribution-e7403076","name":"Buy-X-Get-Y-Free Merchandise Total: Sequential Input-Change Attribution","description":"Buy-X-get-Y-free merchandise total - Sequential input-change attribution: Sequential input-change attribution 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 sequential input-change attribution report.","url":"https://market.datapackvibe.com/x402/assistant-ar-retail-multibuy-price-waterfall?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"after":{"type":"object","default":{"unit_price":27.500000000000004,"basket_units":11,"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},"before":{"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_7bEB5cn9fflfEipjaNwZK","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 and attributes the change in Buy-X-Get-Y-Free promotional merchandise totals between two sets of retail parameters, showing which input changes drove the difference.","exampleAgentPrompt":"I changed my Buy-2-Get-1-Free deal: before it was 10 basket units at $25 each with 2 paid and 1 free per group, and after it's 11 basket units at $27.50 with the same group structure — can you do a sequential attribution breakdown showing which input change drove the difference in my merchandise total?","exampleUseCases":[{"title":"Price increase impact attribution","prompt":"My Buy-3-Get-1-Free deal had 20 basket units at $15 each before, and now I've raised the unit price to $18 — same 3 paid, 1 free group structure. Run a sequential attribution so I can see how much of the merchandise total change came from the price hike vs anything else."},{"title":"Basket size expansion attribution","prompt":"I'm analyzing how expanding my basket from 9 units to 15 units affected my Buy-2-Get-1-Free merchandise total — unit price stayed at $30, 2 paid and 1 free per group both before and after. Break down which input change is responsible for the total shift."},{"title":"Promotion structure change waterfall","prompt":"We changed our multi-buy promotion structure from Buy-2-Get-1 to Buy-3-Get-1 while keeping 12 basket units at $22 each. Can you do a sequential input-change attribution to show how the shift in paid and free units per group affected our merchandise total?"}],"resultDescription":"A bounded sequential input-change attribution report that decomposes the difference in Buy-X-Get-Y-Free merchandise totals between 'before' and 'after' retail parameter sets, quantifying how much each individual input change (unit price, basket units, paid units per group, free units per group) contributed to the total delta in sequence.","failureModes":["Invalid parameter ranges (e.g. paid_units_per_group < 1) return validation errors","basket_units or group unit counts exceeding 1,000,000 may be rejected","unit_price exceeding 1,000,000,000,000 is out of range","Missing required fields in before or after objects cause schema validation failures","Payment failure or insufficient USDC balance prevents call execution"],"whenToPreferThis":"Use this endpoint when you need to understand *why* a Buy-X-Get-Y-Free merchandise total changed between two scenarios — specifically to attribute the delta sequentially to each input variable. Prefer it over generic pricing calculators when you need a waterfall/attribution breakdown rather than just a single total, and when your scenario involves multi-buy promotional structures (buy X, get Y free) with retail basket parameters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T19:08:57.044Z","isFirstParty":false,"canonicalSlug":"buy-x-get-y-free-merchandise-total-sequential-input-change-attribution-e7403076"}