Documentation
Accounts & Billing
Your Astral account controls identity, terms acceptance, subscription status, feature access, notification destinations, public profile, and connected services.
Sign in and verification
Astral supports email/password, passwordless one-time-code flows, Google, and Apple entry points where enabled. Signup and reset flows use verification codes; a passwordless account can later be prompted to add a password. An older account created with a username instead of an email can enter that username and its password in the password form; it opens the account for that login's email. If the page says This login has no email address, contact Help.
Phone verification is separate from sign-in and can be required before enabling SMS notification delivery. A verified account email can be reused as a verified notification destination when it matches the profile email.
One account for each email
Each email address has one Astral account, whichever way you sign in: an email code, a password, Google or Apple. Signing in with Google or Apple for the same address opens the same account, in Classic and in Onchain. Apple's Hide My Email addresses are a different address, so they are a different account.
If you made more than one account with the same email before this change, the first time you use the other sign-in method Astral shows Connect your sign-in methods. Choose Email me a code, enter the code, and choose Confirm and continue. Your strategies, chats, chart sessions, backtests, indicators, alerts, follows and settings from that sign-in move into your main account, and both methods open it from then on. Where both had the same setting, such as preferences, your profile or your watchlist, the main account keeps its own. An unsubscribe from either sign-in stays in force. The main account is the one holding your paid plan or connected accounts, otherwise the oldest.
Some accounts are not combined automatically: two paid subscriptions, a connected broker, wallet, live strategy or withdrawal address on the other sign-in, product access set on both, or a staff account. The page then says We need to review these accounts before connecting them and names the sign-in method that opens your main account; an email code also opens it. Nothing is moved or deleted. Contact Help to combine the rest.
An Apple sign-in that Astral has not yet confirmed shows Confirm your email once; the same code step finishes it. To add or change a password, open Settings → Security and choose Set or change your password with an email code.
Hosted sign-in addresses
The branded hosted-login addresses are auth-dev.heyastral.ai for Dev and
auth.heyastral.ai for production, where enabled. This guide does not establish
whether either environment has switched or whether the address is live for every
user; that depends on the deployed release. An older release can still use an
Astral login address ending in amazoncognito.com.
Start sign-in from the Astral website or the connection button in your app. These addresses use the same existing account within their environment; Dev and production remain separate, and a hostname change does not require a new account.
The website's email/password form stays on the website. Google and Apple account-selection or consent screens still use their provider's domain. If a sign-in link expires or fails to return, restart from the original app rather than editing the login URL. Desktop and mobile web follow the same rule; installed native apps adopt the branded address with their own qualified release.
Account settings
Settings includes account and profile information, subscription and live feature access, notification profiles, broker connections, MCP connection setup, and other preferences according to rollout. The public profile is optional and exposes only the fields and publications described in Profiles & Following.
Subscription and checkout
Public checkout creates a Stripe subscription session for Astral. On your first subscription, the first month is $9 and later months are $30/month; checkout shows this before you pay. No code is needed, and there is no code field. If you subscribed before, even if that subscription ended, checkout is $30/month. Existing subscribers can open the billing portal or use the subscription controls presented in Settings. The $9 first month applies to web checkout, not App Store purchases.
How did you hear about Astral?
After your first web payment and access confirmation, Astral asks how you heard about it: A creator or influencer, Google or another search, A friend, AI recommendation or Something else. Choose an answer and press Continue. Something else allows optional text; it also covers social posts that did not come from a listed creator.
If you choose a creator, pick their Instagram photo and @handle from the list. Search appears when there are more than six accounts. If they are not listed, choose Other, the last card in the list; it has no text box and does not assign affiliate credit. The back arrow returns to the answers. The creator option is hidden when the list is empty.
An answer is required during normal use: there is no Skip or close button, and Escape or tapping outside does not dismiss the question. An unanswered question returns when you enter Terminal, Dashboard, or broker setup directly. It applies to recent first-time Stripe subscribers (within 30 days of their first payment, or while that payment is still being recorded), on desktop and mobile web. It is not an App Store purchase step. Previously recorded answers and skips are kept and are not asked again.
If the questionnaire cannot load within five seconds, your workspace opens temporarily. If saving fails because the service is unavailable, choose Try again or Continue for now. Temporary access does not record an answer or skip; Astral checks again on a later workspace entry after a short grace period. Invalid answers must be corrected rather than bypassed. Your access and price do not change, and an existing creator referral keeps its credit whatever you answer. AI recommendation does not assign an affiliate.
If checkout fails, confirm you are signed in, return to Pricing, and retry. Do not submit repeatedly if the payment provider shows an ambiguous completion state; check subscription status first.
Feature access
The app loads an account-specific feature-access response containing the subscription tier, effective tier, usage, remaining capacity, temporary grants, and pending downgrade actions. This live response overrides general marketing summaries for your account.
See Plans & Limits for the standard comparison.
Downgrades and cancellation
Loss of an entitlement can reduce limits or stop broker-connected workflows. Astral can schedule demotion actions when current usage exceeds a new allowance. Review active strategies, broker connections, alerts, and saved work before changing plans.
Automatic undeployment after subscription expiry
On releases with subscription-expiry cleanup, losing the required access can remove an active deployment after its applicable grace period. Check your live subscription and deployment status; scheduling cancellation is not confirmation that cleanup has finished.
- Astral Paper: remaining simulated positions can be retired through a recorded accounting adjustment. Their book value is written off; this is not a market sale and creates no sale proceeds or invented fills. Remaining available Paper cash returns to the account when the run closes. The saved strategy and existing fill/ledger history remain.
- Broker connected: automatic cleanup does not sell broker holdings. Astral ends the deployment's management of them. Submitted or uncertain orders may still need cancellation or settlement, so check positions and orders directly with the broker.
- Pending cleanup: ownership, outstanding-order or accounting checks can prevent completion. A removed deployment or a notice alone is not proof that all external orders settled. Report the affected strategy and current status if cleanup remains pending; do not recreate the account to clear it.
This account-level behavior is separate from choosing Stop yourself in the Dashboard. Web, mobile and installed clients may show different controls by release; changing devices does not change the account's cleanup status. See Stop, undeploy and delete for the manual workflow.
Authentication lifecycle
The browser session and a broker authorization are separate. Signing out of Astral ends the application session but does not close brokerage positions or necessarily revoke the broker connection. Conversely, a broker connection can expire while the Astral account remains signed in.
If Terminal repeatedly returns to sign-in or stays blank after authentication, start a fresh sign-in flow in one tab and avoid opening several verification links. If the issue continues, include the approximate time and route in a Help request without sending the verification code.
Understanding effective access
Your named subscription tier is only one input. The effective access response can include trials, staff or VIP grants, phased rollouts, temporary promotions, grandfathered Plus access, and pending downgrade work. This is why two accounts with the same public tier label can temporarily see different capabilities.
Feature gates usually distinguish between:
- usage limits, which replenish on a defined schedule;
- capacity limits, which count currently saved or active records;
- entitlements, which turn a capability on or off;
- temporary grants, which alter access for a limited period.
Read the message in the product gate before upgrading or deleting work. Reaching a daily usage limit requires a different response from reaching a saved-strategy capacity limit.
Billing-state troubleshooting
After checkout or a portal change, allow the return flow to refresh subscription state. If the app still shows the old access, reload once and reopen Settings. Do not start a second checkout until you have checked for an existing subscription or payment confirmation.
For a failed or incomplete payment, Stripe and the account subscription view are the relevant sources. Astral support should never ask for a full card number, password, or one-time sign-in code.
Before changing plans
Review active connected deployments, Astral Paper portfolios, manual-trading access, broker connections, alerts, saved strategies, and any scheduled demotion notice. Decide which records to stop or remove deliberately. Then verify the broker after the plan change, especially when connected execution was active.
Classic and Onchain account access
An administrator manages product access separately from your paid plan. An individual assignment can allow Classic, Onchain, or both; removing entry access preserves the original product's authenticated recovery routes. New-account defaults are determined at signup, so later changes to those defaults do not reassign existing accounts. Product availability and staff-only restrictions still apply. See Navigation for the chooser and recovery links.
Where product switching is enabled, Classic and Onchain share your account and subscription within the same environment. Product access is a separate rollout entitlement: a paid plan alone does not guarantee Onchain access. A website preference does not grant access, start another subscription, or move running execution.
Each website maintains its own browser session. Use the same sign-in identity if the destination asks you to sign in again. Changing products does not sign you out of other tabs. Keep using the original product to monitor or recover its strategies and positions; contact Help if access changes prevent that recovery.
In the paired release, switching products does not reset account-wide saved-strategy or deployment usage, financial reservations, or wallet limits. Billing and account deletion use one account-wide service. If that service is temporarily unavailable, retry the original action after it recovers; do not create another subscription or identity as a workaround. A failed request is not confirmation that a billing change or deletion completed.
If the same account has work in both products, some legacy account-reconciliation and external-close recovery actions may require support review. Astral must not treat the other product's hidden orders or ownership as absent. Keep monitoring and managing each product's work in its original product, and contact Help rather than clearing ownership, repeating a sale or moving funds to bypass the review. These safeguards apply to Paper and real accounts on desktop and mobile web; paired native recovery remains unverified.