{"uid":"cap_1TZfrdtFIUjaOJq9u7qEO","slug":"pricing-math-tiered-quantity-pricing-calculator-98c2cf68","name":"Pricing Math – Tiered Quantity Pricing Calculator","description":"Total and average unit price for a quantity under graduated or volume tiers given as minQty:unitPrice pairs.","url":"https://pricing-math.x402tookit.com/price-tiers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["tiers","quantity"],"properties":{"mode":{"type":"string","description":"graduated (default: each band at its own price) or volume (all units at the reached tier price)"},"tiers":{"type":"string","description":"Comma-separated minQty:unitPrice, first minQty 1, e.g. 1:10,10:9,50:8"},"quantity":{"type":"number","description":"Whole number of units bought"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"mode":{"type":["null","string"]},"total":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"quantity":{"type":["null","number"]},"breakdown":{"type":["array","null"],"items":{"type":"object","properties":{"toQty":{"type":["null","number"]},"units":{"type":["null","number"]},"fromQty":{"type":["null","number"]},"subtotal":{"type":["null","number"]},"unitPrice":{"type":["null","number"]}}}},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"otherModeTotal":{"type":["null","number"]},"averageUnitPrice":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wC5KDuZySD-OeTdnVEGLE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates total cost and average unit price for a given quantity under graduated (per-band) or volume (all-units-at-reached-tier) pricing tiers defined as minQty:unitPrice pairs.","exampleAgentPrompt":"Using graduated pricing with tiers 1:10, 10:9, 50:8 (minQty:unitPrice), what's the total cost and average unit price if I buy 75 units?","exampleUseCases":[{"title":"Wholesale order cost estimate","prompt":"I'm buying 120 units from a supplier with these price breaks: 1:25, 20:22, 50:20, 100:18 — using graduated pricing. What will my total bill be and what's my blended per-unit cost?"},{"title":"Volume vs graduated pricing comparison","prompt":"My supplier offers tiers at 1:15, 25:13, 100:11. If I order 80 units, what's the total under graduated pricing, and also show me what it would cost under volume pricing so I can compare?"},{"title":"SaaS seat pricing calculation","prompt":"We sell software seats at $50 each for 1–9 seats, $45 for 10–49, and $40 for 50+, using volume pricing. A customer wants 60 seats — what's the total invoice amount and average price per seat?"}],"resultDescription":"Returns total price for the given quantity, average unit price, a per-band breakdown showing units consumed in each tier with subtotals, the total under the alternative pricing mode for comparison, the mode used, and a human-readable summary string.","failureModes":["Missing required tiers or quantity parameters returns an error","Tiers not starting at minQty of 1 may cause unexpected results","Non-integer quantity values may be rejected","Malformed tier string (not minQty:unitPrice,… format) returns a parse error","Quantity of zero or negative numbers likely returns an error or zero total"],"whenToPreferThis":"Use this endpoint when you need to compute order costs under structured quantity-based pricing with either graduated (staircase) or volume (all-units-at-tier) logic. It is ideal for B2B procurement, wholesale, SaaS seat licensing, or any scenario where unit prices change at defined quantity thresholds. Prefer it over manual calculation when tier structures are complex or when you need a per-band cost breakdown alongside the total.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:12.053Z","isFirstParty":false,"canonicalSlug":"pricing-math-tiered-quantity-pricing-calculator-98c2cf68"}