Skip to main content

Wallets Management

Manage all connected wallets — Privy, MetaMask, WalletConnect, external — in one place.

Find it at: /account/wallets.

Wallets list


1. Wallets list view

The Wallets page lists every wallet bound to your Alphio account in a single table.

Each row exposes:

ColumnWhat it shows
SourceWhere the wallet came from — see source table below.
LabelA friendly name you set (defaults to a short address).
Address0x-prefixed Ethereum-style address, lower-cased and truncated for display.
Default flagA pin / star icon marks the wallet used as the default by the Trade Modal.
Created atWhen the wallet was added to your account.

The four wallet sources Alphio tracks:

SourceWhat it means
PrivyAn embedded wallet created by Alphio via Privy. Private key custodied in a Privy iframe — you can export it (see section 6).
MetaMaskA browser-extension wallet you connected. Private key stays in MetaMask.
WalletConnectA wallet (mobile or hardware) you paired via the WalletConnect protocol.
ExternalA wallet address you imported by entering it manually — read-only address binding, no signing capability on Alphio's side.

2. Adding a wallet

To add a wallet, follow the dedicated guide: /get-started/connect-on-chain.

In short, the Wallets page provides three add flows:

  • Create with Privy — Alphio provisions an embedded wallet for you. No seed phrase to remember; private key lives in Privy's iframe.
  • Connect MetaMask / WalletConnect — sign a message with an existing wallet to prove ownership.
  • Import external — paste an address to track it (read-only).

Newly added wallets land at the bottom of the list. Set one as default (section 4) to make it the Trade Modal's default order signer.


3. Renaming a wallet

Click the label of any row to edit. Press Enter or click the check mark to save.

  • Labels are free-text up to a reasonable length, and only visible to you.
  • Labels are server-side HTML-escaped, so emoji and Unicode are safe.
  • Renaming has no effect on signing, balances, or any on-chain state — it's a pure UI annotation.

4. Setting the default wallet

Exactly one wallet on your account is marked default at any time. The default wallet is:

  • The wallet pre-selected when you open the Trade Modal for Hyperliquid Perpetuals or Prediction Markets.
  • The wallet used by Auto Trade and Agentic Trading rails when they need to sign on your behalf (subject to per-strategy overrides).
  • The wallet whose balance shows in the top nav's wallet pill.

To change default: click the pin / star icon on any other wallet row. The previous default becomes a regular wallet.

External (read-only) wallets cannot be set as default — they can't sign.


5. Removing a wallet

The trash icon removes a wallet from your Alphio account. Read this carefully — the consequences depend on the wallet source.

SourceEffect of remove
PrivyThe wallet is unlinked from Alphio. The private key is custodied by Privy; export your key first (section 6) if you want to retain access — otherwise you may lose the ability to sign with it.
MetaMask / WalletConnectPure unlink — Alphio forgets the address. Your wallet itself is unaffected; reconnect anytime.
ExternalPure unlink. The on-chain address is unchanged.

Side effects on bound services:

  • Hyperliquid bind — if the removed wallet was bound to Hyperliquid for perp trading, the bind is invalidated. Re-bind from /get-started/connect-on-chain to resume perps.
  • Auto Trade / Agentic Trading strategies — any strategy whose signer was this wallet will pause until you re-assign a signer.
  • Default flag — if you remove the default wallet, Alphio promotes another wallet to default automatically. You can change it again in section 4.

6. Export private key (Privy wallets only)

Privy-created wallets support private key export. Click Export Key on a Privy row and Privy will open its own secure modal (rendered in an isolated iframe) showing the private key.

Wallet sourceExport supported
PrivyYes — via Privy modal
MetaMaskNo — key lives in MetaMask; export from MetaMask itself
WalletConnectNo — key lives in the paired wallet app
ExternalNo — Alphio has no key to export

For best practices on private key safety, see /support/faq/wallet-and-security.


Agent Instructions: Querying This Documentation

If you need information not on this page, you can query the docs dynamically by sending a GET request with the ask query parameter:

GET https://docs.alphio.ai/account/wallets-management.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response includes a direct answer plus relevant excerpts and sources.