Forfaiting quality score & discounted price API

Forfaiting QUALITY score (0-100, higher = better) PLUS the canonical discounted purchase price of a receivable = faceValue/(1+discountRate)^years. Transparent rubric — avalGuarantorStrength 0.30, instrumentNegotiability 0.25, countryRisk 0.20 (inverted), tenorComfort 0.15 (inverted tenor risk), documentationCompleteness 0.10 — returns a quality bucket, an A-F grade, the discounted price, the discount, and a per-factor breakdown. Answers 'what's this forfaiting note worth today','rate this forfaiting deal'.

Price$0.016per request

MethodPOST

Route/v1/score/tradefin-forfaiting

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

scoreforfaitingdiscountreceivablestrade-financeavalrubricpresent-value

API URLhttps://x402.hexl.dev/v1/score/tradefin-forfaiting

Integration docs

Example request

{
  "faceValue": 1000000,
  "discountRate": 0.065,
  "years": 3,
  "avalGuarantorStrength": 0.85,
  "instrumentNegotiability": 0.8,
  "countryRisk": 0.4,
  "tenorRisk": 0.5,
  "documentationCompleteness": 0.9
}

Example response

{
  "qualityScore": 74,
  "rating": "strong",
  "grade": "C",
  "discountedPurchasePrice": 827849.09,
  "discount": 172150.91,
  "breakdown": [
    {
      "factor": "avalGuarantorStrength",
      "value": 0.85,
      "weight": 0.3,
      "contribution": 25.5
    },
    {
      "factor": "instrumentNegotiability",
      "value": 0.8,
      "weight": 0.25,
      "contribution": 20
    },
    {
      "factor": "countryRisk",
      "value": 0.6,
      "weight": 0.2,
      "contribution": 12
    },
    {
      "factor": "tenorComfort",
      "value": 0.5,
      "weight": 0.15,
      "contribution": 7.5
    },
    {
      "factor": "documentationCompleteness",
      "value": 0.9,
      "weight": 0.1,
      "contribution": 9
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "faceValue",
    "discountRate",
    "years",
    "avalGuarantorStrength",
    "instrumentNegotiability",
    "countryRisk",
    "tenorRisk",
    "documentationCompleteness"
  ],
  "properties": {
    "faceValue": {
      "type": "number",
      "examples": [
        1000000
      ]
    },
    "discountRate": {
      "type": "number",
      "description": "annual discount rate as decimal",
      "examples": [
        0.065
      ]
    },
    "years": {
      "type": "number",
      "examples": [
        3
      ]
    },
    "avalGuarantorStrength": {
      "type": "number",
      "examples": [
        0.85
      ]
    },
    "instrumentNegotiability": {
      "type": "number",
      "examples": [
        0.8
      ]
    },
    "countryRisk": {
      "type": "number",
      "examples": [
        0.4
      ]
    },
    "tenorRisk": {
      "type": "number",
      "examples": [
        0.5
      ]
    },
    "documentationCompleteness": {
      "type": "number",
      "examples": [
        0.9
      ]
    }
  }
}

Output schema

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