Command Reference
Global options (--keypair, --rpc, --backend, --transport) apply to
every command — see configuration. Amounts are always in
native units (the asset's smallest unit). Missing flags are prompted for
interactively.
Vault management
Your escrow vault is where the protocol takes premiums, collateral, and settlement from — fund it before trading.
overcast deposit
Deposit funds into your protocol escrow vault.
overcast deposit --mint <mint> --amount <n>
| Flag | Description |
|---|---|
-m, --mint | Asset mint to deposit |
-a, --amount | Amount in native units |
Calls app.chain.deposit and prints the transaction hash. Your wallet must
already hold the SPL tokens — the CLI does not mint or airdrop.
overcast withdraw
Withdraw funds from your escrow vault back to your wallet.
overcast withdraw --mint <mint> --amount <n>
Same flags as deposit; calls app.chain.withdraw.
overcast balance
Show an escrow vault balance.
overcast balance --mint <mint> [--user <address>]
--user inspects someone else's vault (defaults to your wallet; with
--user no keypair is needed).
Discovery
overcast assets
List the backend's supported asset allowlist — the mints you can trade and their metadata. Start here.
overcast offer list / overcast offer show
Browse open collateral/settlement offers, or look one up by ID.
overcast offer list [--kind collateral|settlement] [--party <id>] [--asset <id>] [--limit <n>]
overcast offer show --id <offer-id>
overcast option list / overcast option show
Browse curated market options, or show one option's terms and live claim state. An option is identified by its offer ID pair:
overcast option list [--maker <id>] [--taker <id>] [--asset <id>] [--limit <n>]
overcast option show --collateral-offer <id> --settlement-offer <id>
Trading
overcast rfq create
The interactive RFQ flow: pick a strategy (covered call / cash-secured put),
underlying, cash asset, quantity, strike, and expiry; the CLI broadcasts the
RFQ on the MAKER side, streams incoming quotes live, and settles your
chosen quote on-chain — printing the resulting option ID and transaction.
overcast rfq create
overcast accept
Manually match a collateral offer and a settlement offer to mint an option (the non-RFQ path):
overcast accept --collateral-offer <id> --settlement-offer <id>
Option lifecycle
overcast exercise
Exercise an option you hold as taker: burn exercise-claims to swap settlement assets for the locked collateral.
overcast exercise --collateral-offer <id> --settlement-offer <id> [--amount <n>]
The CLI looks up the option, shows your remaining exercise-claims, caps the
prompted amount at that balance, asks for confirmation, and calls
app.chain.exerciseOption. Partial exercise is fine — claims are fungible.
overcast redeem
Redeem as maker: burn collateral-return claims to pull your collateral (plus any settlement paid in by exercises) back out.
overcast redeem --collateral-offer <id> --settlement-offer <id> [--amount <n>]
Mirror of exercise, calling app.chain.redeemOption.
RFQ quoting
overcast quote
Run an auto-quoter against incoming RFQs — either the built-in Black-Scholes pricer or your own strategy behind a webhook:
overcast quote [--spread 0.02] [--vol 0.8] [--rate 0] \
[--webhook-url <url>] [--webhook-timeout 5000]
Covered in depth in RFQ Quoting.