Documentation
Wallets, cash and funding
Astral wallets belong to your signed-in Astral account. The current dev workspace has separate Real money and Paper portfolios. Real wallets can include Solana and enabled EVM networks; the wallet cards and funding choices show what is available to your account.
Available cash is verified wallet Cash. In Real money, open the Cash menu to see Tokens cash and separate Perps cash. Tokens cash is the available Cash shown on the header button; it excludes perps. Perps cash is withdrawable USDC on Hyperliquid mainnet, not total margin equity, and cannot fund a spot buy or strategy allocation. Settings → Wallets also shows it beside Cash.
Choose Swap, grouped with Add money and Withdraw, in the Cash menu (or More on mobile Profile) to open Transfer cash. Like Withdraw, it starts with an amount: choose Tokens → Perps or Perps → Tokens, enter an amount or use 10%, 25%, 50% or Max, then choose Review. Check the costs and destination, then Confirm and approve your wallet when asked. Back returns to the amount; changing direction clears it and the previous review. The status screen has Done, which closes the dialog; an in-progress status does not mean funds have arrived. See the transfer instructions.
Moving Tokens → Perps uses your overall verified available Cash, matching the header, rather than only the amount on Arbitrum. The percentages and Max use that overall balance, subject to transfer limits; the review checks supported funding routes and costs before you approve. Astral's funding coordinator prepares the needed cash from supported wallet networks before the perps deposit. You do not need to move it to Arbitrum yourself. Perps → Tokens uses withdrawable perps USDC and returns it to your Tokens cash.
Before showing an incoming amount, the dialog checks eligibility. If residence or a required province is missing, Confirm residence opens automatically. Enter your actual two-letter Country code and applicable Region code, then choose Continue. Checking eligibility rechecks your residence and connection before opening the amount form. Opening the dialog or switching to Perps → Tokens saves nothing. A missing declaration is setup to finish, not an account restriction.
If the check cannot locate your connection, We couldn’t verify your connection’s location offers Check again. Perps aren’t available in your location reports a confirmed location restriction; an account pause has a separate message. You can still select Perps → Tokens where offered. The amount step normally has no helper paragraph below the balance; relevant limits and errors appear in a short card.
This moves real mainnet funds even if your Perps trading ticket uses testnet; Real funds only. Testnet is separate. is shown where relevant. Opening the dialog does not set up trading, sign a transfer or place an order. Route availability and account eligibility still apply; where moving in is restricted, Perps → Tokens can remain available. Cash transfers are unavailable here describes a disabled funding capability, with Retry to re-read it, rather than an account-eligibility decision. The overall balance stays visible; incoming entry and Review stay disabled until the required checks pass. The dialog does not silently switch to an Arbitrum-only deposit. Minimum transfer: $5 reports the deposit minimum when the available Cash is below it. Paper mode has no real-money transfer shortcut or mainnet balance rows.
Wallet Cash can load before perps cash. Unavailable in the menu or Hyperliquid balance unavailable means an amount could not be read, not zero. Choose Refresh balances to retry the balance read. If the transfer dialog cannot load, use Retry transfers; neither retry moves money.
Cash funding can be limited to selected accounts. Available controls reflect your current eligibility; losing access to new funding does not hide an existing operation or its cancellation controls.
On mobile Profile, the Cash hero uses the available ledger balance; Paper cash uses the selected Paper account's available USDC. Add funds opens deposit choices, Send opens withdrawal, and Receive opens the crypto deposit path. These are entry points to the existing forms and review, not immediate transactions. More → Wallet details explains Cash; perps cash remains separate. Paper offers simulated Deposit and Withdraw, with a reminder when real-money strategies continue running. Change trading mode in Settings → Wallets, not by selecting a bottom tab.
Open your wallet controls
- In desktop Terminal, hover over or click the avatar at the top right and choose Settings. Clicking keeps the account menu open; select the account summary at the top of the menu if you want your profile instead.
- Choose Wallets in the Settings sidebar. On mobile, tap Open menu at the top left, choose Settings, then Wallets; horizontally scroll the settings tabs if needed. Wallet in the mobile menu opens the same settings directly; the menu also has Deposit.
- Check Trading mode. Real money and Paper have separate balances. Select a mode, then choose Switch to real money or Switch to paper to confirm.
- In Real money, Cash shows your available cash next to Add money and Withdraw. Wallets by network opens on Solana. Use Network to switch between enabled networks. Each selection shows its balances and available funding actions, plus the wallet address for a spot network when available. Choose Refresh balances to update network balances.
- In Paper, Paper cash shows available simulated USDC and the total balance. Choose Deposit or Withdraw to adjust simulated funds.
If Update wallet permissions appears, Astral's trading signer on your EVM wallet still has older limits; for example, an EVM wallet enabled before perps cannot approve perps setup. Choose Update permissions and approve the change with your wallet. It updates what that signer may sign; it does not move funds, and the signer still cannot withdraw.
The header's Cash or Paper cash balance also opens funding actions. The adjacent portfolio-value control opens positions; portfolio value includes cash and holdings and is not the amount available to spend or withdraw. The positions list omits available Cash and funding-stablecoin balances in Paper and Real money; use the Cash controls, mobile Profile or Settings → Wallets to inspect them. A cash-only wallet can have no open positions.
Some unsolicited Solana balances are filtered from active positions, portfolio value and P/L. The targeted rule checks for a frozen, non-associated token account with closing rights held by another address; an unknown name or missing price alone is not enough. Raw balances remain recorded separately, and filtering does not move funds or change Cash. See suspicious token balances.
Hyperliquid Perps uses one ticket for Paper and Real money. Real money selects venue execution. Where the Paper simulator is enabled, BTC/ETH show Paper · Simulated money in that same ticket: it reserves existing Paper USDC, supports isolated 1–5× longs/shorts and needs no venue wallet setup or deposit. Settings → Wallets shows reserved perp margin and open-position count. Reserved margin and pending-order cash cannot be withdrawn or spent on spot orders/strategies; portfolio equity adds only unrealized P&L to the cash already held. Manage the position in Perps → Trade. If you see Perp paper trading is not available yet, the simulator is not enabled in your release.
Real money mode does not choose the venue network: check the ticket's Testnet / Mainnet label and same-network margin. Testnet uses venue test funds; mainnet uses real funds. Switching modes does not cancel admitted Paper or venue orders or close positions. See Perps and Paper mode for execution limits, fees, funding and price-gap recovery.
Choose the task
- Add money: fund real cash from another wallet/exchange or buy with card/bank where offered. See Deposits.
- Withdraw: send eligible real funds to a confirmed external address. See Withdrawals.
- Get USDC / Get USDG: fund a particular network wallet from an external source or another eligible Astral wallet. See Transfers and gas.
- Get gas: obtain the network coin needed for fees where a route is offered.
- Deposit / Withdraw in Paper: change simulated USDC only. See Paper trading.
Only the network and asset explicitly named by a deposit screen are supported by that deposit instruction. A matching-looking EVM address does not make different networks interchangeable. The real cash funding flow currently offers direct card purchases on Solana or Base where available; other wallet-specific routes can require a subsequent transfer.
SOL and covered trading fees
Some existing Solana execution paths still require wallet-funded SOL. The shared order policy is development-only and rollout-controlled. When your trade ticket or Confirm Deployment review explicitly offers its covered network fees, eligible ordinary Solana orders use the shared quoted fee schedule; new strategy deployments under that policy need USDC but no separate SOL reserve. In a strategy deployment, read the fee summary before confirming. Older orders and deployments retain their approved terms.
Covered trading does not remove token-account deposit allowances, guarantee execution, or establish gas coverage for transfers, withdrawals or other networks. A new-token buy is refused when its deposit allowance is exhausted rather than silently charging your SOL. Get gas remains available for workflows that still need a network coin. Paper continues to use simulated money; mobile and desktop follow the selected wallet's displayed terms.
Separately, where the development rollout offers USDC charge included · no SOL needed, direct Solana USDC withdrawals can use Astral's sponsor. The quote deducts a USDC charge covering capped gas, recipient account setup where needed and a buffer from the entered total. Native SOL withdrawals keep their existing fee requirements. Availability is determined by the withdrawal route, independently of the trading policy.
Understand your balances
Available cash, funds assigned to strategies, funds reserved for orders, on-chain balances, pending deposits and portfolio value describe different things. In Real money, cash a deployed strategy has not spent is not available to you, but it counts in the portfolio value and is shown as In strategies in the Cash menu and the Wallets Cash card. A deposit can be visible on chain before it becomes tradable. A withdrawal can require one eligible funding source rather than combining every network balance. Follow the amount and costs in the current quote.
Cash combines eligible USDC and USDG balances from your own wallets, shown at $1 per token. Available Cash excludes strategy allocations, order holds and money moving between wallets. Processing is a conservative amount for internal transfers; Reserved is held for an operation or order. Neither is additional buying power. Pending external deposits are checked in the relevant network's funding details; the Cash total uses credited ledger balances.
An amount marked unavailable pending review cannot fund a new action. Portfolio value can also remain unavailable while that account's backing is under review; an unavailable value does not mean a verified zero balance.
The desktop Terminal portfolio header keeps known value visible when a holding has no price. P/L separately excludes holdings without both a price and verified entry cost; excluded cost does not count as a loss. Hover over the portfolio control for the exclusion explanation, or open it to inspect holdings. The amounts have no visible Partial tags. See Partial portfolio value and P/L. This does not change Cash, buying power or withdrawals.
Live token position P/L
Native SOL holdings
In releases that include native SOL manual trading, Positions and the portfolio value include your positive native SOL balance. Its Buy more and Sell actions open the SOL ticket. Prices update from SOL's on-chain market; entry cost and P/L stay unavailable unless the recorded trades reconcile with the holding. A SOL deposit alone does not establish an entry cost. Native SOL is distinct from a separately held wrapped SOL token. Cash remains USDC and other eligible stablecoins: holding SOL does not increase available USDC.
The sell ticket uses the amount available to your manual account, excluding strategy-owned SOL and reservations. See Trading SOL for sponsorship and the small remaining-balance restriction. These are source-reviewed changes awaiting a matched release; a source change does not establish availability on the running app.
In Positions & Orders, Solana and enabled EVM token values and unrealized P/L use incoming live quotes when the Terminal price connection is available. The Terminal portfolio total uses the same token marks. If a token has no recent streamed update, visible views retry reference prices on a five-second fallback cadence; returning to the tab also checks prices. This applies to Paper and Real token holdings on desktop and mobile web. Balances and recorded entry costs refresh separately; a new quote does not change your holdings or cost basis.
Updates depend on available market data and the connection, so a five-second fallback is not a guaranteed price age. During a failed refresh the last mark can remain visible, and a reference or fallback price can differ from a chart or an executable trade quote. P/L still requires a verified entry cost matching the current holding; a missing entry cost is not zero. This token-price behavior does not change perpetual-position valuation, Cash, buying power or withdrawal amounts.
When Cash is refreshing
After a trade or funding change invalidates the displayed Cash balance, it can show — until the latest verified wallet balance arrives. A slow Hyperliquid balance read does not delay that wallet refresh. Older venue responses cannot replace the newer wallet balance or restore an amount after a required balance read fails.
If Cash balance unavailable appears, use the Cash refresh button in Settings → Wallets to retry the balance read. Missing wallet data is not a zero balance; an unavailable perps cash amount is disclosed as above. Refreshing does not retry a trade, move funds or authorize another action. Portfolio value can still need verified holdings and prices after Cash returns.
This wallet-Cash refresh behavior applies on desktop and mobile web in Real money. Paper cash uses its separate simulated portfolio. Installed clients can differ until updated; no fixed first-load time is guaranteed.
Resume interrupted funding
Where durable funding is enabled, Cash lists unfinished funding. Confirmation needed → Continue resumes the existing operation without another set of transfers or a new trading authorization. A previously confirmed Base buy can continue as described below; funding-only operations do not place an order. Preparing funds means confirmed transfers are still settling. Needs review means inspect the transfer or return to the trade/deployment review; an expired quote or canceled browser prompt does not prove a signed transfer cannot execute. Do not start another move to replace an uncertain one.
Confirmed transfers can finish after the browser closes. For funding-only operations, returning to Cash does not place the original trade or deploy a strategy. A separately reviewed Base strategy can instead show Ready to deploy → Deploy strategy, which resumes its stored request with fresh admission checks. Otherwise, after funds arrive, return to the action and review its current terms. Cash stays available on the receiving network and contributes to the same combined balance.
An eligible Base market buy may show its continuation terms directly in the ticket. Read Maximum Cash used, Funding cost (est.), Minimum received, trade fees and the deadline, then press Buy [token] once. That click authorizes the buy to continue after funding, even if you close the app; no separate routine confirmation follows. Wait for a current Cash quote. This separately gated flow holds cash for that specific buy and carries its displayed bounds into the order. Current permissions avoid another product review; first-use or renewed permission still needs owner consent. Resume buy after an interrupted response uses the original operation, rather than starting a new purchase. To abandon that attempt before editing, use the ticket's Cancel buy and wait for acknowledgment; confirmed transfers can still finish. Already admitted orders retain their normal controls. Buying → View orders opens the existing order list. Funding completion is not a verified fill; check the order's final status. Other funding paths retain their displayed reviews.
For a confirmed buy that has not been admitted, Cancel buy stops the purchase and releases its destination Cash hold. Transfers already confirmed can still finish, and source holds for possibly signed transfers need settlement evidence before release. After order admission, use the order's normal cancellation controls where offered. Editing another ticket does not cancel a confirmed buy. If its deadline or admission checks fail, arrived cash stays in your wallet and the buy needs another review; the app does not silently lower its minimum received or extend its deadline.
A reviewed Base strategy displays its name and allocation in Cash. Deploy strategy repeats account, strategy-revision, capital and availability checks; it does not deploy automatically after browser closure. Its review expires after 15 minutes. Cancel deployment stops activation before deployment; confirmed transfers can still finish. Arrived strategy funding stays unassigned and available until deployment succeeds. Check Strategies for completion. Changed strategies or expired reviews require a fresh deployment review; Strategies explains the supported scope.
A reviewed Base conditional buy displays its original rule in Cash. Ready to activate → Activate order arms that rule after verifying its funding and current admission; it does not buy immediately. Closing the ticket leaves activation to this explicit action. Its review lasts at most 15 minutes, capped by the order expiry. Cancel activation stops an unactivated review, even after cash arrives; confirmed transfers can still finish. Cancel an already active rule through Positions & Orders. When its review explicitly promises a reservation, activation shows Rule budget reserved and the held amount is included in Reserved, excluded from available Cash. This also applies to eligible buys already funded on Base. The hold stays while paused, transfers atomically to a triggered order, and releases on cancellation or expiry. After an order is admitted its normal controls own the funds. Other reviews retain their existing trigger-time reservation behavior. Changing a reserved rule requires cancellation and a new review. See Conditional buy funding for the supported scope and retry behavior.
Supported automatic-funding routes can request a one-time wallet permission. Read its exact wallets, networks, per-transfer limit and expiry. A funding permission does not authorize arbitrary external withdrawals, and a backend daily limit is not a guarantee enforced by the wallet signer. Renew expired permission only through the displayed owner-authorization flow.
If Confirm cash funding appears, review Cash used, Expected arrival, Funding cost and gas coverage, then choose Confirm funding. These amounts normally cover the funding moves; cash already available on the trading network is separate. A reviewed deployment or conditional activation instead shows Maximum Cash used, including reviewed local cash and maximum transfer debits. Funding details expands the individual routes and wallet addresses. The funding cost is separate from any commission shown in the trade review; both apply.
Subscription payments pay for app access. They do not deposit money into your wallet. Historical backtests do not require trading capital.
Ask the assistant for Paper positions to inspect wallet-level holdings, cost basis, marks and unrealized PnL. Account rows include tokens allocated to strategies once; ask for a specific strategy to inspect its allocation separately. Paper and real accounts remain separate. Missing marks or incomplete valuations are unavailable, not zero, and small token prices retain their precision.
Clear token dust
For a low-value holding you want to sell, first check the full-position market sell option. Where offered, its reduced minimum uses the holding's quoted value without a token-quantity dust limit. Cleanup below destroys tokens and has different eligibility.
This is a separately gated Dev feature for Real money → Solana. Follow these steps only when the position offers Clear dust. It is unavailable in Paper and on EVM networks; native-app signing has not been verified.
- Open Positions & Orders, expand the tiny token holding (click its value or arrow), and choose Clear dust.
- Read the exact token amount and token account. Cleanup permanently destroys the displayed tokens; it does not sell them for cash. Eligible standard SPL balances must be no more than 0.000001 tokens and worth no more than $0.01 at a verified current price. Cash tokens, wrapped SOL and Token-2022 assets are excluded from this initial flow.
- Review Network fee · paid from your SOL, Account deposit recovered and the refund destination. A verified user-funded deposit returns to your wallet. A sponsor-funded deposit returns to Astral’s gas sponsor. When deposit ownership cannot be verified, cleanup burns only the dust and leaves the empty account open.
- Choose Permanently burn dust to authorize the exact transaction through your embedded wallet, or Cancel before signing. The destruction cannot be undone. No private-key export is needed.
- Wait for Dust cleared and the refreshed holdings. View transaction opens the network record. Submission alone is not confirmation; the backend keeps tracking a signed cleanup after you close the panel. Other wallet operations wait until it settles.
Cleanup refuses strategy-owned or reserved tokens, active protection and unfinished wallet orders/transfers. A zero sellable balance does not by itself prove cleanup is eligible. Accounting differences, unavailable current prices, unsupported custody or insufficient available SOL can block the review.
If confirmation is uncertain, use Retry same cleanup when offered; it retains the same operation and signature. Reopen the position to recover an admitted cleanup. Do not create a replacement while it is pending. An expired review needs Refresh review. Review again is offered after proven non-landing or an on-chain failure; failed on-chain transactions can still charge the reviewed network fee.
Export and account recovery
In Settings → Wallets, select Solana under Wallets by network and choose Export key when you intend to export that wallet. Follow the wallet provider's verification flow and keep the key out of chats and bug reports. Availability differs by platform. Native export can open a secure web flow.
Exporting a key, signing out and changing trading mode do not stop existing strategies or close positions. An external wallet used as a funding source does not automatically become the strategy's execution wallet. For an unavailable wallet, use the displayed retry/sign-in action and verify the Astral account before attempting a different identity.
See Orders, Strategies, and Security.