Series trade discount API

Applies a series (chain/cascading) trade discount like 10/5/2 successively and returns the single equivalent discount rate and net price. Answers 'What is the net price after a 10/5/2 chain discount?', 'What single discount equals a series?'.

Price$0.04per request

MethodPOST

Route/v1/finance/trade-discount-chain

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

discounttrade-discountseries-discountchain-discountpricingwholesalesingle-equivalentbusiness

API URLhttps://x402.hexl.dev/v1/finance/trade-discount-chain

Integration docs

Example request

{
  "listPrice": 1000,
  "discountPercents": [
    10,
    5,
    2
  ],
  "quantity": 3
}

Example response

{
  "listPrice": 1000,
  "discountPercents": [
    10,
    5,
    2
  ],
  "steps": [
    {
      "discountPercent": 10,
      "discountAmount": 100,
      "priceAfter": 900
    },
    {
      "discountPercent": 5,
      "discountAmount": 45,
      "priceAfter": 855
    },
    {
      "discountPercent": 2,
      "discountAmount": 17.1,
      "priceAfter": 837.9
    }
  ],
  "netUnitPrice": 837.9,
  "totalDiscountAmount": 162.1,
  "singleEquivalentDiscountPercent": 16.21,
  "quantity": 3,
  "extendedNetPrice": 2513.7,
  "interpretation": "A 10/5/2 chain is NOT 17% off — the single equivalent is 16.21% (net $837.9/unit)."
}

Input schema

{
  "type": "object",
  "required": [
    "listPrice",
    "discountPercents"
  ],
  "properties": {
    "listPrice": {
      "type": "number",
      "examples": [
        1000
      ]
    },
    "discountPercents": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "examples": [
        [
          10,
          5,
          2
        ]
      ]
    },
    "quantity": {
      "type": "number",
      "examples": [
        3
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}