03 · Wallet & accounts
Wallet & accounts
Your wallet, your accounts#
Your wallet is your own address. Money outside the venue stays in your own HyperCore account. Inside the venue, each account holds its own cash, its own positions and its own profit and loss; margin and liquidation read that account alone. A new wallet has no accounts: the first act that needs one opens it.
Nothing leaves your HyperCore wallet except an amount a button printed and you signed. Fees, holding costs and liquidations never reach into your wallet. Withdraw releases what the account does not need behind its positions, and goes back to your HyperCore wallet (daily limits in Fees & liquidation). When a Protect account closes, what is left of it is paid out to your Hyperliquid wallet.
Do this from your agent
Read your accounts
GET /chain/state?wallet=0x… returns your free cash and every account (OPTIONS, PROTECT, EARN) with its legs, perps, margin and value. Public and read-only: anyone can read any wallet's state, nobody can act for it without its signature.
curl -s "https://protect.temporal.exchange/api/venue/chain/state?wallet=0xYOUR_WALLET"Check the result yourself: positions and equity.
Three account kinds#
- Options — options you open on the Option tab, with no perp behind them.
- Protect — one perp and its one option swap, opened together.
- Earn — one maker's quoting (TLP or Custom) and the positions it builds up against traders. A wallet has one Earn account. A maker holds no perp unless it needs one to cover its margin.
A name is the kind and a number (Options 1, Protect 1, Earn 1), given once.
Margin: one closed form, summed per account#
Every sold option is margined per asset, as its oracle venue does it:
- BTC: to open, the larger of (15 % − how far out of the money) and 10 %, times spot, plus the option's mark; to hold, 7.5 % of spot plus the mark.
- HYPE: 30 % / 25 % to open, 18 % to hold, each plus the mark.
Bought options count as collateral at their mark. The mark is the oracle venue's price on the side you could close at — its bid for a bought option, its ask for a sold one — with broken quote points skipped. The legs add up per account.
Perps follow Hyperliquid per asset: BTC up to 40× (2.5 % to open, 1.25 % to hold), HYPE up to 10× (10 % / 5 %), on the account's whole equity including its options. In every account a perp covers sold options up to its size — a long perp the sold calls, a short perp the sold puts, on the same asset; only the net perp per coin counts — so only any excess is margined. That is what Back with: Perp on the Option tab's Sell ticket uses: the sale and a perp of the same size open together, and the perp's margin replaces most of the cash.
Protect: push your liquidation price away#
On the Protect tab you choose the asset, long or short, your margin and leverage. Then:
- Liq. price — where you want to be liquidated instead (type it or drag it on the chart). It is the real liquidation price, with the protection counted: where equity meets maintenance. The venue only offers a swap whose bought option starts paying out before that price is reached. If no such swap exists at your leverage, the ticket says "Can't protect at this leverage — try lower leverage or a nearer target" and opens nothing.
- Target price and Target ROE — where you think the price is going and the return you want there (the default is 90 % of what a plain perp at the same leverage would make).
- Days protected — a result, not an input: the days your margin covers the holding cost even at the most expensive price. For every price from the bought option's strike to the target, the spare margin there (equity, each option at its closeable side, less maintenance) ÷ the holding cost a day there, our fee included; the smallest. 0 means the bought option only starts protecting past your liquidation price. It is the worst case, at the highest holding cost: at today's price it lasts longer. Under 30 days you see ⚠; it is never refused for that alone.
The venue searches strikes × durations for the premium-neutral swap with the most edge (the return it keeps at the Target price over a less-levered perp with the same floor), among swaps lasting at least the days you type (30 if blank), that holds your Liq. price and gives the Target ROE at the Target price (see Execution programs): on a long it buys a put and sells a call (the reverse on a short). Neither leg is bigger than the perp; every leg is at least $1 of premium. If no swap can hold your Liq. price, you get the nearest one that can, with ⚠.
The perp and the swap open as one signed request: the perp fills on HyperCore and the contract opens both option legs in the same transaction, each from its single best maker, inside your slippage limits. If any part fails, everything is cancelled and your margin goes back.
curl -s -X POST https://protect.temporal.exchange/api/venue/perp/plan -H 'content-type: application/json' \
-d '{"side":1,"depositUSD":100,"lev":3,"asset":"BTC","target":52000,"sellFromRoe":1,"mode":"protect"}'Funding an account#
You need USDC in your own Hyperliquid (HyperCore) account. In the app, Deposit and Withdraw sit under each Portfolio section and move money straight from and to your Hyperliquid wallet. One signature moves it to the venue (HyperCore's usdSend to the address the venue serves — read it from /chain/deposits, never type it). A new wallet's first act is connect(); an account is opened by mintAccount(kind) (0 Options, 1 Protect, 3 Earn); deposit(account, usd) moves cash in. All are signed intents.
Do this from your agent
Fund an account
Every act is signed by your wallet and the venue pays the gas. Send USDC with a HyperCore transfer you sign and the venue forwards (POST /hypercore/relay with action, nonce, signature); GET /chain/deposits?wallet=0x… shows what has arrived. Then open and fund an account with signed ledger acts (connect, mintAccount, deposit) sent to POST /chain/intent with user, call, nonce (from GET /chain/nonce), deadline (at most 600 seconds ahead) and sig, an EIP-712 VenueIntent signature.
Check the result yourself: the venue's own money.
Kept in lockstep with the code: a check fails if this page drifts.