After-tax & taxable-equivalent yield API

Compute after-tax yield = yield x (1 - rate) for a taxable bond, or the taxable-equivalent yield (TEY) = tax-free yield / (1 - rate) for a muni, returning the converted yield and an interpretation. Answers 'after-tax yield of a 5% bond at 32%','taxable-equivalent yield of a 4% muni','is a muni or taxable bond better for me','TEY at my tax rate'.

Price$0.01per request

MethodPOST

Route/v1/calc/tax-after-tax-yield

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

taxafter-tax-yieldteymunibondsyieldinvestingcalc

API URLhttps://x402.hexl.dev/v1/calc/tax-after-tax-yield

Integration docs

Example request

{
  "yield": 0.05,
  "taxRate": 0.32
}

Example response

{
  "mode": "after-tax",
  "grossYield": 0.05,
  "grossYieldPercent": 5,
  "taxRate": 0.32,
  "afterTaxYield": 0.034,
  "afterTaxYieldPercent": 3.4,
  "interpretation": "A 5% gross yield nets 3.4% after a 32% tax.",
  "note": "Estimate. After-tax yield = gross yield x (1 - marginal rate)."
}

Input schema

{
  "type": "object",
  "required": [
    "yield",
    "taxRate"
  ],
  "properties": {
    "yield": {
      "type": "number",
      "description": "Yield as a decimal, e.g. 0.05 for 5%",
      "examples": [
        0.05
      ]
    },
    "taxRate": {
      "type": "number",
      "description": "Marginal tax rate as a decimal 0-1",
      "examples": [
        0.32
      ]
    },
    "taxFree": {
      "type": "boolean",
      "description": "True to compute taxable-equivalent yield for a tax-free yield",
      "examples": [
        false
      ]
    }
  }
}

Output schema

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