settlement.quote
Get a binding fee quote for a DPX settlement. Returns core fee (1.50%), FX fee (0.40% cross-currency), live ESG fee (0–0.50%), license fee (0.01%), total all-in rate, net amount, oracle status, AI reasoning, and a quoteId valid for 300 seconds. Always call this before settlement.execute.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lei | No | Counterparty LEI — triggers automatic ESG lookup if esgScore is not provided. | |
| hasFx | No | True if source and destination currencies differ (adds 0.40% FX fee). | |
| esgScore | No | Counterparty ESG score 0–100. If omitted and lei or counterpartyName is provided, the ESG Oracle is queried automatically. | |
| amountUsd | Yes | Settlement amount in USD. | |
| counterpartyName | No | Counterparty company name — used for ESG auto-lookup if lei is not provided. | |
| monthlyVolumeUsd | No | Monthly volume for discount tier. $1M+ = Institutional (20% off). $10M+ = Sovereign (30% off). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fees | No | ||
| tier | No | Volume tier: Standard | Growth | Institutional | Sovereign | |
| quoteId | No | Binding quote ID, valid 300 seconds | |
| amountUsd | No | Input settlement amount in USD | |
| expiresAt | No | ISO 8601 expiry timestamp | |
| reasoning | No | AI reasoning for fee calculation | |
| oracleScore | No | Oracle confidence 0–100 | |
| netAmountUsd | No | Net amount after all fees | |
| oracleStatus | No | STABLE | CAUTION | UNSTABLE |