At a glance
- One vault per account, with three balances: gross, locked, and free.
- Totalis signs trades inside a secure enclave and can never extract your key. You can revoke the permission at any time.
- Your stake and the maker’s collateral lock in one atomic transaction when the maker confirms your trade.
- Network fees are sponsored. Your wallet only ever needs USDC.


Your vault
Your vault is persistent and reused across every parlay. It tracks three balances:
Read them any time from
GET /v1/vault. To fund the vault, send
USDC to your wallet (see Funding). Placing a parlay moves your stake into the
vault and locks it in one atomic step.
Delegated signing
Your wallet is a Privy embedded wallet. Its private key lives inside a Trusted Execution Environment, a secure enclave the key never leaves. Privy cannot extract it either. To trade, you grant Totalis permission to sign on your behalf inside that enclave. This is a one time consent in the app, described under Enable trading. While trading is enabled, Totalis can sign transactions for your wallet, including sending unlocked USDC. The API does that only for a withdrawal that you, or a key withfunds:withdraw, request.
You stay in control:
Gas is sponsored
Totalis pays the network fees (gas) for trading and settlement. Your wallet only ever needs to hold USDC, never SOL.How a position locks and settles
When the maker confirms your trade, your stake and the maker’s collateral lock together in a single atomic transaction. There is no window where one side is funded and the other is not. Settlement moves funds in exactly one of three ways:
The fee rate is written onto each position when it is created, so settlement always uses the rate
that applied at trade time. Both fees and the full math are on
Limits and fees.
What Totalis can and cannot do
Every vault, position, and settlement is on the Solana blockchain and independently verifiable. The
vault program is
58LfwWEnq1aCG2R18voCBF7zzJNtVSWquQBvdaaDFhme.
