Connect on-chain (wallets & Hyperliquid)
All on-chain trading in Alphio runs on your Alphio wallet, a non-custodial embedded wallet secured by Privy. You don't install a wallet app or bring an external one. Alphio creates the wallet, and you enable each venue when you first trade there.
Find it at: Profile → Account → Wallet, or the wallet pill in the top navigation bar.
1. Three steps
Going on-chain comes down to three steps:
- Have an Alphio wallet. Alphio creates it the first time you need one, for example when you open Deposit or start a perps trade. See Wallets Management.
- Enable the venue. Hyperliquid perps and Polymarket each need a one-time authorization so Alphio can place orders for you (sections 3 and 4).
- Fund it. Deposit the right cash for the venue (section 5).
External wallets (MetaMask, WalletConnect, etc.) can no longer be added. If you connected one earlier, it stays on your account as read-only · withdraw only.
2. Create your wallet
If you don't have a wallet yet, Alphio shows a Create Wallet button wherever one is needed. Click it, and your wallet is created in a few seconds. There's no seed phrase to write down.
Behind one account there are two embedded wallets. The EVM wallet is for Perps (Hyperliquid) and Predictions (Polymarket), and the Solana wallet is for Tokens. Both are non-custodial, and you can export either private key at any time.
3. Hyperliquid perps
Hyperliquid is a perpetual-futures DEX. To trade it from Alphio, your wallet authorizes an agent: a separate trading key that can place and cancel orders on your Hyperliquid account but cannot withdraw funds.
What happens:
- With your Alphio wallet, the authorization is signed silently, with no wallet pop-ups. It runs the first time you deposit into Perps or place a perps order. The signatures are gas-free messages, not on-chain transactions.
- If the silent path can't complete, Alphio opens Connect Hyperliquid Wallet, where you review the agent details and sign two gas-free messages.
- Alphio generates the agent key and stores it encrypted on its servers so it can submit your orders. Your wallet's own private key is never sent to Alphio.
- The authorization has an expiry date, shown as Authorization expires: in the connect dialog. When it lapses, Alphio re-authorizes the next time you trade.
Leverage and margin mode (Cross / Isolated) are set in the trade panel on any Hyperliquid perpetuals page.
Disconnecting Hyperliquid revokes the agent. You sign one gas-free message, and Alphio stops copy trading on that wallet first. You can also choose to cancel open orders and close positions. After you disconnect, Alphio can't place, cancel or close anything for you. Positions you leave open stay on Hyperliquid, and you'd close them on hyperliquid.xyz yourself.
4. Polymarket
Prediction-market trading needs Connect Polymarket once. Connecting authorizes Alphio to sign Polymarket trades from your wallet under a restricted policy. The same permission carries out Predictions withdrawals you confirm with an email code.
To revoke, choose Unlink Polymarket. Open orders, active copy-trading, open positions, settled positions to claim, and remaining balance have to be cleared first. After you unlink, Alphio can't place, cancel or copy any trades for you.
5. Fund your cash
Connecting or enabling a venue doesn't move money. Open Deposit and pick where the money goes. Each destination accepts exactly one token on one network:
| Destination | Send | Network |
|---|---|---|
| Perps (Hyperliquid) | Native USDC (0xaf88d065e77c8cC2239327C5EDb3A432268e5831) — not USDC.e | Arbitrum |
| Predictions (Polymarket) | USDC.e — not native USDC | Polygon |
| Tokens | USDC | Solana |
For Perps:
- USDC you send to your wallet's Arbitrum address is deposited into Perps automatically, usually within 1–3 minutes. If the deposit screen asks for an amount instead, enter it and confirm once.
- The minimum is $5.
- Alphio covers the Arbitrum gas, and a small fixed fee ($0.10) is taken.
Hyperliquid's minimum order is around $10, so depositing a bit more than that leaves room for margin and fees.
You can also pay by card or bank through a payment partner, or move cash from another venue with Transfer, where available. Details: On-Chain Deposits and Card Deposits.
Native USDC and USDC.e both show as "USDC" in most wallets and exchanges. Check the network and contract before sending. Funds sent on the wrong network or as the wrong token aren't credited.
6. Known issues
- Wallet not connected / Sign in — your embedded wallet needs an active Privy session to sign. If you see Sign in next to your wallet, sign in again to withdraw or trade.
- "This wallet is linked to a different login" — the wallet was created under a different sign-in method, so it can't sign here. Use Export private key on that wallet to recover its funds, then contact support if you need help.
- Agent already approved elsewhere — if Hyperliquid reports that the wallet already approved a different Alphio agent, revoke the old agent on Hyperliquid's API page, then try again.
- Region restrictions — Hyperliquid and Polymarket aren't available in some regions. Alphio shows Restricted region on those entries.
This page is available as plain Markdown at https://alphio.ai/docs/get-started/connect-on-chain.md. An index of every page, with a one-line summary each, is at https://alphio.ai/docs/llms.txt.