SUP · Docs

Trading & perps

Sup turns "I want to be long SUI" into a bounded, signable action — spot, lending, or leverage — and routes it to the right venue. Everything runs through the Sup Agent (talk-to-act) or the in-app Strategy Studio, and every venue keeps the same promise: you stay in custody, allowances bound every move.

#Spot & earn

Most of these execute from your vault via the managed agent key, capped by the allowances you granted. The two marked you sign build a transaction your own wallet signs (optionally funded from the vault in the same PTB) — used where the position lives in an object you hold:

ActionVenueSigning / notes
SwapCetus Aggregator V3 / Aftermath / 7Kagent key · best multi-hop/split route; only pulls the source coin
Lend / earnScallop, NAVI, Suilendagent key · deposit the underlying, hold the receipt (sCoin / cToken) in the vault
Borrow / savingsBucketagent key · borrow USDB against collateral, or earn on USDB
Liquid stakeHaedalagent key · SUI ⇄ haSUI
Yield vaultEmber, Typus DOVEmber = agent key; Typus DOV (options vault) = you sign; both vault-fundable
Provide liquidityCetus CLMM & DLMMyou sign · open an LP position (DLMM seeds a band of price bins), optionally vault-funded
Composethe agent-key actions abovechain swap → lend in one atomic PTB (runAgentCompose)

Always checkSwapRoute before a swap — it returns both routability and whether the coin is authorized; if not, the agent renders a one-click Authorize card first.

#Perpetuals — four venues, one chat

Leverage is venue-specific in who signs and how funds custody. The agent picks sensibly, or you can name a venue. The trade-off matrix:

VenueCustody / signingSetupStatus
Bluefinoff-chain; managed agent key signs (never withdraws)instant agent-key authorizelive, mainnet
DeepBookon-chain margin (Sui CLOB); you sign every orderone-time MarginManagerlive, mainnet
Aftermathon-chain perps; you signneeds an AccountCaplive, mainnet
Astro (NAVI)off-chain; HMAC key server-side (trade-only)apply → 1–2 day manual key reviewlive, mainnet
openPerplocal preview onlypreview (OS-account engine not live)

Rules of thumb: Bluefin for the smoothest managed perp; DeepBook when you want fully on-chain self-custody; Astro only if you asked for it (it's gated behind a key review); openPerp shows the full ticket flow but doesn't open a real position — be aware which is which.

#The Bluefin flow (three steps, the agent drives it)

  1. checkBluefinReadiness — account setup only (Mainnet → Sup vault → managed agent key → authorized on Bluefin). Renders a linear setup card you tap through.
  2. checkBluefinMargin — surveys every coin you hold and funds the USDC shortfall from where your money actually is (deposit, or swap a held coin → USDC).
  3. runBluefinPerp — places it. Auto-runs under your safety threshold; otherwise a one-tap Run card.

#Strategy Studio

The in-app studio is where a strategy goes from idea → backtest → live across venues:

  • Design the rules declaratively, or write a full SupScript program (MACD / Bollinger / ATR, both long & short, references to prior bars).
  • Backtest on real candles — return vs buy & hold, APY, max drawdown, win rate, profit factor, Sharpe, equity curve (POST /api/strategy/backtest).
  • Generate a starting strategy from a plain-English description (POST /api/strategy/generate-script), then refine.
  • Chart-trade directly. Hover the live chart to stage a limit order at that price and set take-profit / stop-loss there; drag the TP/SL lines to retune; switch timeframes (1m → 1d, incl. 5m/15m); and watch your live open orders on the candles.
  • Run the resulting plan against the perp venues above.

#Use cases

  • Daily-capped trading bot. Grant the agent 50 SUI/day on one DEX; revoke in one tx. The key can never exceed the cap or touch coins outside its sandbox.
  • One-tap swap-and-lend. Tap once: swap on Cetus → deposit to Scallop, atomic — if the lend leg fails, the swap reverts with it.
  • Research → position. Ask for a multi-timeframe read, then "open that long on Bluefin" — the chart's levels carry into the ticket.
  • Self-custodial leverage. Margin-trade SUI on DeepBook where you sign every order and no external account ever holds your funds.

Trading, backtests and reports are research/education, not financial advice. Past performance does not predict future results, and leverage can liquidate you.

Next: Sup Agent · Strategy script · Delegation policy (cap what a trading delegate can do).