stability.settlement_window
Optimal settlement execution window analysis for a specific cross-border payment over the next 72 hours. Generates 18 × 4-hour time slots and scores each by composite risk: corridor stability, FX session liquidity, cascade level decay/growth based on macro outlook, weekend/off-hours penalty, and counterparty ESG tier (if LEI provided). Returns a ranked window schedule with OPTIMAL / GOOD / ACCEPTABLE / AVOID classification per slot, a best-window recommendation, and large-amount splitting guidance for settlements ≥ $5M. Use this before scheduling large cross-border settlements to minimize execution risk.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Destination currency ISO-4217 (e.g. "BRL"). | |
| lei | No | Optional 20-char GLEIF LEI of counterparty — fetches live ESG tier to apply counterparty risk penalty. | |
| from | Yes | Source currency ISO-4217 (e.g. "USD"). | |
| amount | No | Settlement amount (default 1,000,000). Used for large-amount guidance ≥$5M. | |
| currency | No | Currency of the amount (defaults to from). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| windows | No | 18 × 4-hour slots: startUtc, endUtc, compositeScore, tier, components, recommendation, rationale | |
| marketContext | No | globalOracleScore, corridorAdjustment, cascadeLevel, globalOutlook, regulatoryFlags | |
| recommendation | No | bestWindow (ISO datetime), bestScore, optimalCount, goodCount, summary, largeAmountNote |