Calculators

Customer Lifetime Value (CLV) API

Compute Customer Lifetime Value (CLV = AOV × purchaseFrequency × lifespanYears × grossMargin), optionally present-value discounted at a discount rate, with a rating bucket. Deterministic. Answers 'what is my customer lifetime value','CLV with gross margin and discount rate'.

Price$0.01per request

MethodPOST

Route/v1/calc/ecom-clv

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

ecomclvltvlifetime-valueretentionmarginecommercecalc

API URLhttps://x402.hexl.dev/v1/calc/ecom-clv

Integration docs

Example request

{
  "aov": 80,
  "purchaseFrequency": 4,
  "lifespanYears": 3,
  "grossMargin": 0.5
}

Example response

{
  "formula": "CLV = AOV × purchaseFrequency × lifespanYears × grossMargin (PV-discounted if discountRate given)",
  "aov": 80,
  "purchaseFrequency": 4,
  "lifespanYears": 3,
  "grossMargin": 0.5,
  "annualCustomerValue": 160,
  "nominalClv": 480,
  "presentValueClv": null,
  "clv": 480,
  "rating": "moderate"
}

Input schema

{
  "type": "object",
  "required": [
    "aov",
    "purchaseFrequency",
    "lifespanYears"
  ],
  "properties": {
    "aov": {
      "type": "number",
      "examples": [
        80
      ]
    },
    "purchaseFrequency": {
      "type": "number",
      "description": "Purchases per year",
      "examples": [
        4
      ]
    },
    "lifespanYears": {
      "type": "number",
      "examples": [
        3
      ]
    },
    "grossMargin": {
      "type": "number",
      "description": "Decimal 0-1, default 1",
      "examples": [
        0.5
      ]
    },
    "discountRate": {
      "type": "number",
      "description": "Optional annual discount rate for PV",
      "examples": [
        0.1
      ]
    }
  }
}

Output schema

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