⛨ SUP · Docs

Sup Agent (AI CFO)

Sup Agent is the assistant built into Sup Wallet — your on-chain AI CFO. You talk; it drafts; you sign. It can read live markets, analyze a chart like a desk trader, build and backtest a strategy, and — within the allowances you set — actually trade, earn, and move funds from your vault. No seed phrase ever changes hands.

Two different "agents", don't mix them up. This page is the Sup Agent that ships inside the wallet (you chat with it). Build an agent is the opposite direction: giving your own external agent the marketplace tools. Same keyless spirit, different audience.

#Why it exists

A wallet makes you the bottleneck — every pay, swap, lend, or rebalance funnels into one human pressing Sign. The only way to "automate" today is to hand an agent your seed and pray. Sup Agent removes both problems:

  • Talk-to-act. "swap 10 SUI to USDC and lend it on Scallop" becomes a single atomic PTB — you review a card and approve. No hunting through five protocol UIs.
  • It never holds your keys. Owner actions (deposit/withdraw, subscribe) you sign in your own wallet. Protocol actions are drafted by onchain-tools-service and remain owner-signed until the policy-bounded TEE-Signer path is production-ready.
  • Research and execution in one place. The same chat that draws the chart can open the trade — analysis flows straight into a bounded action.

#How it works (the trust path)

  you (prompt)  ──▶  Sup Agent  ──▶  drafts a card  ──▶  you approve
                        │                                    │
                        │ owner action (deposit/subscribe) ──┘ you sign in your wallet
                        │
                        └ protocol action ── onchain-tools drafts unsigned bytes
                                             └ owner signs today; TEE later

The browser talks to POST /api/agent/chat; the model API key stays server-side. Every fund movement surfaces as a Run card you click — and an order auto-runs only when it's under your auto-run-under-$X threshold. See the live caps any time at POST /api/agent/caps.

#Gas sponsorship

Agent access is paired with sponsored transactions. A separate sponsor account pays gas from its SIP-58 address balance, while the transaction's policy and signing authority remain independently enforced. Users do not fund or reclaim gas from an Agent key. Operators monitor sponsor runway and sponsored-transaction activity from the Admin Gas Sponsor panel.

#What it can do

Wallet & vault — create a vault, deposit/withdraw, read balances & holdings, decode a tx digest into plain English, resolve .sui names, set/inspect agent caps.

Trade & earn (executed from the vault, bounded by caps) — spot swaps routed through the best of Cetus Aggregator V3 / Aftermath / 7K; lending on Scallop, NAVI and Suilend; borrowing & savings on Bucket; liquid staking on Haedal; yield vaults on Ember; and runAgentCompose to chain several of these into one atomic PTB (e.g. swap → lend). It can also build you-signed positions funded from the vault — Cetus CLMM/DLMM liquidity and the Typus options vault (DOV). Full matrix: Trading & perps.

Perpetuals across venues — real, executable perps on Bluefin (managed agent key), DeepBook (on-chain, self-custody, you sign), Astro (off-chain, key-gated), and Aftermath (on-chain, you sign). Full matrix: Trading & perps.

Research, charts & TA — live prices, a narrated multi-timeframe SMC walkthrough that draws structure (FVG / order blocks / liquidity / Fibonacci) on real candles, plus derivatives (OI / funding / CVD), smart-money positioning, corporate treasury (DAT) holdings, Fear & Greed, market heatmap, macro pulse, DeFi TVL/yields, and de-duplicated news + exchange-listing alpha. It's cross-asset: it analyzes stocks, ETFs, FX and commodities too (analysis-only — the wallet trades Sui).

Quant & portfolio — turn a rule into a backtest on real candles, write a full SupScript strategy, or build & backtest a target allocation.

Deep Research mode — runs a full multi-tool pipeline and synthesizes one structured Trading Report (verdict, thesis, trade plan, catalysts, risks).

Supported protocol actions — discover and prepare the integrations exposed by the Agent Service and on-chain tools service. The retired permissionless Marketplace is not an execution or publishing surface.

Hire another agent (escrow) — hireAgent opens an assessor-gated escrow job: it funds from your vault under your cap (confirm_spend_into), the provider delivers, and you (the assessor) approve to release or reject to refund. Track jobs in chat or on the Jobs page. This is the agent-economy settlement leg — funding is a policy rule, releasing is an assessor.

Service and policy discovery are separate: provider/agent-service discovery identifies who an agent may hire; an assessor lists in the policy-rule registry tagged assessor so an owner can find a settlement rule to trust. A provider learns about a job by indexing the on-chain JobCreated event (GET /api/escrow/jobs?provider=).

A2A interop. Sup exposes an Agent Card (the A2A /.well-known/agent.json standard) describing this agent's escrow skills + endpoints, and a POST /api/a2a handshake endpoint. Another agent negotiates a task there; the chain settles — the agreement becomes an assessor-gated escrow job, watched via JobCreated. A2A coordinates, 8183 settles. (Preview: the handshake surface is live; full task-lifecycle streaming is roadmap.)

#Try these

"what's SUI doing today — walk me through the daily and 4h"
"swap 25 USDC to SUI, best route"
"swap 1 SUI to USDC and lend it on Scallop in one transaction"
"long BTC 5x on Bluefin"
"backtest: buy RSI<30, sell RSI>55 on SUI, 1h"
"deep research ETH"          ← turn on Deep Research for a full Trading Report
"show the supported Sui lending protocols"

#Safety model

  • Draft-and-sign. Owner actions are signed by you; nothing moves without a card you approve.
  • Typed, revocable allowances. The managed agent key spends only within your per-service and per-coin caps, can never withdraw, and one tx revokes it. Perp keys are trade-only.
  • Research ≠ execution. Charts, reports and portfolios are framed as research, not advice — and never auto-trade.
  • Auditable. An in-app Activity ledger reconstructs what the agent (and you) actually did — inferred action (swap / sent / received), net per-coin movement, status and an explorer link — so you can review a session without leaving for a block explorer.
  • Bring your own model. Routed through ClawRouter by default; set a Gemini key to use your own. Either way the key stays on the server, never the browser.

The agent is on a plan gate — where a paywall is configured, a wallet needs an active plan. Some venues are mainnet-only; the agent says so rather than failing silently.

#Take the playbook with you

The whole CFO methodology — the tools, the order to call them, the guardrails — is packaged as the installable sup-cfo skill, so any coding agent can run the same flow. It lives in the repo at skills/sup-cfo/SKILL.md. See SDK / CLI / MCP → Skills.

Next: Trading & perps · Strategy script · Delegation policy.

← QuickstartTrading & perps →