DocsAdvanced FeaturesLiquidity Modes
Liquidity Modes
SettleRamp supports two settlement models, giving partners flexibility in how liquidity is sourced and settled.
Default Settlement
In the default mode, Settle provides full liquidity management. Both the fiat and crypto legs of each transaction are executed by Settle, with no action required from the partner beyond initiating the order.
- Settle provides liquidity for every transaction
- Settle executes both fiat and crypto settlement legs
- Partner focuses on user experience and order creation
Partner-Provided Settlement
In partner-provided mode, the partner executes the liquidity leg of the transaction. Settle remains the orchestration and compliance layer, managing order lifecycle, KYC, and status transitions.
- Settle always manages fiat settlement
- Partner executes only the crypto transfer leg
- Settle handles orchestration, compliance, and order lifecycle
- Order status is still managed and reported by Settle
- Activated by passing
"settlementMode": "partner"on order creation
Note: Partner-provided settlement mode may evolve as the API matures. Contact the team for the latest configuration details.
Comparison
| Feature | Default | Partner-Provided |
|---|---|---|
| Liquidity source | Settle | Partner |
| Orchestration | Settle | Settle |
| KYC / Compliance | Settle | Settle |
| Settlement execution | Automatic | Partner-initiated |
| Webhook events | Standard | Standard + settlement events |