Physical Options
Create physically settled options through the RFQ system — at expiry, the underlying asset is delivered rather than cash being paid out.
Overview
Physical options involve actual delivery of the underlying asset at expiry rather than a cash settlement based on price difference. They are only available for vanilla (single-strike) options. Multi-leg structures (spreads, butterflies, condors) are cash-settled only.
Physical PUT
USDC (strike × contracts)
WETH (contracts)
USDC (strike × contracts)
Physical CALL
WETH (contracts)
USDC (strike × contracts)
WETH (contracts)
Creating a Physical PUT RFQ
A physical PUT means: "I want to sell WETH at strike price." If the option expires ITM, the buyer delivers WETH and receives USDC at the strike price.
import { ethers } from 'ethers';
import { ThetanutsClient } from '@thetanuts-finance/thetanuts-client';
const provider = new ethers.JsonRpcProvider('https://mainnet.base.org');
const signer = new ethers.Wallet(process.env.PRIVATE_KEY!, provider);
const client = new ThetanutsClient({ chainId: 8453, provider, signer });
const userAddress = await signer.getAddress();
const keyPair = await client.rfqKeys.getOrCreateKeyPair();
// Next Friday 8:00 UTC (Deribit-compatible expiry)
const now = new Date();
const daysUntilFriday = (5 - now.getUTCDay() + 7) % 7 || 7;
const nextFriday = new Date(Date.UTC(
now.getUTCFullYear(), now.getUTCMonth(),
now.getUTCDate() + daysUntilFriday,
8, 0, 0
));
const nextFridayExpiry = Math.floor(nextFriday.getTime() / 1000);
// SELL Physical PUT: "I want to buy ETH at $2500"
// If ETH falls below $2500, you receive ETH at your target price
const physicalPutRFQ = client.optionFactory.buildPhysicalOptionRFQ({
requester: userAddress as `0x${string}`,
underlying: 'ETH',
optionType: 'PUT',
strike: 2500,
expiry: nextFridayExpiry,
numContracts: 0.1,
isLong: false, // SELL — you post USDC collateral
deliveryToken: client.chainConfig.tokens.WETH.address as `0x${string}`,
collateralToken: 'USDC', // Auto-inferred for PUT: USDC
offerDeadlineMinutes: 6,
reservePrice: 0.0001,
requesterPublicKey: keyPair.compressedPublicKey,
});
// Verify the implementation is PHYSICAL_PUT (not regular PUT)
console.log('Implementation:', physicalPutRFQ.params.implementation);
// Should match: client.chainConfig.implementations.PHYSICAL_PUT
// extraOptionData contains the ABI-encoded delivery token address
// (non-empty '0x' distinguishes physical from cash-settled)
console.log('extraOptionData:', physicalPutRFQ.params.extraOptionData);
// For SELL: approve USDC collateral (strike × numContracts)
const collateral = BigInt(Math.round(2500 * 0.1 * 1e6)); // 250 USDC
await client.erc20.ensureAllowance(
client.chainConfig.tokens.USDC.address,
client.optionFactory.contractAddress,
collateral
);
const receipt = await client.optionFactory.requestForQuotation(physicalPutRFQ);
console.log('Physical PUT RFQ TX:', receipt.hash);Creating a Physical CALL RFQ
A physical CALL means: "I want to sell WETH above strike price." If the option expires ITM, the seller delivers WETH and receives USDC at the strike price.
Calculation Functions
The SDK exports standalone helpers for physical option math:
Physical Option Product Table
PHYSICAL_CALL
numContracts WETH
strike × numContracts USDC
PHYSICAL_PUT
strike × numContracts USDC
numContracts WETH
PHYSICAL_CALL_SPREAD
width × numContracts WETH
width × numContracts USDC
PHYSICAL_PUT_SPREAD
width × numContracts USDC
width × numContracts WETH
For BTC-underlying options, substitute cbBTC for WETH.
Collateral vs Delivery
Physical options involve two distinct asset transfers:
Collateral
Seller
At settlement
Posted to secure the option payout
Delivery
Buyer (if exercised)
At ITM expiry
Asset exchanged for collateral
For Physical PUT: Seller posts USDC (collateral); if ITM, buyer delivers WETH and receives USDC
For Physical CALL: Seller posts WETH (collateral); if ITM, buyer delivers USDC and receives WETH
If the option expires OTM, no delivery occurs and the seller's collateral is returned in full.
Limitations
Physical settlement is available for vanilla (single-strike) options only
Multi-leg structures (spreads, butterflies, condors) are cash-settled
The
deliveryTokenaddress must be passed inbuildPhysicalOptionRFQand is ABI-encoded intoextraOptionData
See Also
Create an RFQ — General RFQ creation (cash-settled vanilla and multi-leg)
Multi-Leg Structures — Spreads, butterflies, condors (cash-settled only)
RFQ Lifecycle — Full lifecycle from creation to expiry
Last updated

