Trade finance risk score API

Composite trade-finance counterparty RISK score (0-100, higher = riskier) via a transparent weighted rubric — countryRisk 0.30, buyerCreditRisk 0.30, tenorRisk 0.15, currencyRisk 0.10, goodsLiquidityRisk 0.10, documentationRisk 0.05 — returning a low/moderate/high/very-high bucket, an A-F grade, and a per-factor contribution breakdown so underwriting is auditable. Answers 'how risky is this trade finance deal','score this cross-border buyer exposure'.

Price$0.016per request

MethodPOST

Route/v1/score/tradefin-trade-finance-risk

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

scoretrade-financeriskunderwritingcounterpartystructured-financerubriccredit

API URLhttps://x402.hexl.dev/v1/score/tradefin-trade-finance-risk

Integration docs

Example request

{
  "countryRisk": 0.35,
  "buyerCreditRisk": 0.4,
  "tenorRisk": 0.3,
  "currencyRisk": 0.2,
  "goodsLiquidityRisk": 0.25,
  "documentationRisk": 0.15
}

Example response

{
  "riskScore": 32.25,
  "rating": "moderate",
  "grade": "D",
  "breakdown": [
    {
      "factor": "countryRisk",
      "value": 0.35,
      "weight": 0.3,
      "contribution": 10.5
    },
    {
      "factor": "buyerCreditRisk",
      "value": 0.4,
      "weight": 0.3,
      "contribution": 12
    },
    {
      "factor": "tenorRisk",
      "value": 0.3,
      "weight": 0.15,
      "contribution": 4.5
    },
    {
      "factor": "currencyRisk",
      "value": 0.2,
      "weight": 0.1,
      "contribution": 2
    },
    {
      "factor": "goodsLiquidityRisk",
      "value": 0.25,
      "weight": 0.1,
      "contribution": 2.5
    },
    {
      "factor": "documentationRisk",
      "value": 0.15,
      "weight": 0.05,
      "contribution": 0.75
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "countryRisk",
    "buyerCreditRisk",
    "tenorRisk",
    "currencyRisk",
    "goodsLiquidityRisk",
    "documentationRisk"
  ],
  "properties": {
    "countryRisk": {
      "type": "number",
      "description": "country/political risk, 0=safe 1=severe",
      "examples": [
        0.35
      ]
    },
    "buyerCreditRisk": {
      "type": "number",
      "description": "buyer default risk, 0-1",
      "examples": [
        0.4
      ]
    },
    "tenorRisk": {
      "type": "number",
      "description": "tenor/duration risk, 0-1",
      "examples": [
        0.3
      ]
    },
    "currencyRisk": {
      "type": "number",
      "examples": [
        0.2
      ]
    },
    "goodsLiquidityRisk": {
      "type": "number",
      "examples": [
        0.25
      ]
    },
    "documentationRisk": {
      "type": "number",
      "examples": [
        0.15
      ]
    }
  }
}

Output schema

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