Open, close and manage a position
> Local V11 math and House checks have passed; this version is not deployed. Release validation is separate. These Docs do not change the terms of existing positions.
A position has one collateral asset, one market, one direction and its own margin. USDC positions settle in USDC. OH positions settle in OH. The protocol keeps their pools and liabilities separate.
Only isolated margin is supported. Each position has its own margin and liquidation risk. Other positions, available funds, unrealized profit and unpaid claims do not automatically cover it. Only funded proceeds credited to the account may be reused.
Order limits
| Setting | USDC collateral | OH collateral |
|---|---|---|
| Minimum margin | 5 USDC | 100 OH |
| Public relay minimum order value | 1,000 USDC | 100,000 OH |
| Leverage range | 1×–1000× | 1×–1000× |
| Accounting precision | 6 decimals | 6 decimals |
Order value, or notional, is margin multiplied by leverage. OH entry in the standard ticket uses whole tokens; the protocol ledger keeps micro-OH precision. A market can impose stricter settings, so check the live ticket. The current initialization has no universal 10-million-dollar order cap.
Examples: 10 USDC × 100 = 1,000 USDC; 100 OH × 1000 = 100,000 OH. Both meet the public relay minimum. Five USDC at 100× gives only 500 USDC of notional, which the public relay rejects.
Choose your exposure
A long benefits from a rising accepted price and a short from a falling one. Profit uses the locked pressure and hourly coefficients together with price movement, holding time, leverage and return. V11 has no shared closing budget or fixed four-times-margin profit ceiling. Cash availability affects payment timing, not the confirmed entitlement. See PnL.
Crowding or directional imbalance alone does not reject an otherwise valid order. This order's own pressure is included before its retention is locked; later crowding does not retroactively worsen that value.
The trade screen shows an estimated pressure retention q = exposure / notional. Execution selects and locks the actual value, so the preview can change before the fill. q is not a net return or a promise to keep that share of raw profit: price-move, holding-time, leverage, ROI and small-move adjustments and fees still apply. The website defaults to minExposure = 0, so a change in this preview alone does not reject an otherwise valid open. An API caller can choose a signed nonzero floor, which can reject the order if it is not met.
This V11 build supports fresh deployments only. Its changed account discriminators and layouts must be decoded with the matching release's sdk/idl/perp.json and SDK; legacy accounts cannot be reinterpreted or upgraded in place by this build. The intent wire version is separate from the account ABI.
What stays fixed
Opening stores margin, leverage, entry price, liquidation terms, the pressure-adjusted exposure and the selected D in parts per billion (ppb), with a V11 interpretation marker. The UTC bucket is selected from the opening timestamp; a separate hourly-table manifest is not stored in each position. Later table updates do not reprice it. Changing size or leverage requires closing and reopening.
You can hold opposite directions at the same time. A two-leg strategy needs enough collateral and rent for both legs; the legs are independent positions with their own execution and liquidation outcomes.
Execution and pending orders
Signed actions use the relay and keeper; the supported intent route can combine a valid quote and execution in one chain transaction. The Request route remains available. The standard interface opens and closes at market. Persistent low-level limit orders use Requests; a limit close is a price trigger followed by market execution, not a guaranteed target-price fill. Pending opens reserve margin and required rent. Cancel the unfilled order to release its recorded reservations. A close with an existing conditional close first cancels it and waits for confirmation. If interrupted, reconcile the original signed action before retrying. Quote validity, expiry, retirement, liquidation and fixed settlement rules still apply; there is no promise of execution.
Closing
Close one position or submit a group; groups can require multiple transactions. Surviving margin and paid profit return to the matching collateral balance, while unpaid profit remains a separate claim. Position rent returns to its recorded payer. Confirm the account result before reusing funds.
Once price crosses a stored liquidation threshold, settlement follows the liquidation rules, including when the original action was a voluntary close.