Skip to main content

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>
FlagDescription
-m, --mintAsset mint to deposit
-a, --amountAmount 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.