Convertible-note conversion calculator API

Implements the standard cap-vs-discount rule: accruedInterest = principal×rate×(months/12), conversionPrice = min(valuationCap/fullyDilutedShares, roundPrice×(1−discount)), sharesIssued = (principal+interest)/conversionPrice, and reports which method (cap or discount) won. Answers 'how many shares does this note convert into', 'what's the conversion price', 'does the cap or discount apply'.

Price$0.016per request

MethodPOST

Route/v1/score/litfin-convertible-note

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

scoreconvertible-noteventurecap-tableconversionvaluationstartupdilution

API URLhttps://x402.hexl.dev/v1/score/litfin-convertible-note

Integration docs

Example request

{
  "principal": 1000000,
  "interestRate": 0.06,
  "termMonths": 18,
  "valuationCap": 10000000,
  "discount": 0.2,
  "roundPricePerShare": 2,
  "fullyDilutedShares": 8000000
}

Example response

{
  "accruedInterest": 90000,
  "convertibleAmount": 1090000,
  "capPrice": 1.25,
  "discountPrice": 1.6,
  "conversionPrice": 1.25,
  "conversionMethod": "valuation-cap",
  "sharesIssued": 872000,
  "effectivePricePerShare": 1.25,
  "method": "conversionPrice=min(cap/FDshares, roundPrice×(1−discount)); shares=(principal+interest)/conversionPrice"
}

Input schema

{
  "type": "object",
  "required": [
    "principal",
    "interestRate",
    "termMonths",
    "valuationCap",
    "discount",
    "roundPricePerShare",
    "fullyDilutedShares"
  ],
  "properties": {
    "principal": {
      "type": "number",
      "examples": [
        1000000
      ]
    },
    "interestRate": {
      "type": "number",
      "description": "decimal annual",
      "examples": [
        0.06
      ]
    },
    "termMonths": {
      "type": "number",
      "examples": [
        18
      ]
    },
    "valuationCap": {
      "type": "number",
      "examples": [
        10000000
      ]
    },
    "discount": {
      "type": "number",
      "description": "0-0.9",
      "examples": [
        0.2
      ]
    },
    "roundPricePerShare": {
      "type": "number",
      "examples": [
        2
      ]
    },
    "fullyDilutedShares": {
      "type": "number",
      "examples": [
        8000000
      ]
    }
  }
}

Output schema

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