Appearance
Settlement
What happens after you confirm an Intent — how and when funds are transferred.
Overview
Once you confirm an Intent, Ezys records an Execution Commitment on-chain and settlement begins. You don't need to manage settlement directly — Ezys coordinates with the liquidity sources and settlement partners to complete the transfer.
Your confirmed Intent includes the exact rate, output amount, and fees. These do not change during settlement.
Settlement Paths
Each confirmed Intent settles through one or more Legs — individual asset movements. The settlement path depends on the asset types involved.
| Asset type | Path | Timing |
|---|---|---|
| Crypto (USDC, etc.) | On-chain — smart contract execution | Near-instant |
| Fiat (KRW, USD, etc.) | Off-chain — partner settlement rails | Varies by partner and rail |
A typical Intent (e.g. USDC → KRW) involves two Legs: an on-chain outflow and an off-chain inflow.
Tracking Settlement
The Intent status reflects settlement progress:
| Status | What it means for you |
|---|---|
executing | Settlement is in progress — at least one Leg is being processed |
settled | All Legs completed — you have received (or your counterparty has received) the funds |
Poll GET /v1/intents/{intentId} to check the current status. The settlement.status and settlement.completedAt fields indicate when settlement finalized.
Settlement Preference
You can indicate a preference via the settlementPref constraint:
| Value | Behavior |
|---|---|
hybrid | Ezys selects the optimal settlement path (default) |
onchain | Prefer on-chain settlement where possible |
offchain | Prefer off-chain settlement where possible |
In most cases, hybrid is recommended. Ezys will choose the path that best balances speed and cost.
What You Don't Need to Manage
- Liquidity source selection — handled by the Solver Network
- Settlement coordination — handled by Ezys and its partners
- On-chain transactions — executed automatically via smart contracts
- Off-chain rail selection — determined by the settlement path
Your responsibility ends at confirming the Intent. Ezys handles everything from commitment to fund delivery.
Related
- Execution & Settlement (Core Concepts) — How settlement works under the hood
- Intent API — Full API reference