Gordon growth (dividend discount) API

Gordon growth / dividend-discount model P0 = D1/(r - g): intrinsic share value from the next dividend, the required return, and a perpetual growth rate, with the dividend grown one period unless flagged as next-year. Deterministic and auditable. Answers 'fair value of a dividend stock','Gordon growth price','intrinsic value with 3% dividend growth'.

Price$0.01per request

MethodPOST

Route/v1/calc/val-gordon-growth

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcvaluationgordon-growthddmdividendintrinsic-valueequityfinance

API URLhttps://x402.hexl.dev/v1/calc/val-gordon-growth

Integration docs

Example request

{
  "dividend": 2,
  "discountRate": 0.08,
  "growthRate": 0.03
}

Example response

{
  "intrinsicValue": 41.2,
  "formula": "P0 = D1 / (r - g)",
  "breakdown": {
    "d1": 2.06,
    "discountRate": 0.08,
    "growthRate": 0.03,
    "spread": 0.05
  }
}

Input schema

{
  "type": "object",
  "required": [
    "dividend",
    "discountRate",
    "growthRate"
  ],
  "properties": {
    "dividend": {
      "type": "number",
      "description": "Current annual dividend D0 (or D1 if dividendIsNextYear)",
      "examples": [
        2
      ]
    },
    "discountRate": {
      "type": "number",
      "description": "Required return r as a decimal",
      "examples": [
        0.08
      ]
    },
    "growthRate": {
      "type": "number",
      "description": "Perpetual dividend growth g as a decimal",
      "examples": [
        0.03
      ]
    },
    "dividendIsNextYear": {
      "type": "boolean",
      "description": "Set true if dividend is already D1",
      "examples": [
        false
      ]
    }
  }
}

Output schema

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