About Diffusal
On-chain options protocol with portfolio margin and deterministic settlement
Welcome to the Diffusal documentation.
Diffusal is an on-chain options protocol designed around three principles:
- Deterministic pricing and settlement using on-chain math
- Portfolio-aware risk management with explicit initial and maintenance margin
- Composable integrations where clients can read from API data and submit writes directly on-chain
Getting Started
Choose your path based on how you'll interact with Diffusal:
For Traders
Connect your wallet, deposit collateral, and start trading options. Step-by-step guides for every workflow.
For Integrators
Build on top of Diffusal using the REST API, WebSocket streams, and on-chain contract calls.
Dashboard Users
API-first dashboard for market makers, bot operators, and power users managing positions programmatically.
Core Capabilities
- Black-Scholes Pricing with Greeks for quoting and risk checks
- Event-based Order Book with off-chain matching and on-chain settlement
- RFQ Execution for signed quotes with partial fills
- Portfolio Margin with multi-portfolio support per user
- Liquidation + Settlement Readiness flows for solvency and expiry safety
- TWAP Settlement Inputs via on-chain snapshot history
Protocol Components
- Pricing:
DiffusalOptionsQuoter,DiffusalOracle - Trading:
DiffusalOptionsOrderBook,DiffusalOrderBookAuth,DiffusalOrderBookCoordinator,DiffusalOrderBookExecutor,DiffusalOptionsRFQ,DiffusalRfqExecutor - Position State:
DiffusalOptionsSeriesRegistry,DiffusalOptionsPositionManager,DiffusalPortfolioManager - Risk & Settlement:
DiffusalCollateralVault,DiffusalSettlementEngine,DiffusalLiquidationEngine,DiffusalSettlementReadinessLiquidator,DiffusalInsuranceFund,DiffusalPriceHistory - Helper Contracts:
DiffusalMarginCalculator,DiffusalLiquidationCalculator,DiffusalSettlementReadinessCalculator