Break-even ROAS / ACoS API

Compute break-even ROAS (1 / grossMargin) and break-even ACoS from price+cost or a supplied gross margin — the threshold ad spend must beat to profit. Deterministic. Answers 'what ROAS do I need to break even','break-even ACoS for my margin'.

Price$0.01per request

MethodPOST

Route/v1/calc/ecom-breakeven-roas

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

ecomroasacosbreakevenadsmarginppccalc

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

Integration docs

Example request

{
  "price": 100,
  "unitCost": 40
}

Example response

{
  "formula": "break-even ROAS = 1 / grossMargin (grossMargin = (price − cost)/price)",
  "grossMargin": 0.6,
  "grossMarginPercent": 60,
  "breakevenRoas": 1.667,
  "breakevenAcosPercent": 60,
  "note": "Spend is profitable only when actual ROAS exceeds the break-even ROAS."
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "price": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "unitCost": {
      "type": "number",
      "examples": [
        40
      ]
    },
    "grossMargin": {
      "type": "number",
      "description": "Alternative to price+cost: decimal in (0,1]",
      "examples": [
        0.6
      ]
    }
  }
}

Output schema

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