Documentation

Broker Connectivity

Overview

Astral offers broker connectivity for users with a Premium subscription. To deploy a strategy to a live brokerage account, you must connect a supported broker account and complete broker verification.

When you deploy a strategy to a broker, Astral sends trade instructions generated by your strategy to your selected broker through SnapTrade, our broker connectivity provider. Orders submitted through Astral remain subject to the broker's own account rules, market-hour limitations, asset restrictions, trading permissions, and other broker-enforced policies.

Astral currently supports individual cash accounts, individual margin accounts, and Coinbase crypto accounts.

Where broker data appears

Broker-connected data appears across several product surfaces:

  • Dashboard broker widgets show connection state and account summaries.
  • Dashboard account detail pages show account summary, activity, orders, positions, and balance history.
  • Terminal portfolio panels show positions, allocation, and portfolio overview data.
  • Terminal orders panel shows recent order lifecycle state.
  • Trade ticket workflows use broker/account context for manual orders and conditional orders.
  • Strategy deployment flows use broker/account context for connected execution where supported.

Broker source of truth

Astral can cache, format, and summarize broker data, but your broker remains the source of truth for live balances, positions, fills, restrictions, fees, and order status.

Supported Trading Scope

Astral currently supports:

  • Long positions only
  • Equities through supported brokerages
  • Crypto through Coinbase

Astral does not currently support:

  • Short selling
  • Options
  • Forex
  • Commodities
  • Mixed-asset-class deployment within a single strategy deployment

For equities, Astral strategies trade during regular market hours only. Astral currently allows one live Astral strategy per account.

Supported Brokers

Brokerage
Supported Assets
Fractional Support
Connectivity Period
Alpaca PaperEquitiesYes1+ years
E*TRADEEquitiesNo30 days
moomooEquitiesYes30 days
CoinbaseCryptoYes1+ years
tastytradeEquitiesYes1+ years
PublicEquitiesYes1+ years
Webull USEquitiesYes1+ years
KrakenCryptoYes1+ years

Broker connectivity is provided by SnapTrade.

Connecting Your Brokerage Account

To connect a brokerage account, you must authorize SnapTrade to communicate with your broker on Astral's behalf. This connection allows Astral to receive account data needed for deployment and to submit trade instructions generated by your deployed strategy.

A connected brokerage account must also be verified before it can be used for live strategy execution.

Astral uses SnapTrade launch, callback, reconnect, and renewal flows. If a broker session expires or a connection needs repair, use the broker connection surface in Dashboard or Settings to relaunch the portal.

Brokerage Verification

All supported brokers require a verification step before live deployment. Broker verification is performed by submitting a limit order and then canceling it. This process is used to confirm that:

  • the broker connection is active,
  • the account is enabled for trading,
  • API-based order requests can be received by the broker, and
  • Astral can successfully communicate with the account through SnapTrade.

In most cases, this verification order is canceled without any transaction occurring. However, because it is a live order submitted to the broker, execution is unlikely but not impossible.

Pre-Deployment Checks

Before a strategy can be deployed, Astral performs a series of checks on the selected account and strategy configuration.

These checks include:

  • No existing positions in assets traded by the strategy — The account should not already hold positions in assets the strategy is expected to manage.
  • Account not already in use by another Astral strategy — Only one Astral strategy may be deployed per account at a time.
  • Asset class matches account type — The selected strategy and the connected account must be compatible. For example, crypto strategies must be deployed to a supported crypto account, and equity strategies must be deployed to a supported equity brokerage account.
  • Excluded timeframes — Certain timeframes may be excluded during the initial rollout. These exclusions may be reduced or removed over time.

If one or more of these checks fails, deployment may be blocked until the issue is resolved.

Strategy Controls and Position Sizing

Astral applies the following deployment controls across supported brokers:

  • Global minimum trade size: $1.50
  • Positions are sized based on:
    • your strategy output, and
    • the available buying power in your connected brokerage account

Astral actively sizes positions using the capital it assumes is available to the deployed strategy, including allocated and unallocated capital associated with that strategy. If a broker supports fractional trading, Astral may submit fractional quantities. If a broker does not support fractional trading, quantity will be rounded down to the nearest whole amount.

Important account activity warning

If you change the state of the account outside of Astral, Astral will continue operating based on the account state it originally assumed until it encounters an error.

This includes situations such as: cash withdrawals, cash deposits, external transfers, dividends, broker fees, interest, realized gains or losses, crypto sale proceeds, and other balance changes outside Astral.

Astral does not automatically re-base the strategy to reflect these changes in real time. Instead, it continues operating from the originally assumed state until it hits a blocking issue such as insufficient funds.

Recommendation

For the best experience, we recommend using a brokerage account that:

  • is dedicated to Astral strategy deployment,
  • is not holding unrelated positions, and
  • is not being traded manually outside of Astral.

If you need to move cash or otherwise materially change the account, we recommend undeploying the strategy first, making the account changes, and then redeploying once the account is in the desired state.

Strategy States

Astral strategies can appear in the following states:

  • Saved — The strategy has been created and saved in Astral, but it is not actively deployed.
  • Deployed for Alerts — The strategy is active for alerts only and is not placing trades.
  • Deployed for Paper Trading — The strategy is active in paper trading mode and is not connected to a live broker for execution.
  • Deployed to Broker — The strategy is actively deployed to a connected live brokerage account for execution.
  • Paused — The strategy has been temporarily halted and is not currently placing trades. This can happen if Astral detects an issue such as an order rejection, insufficient funds, or an account integrity problem.
  • Undeployed — The strategy is no longer active in deployment and will not place trades.

Managed Position Integrity

Astral tracks the positions it expects to be controlling in a deployed brokerage account. If Astral detects that the live account no longer matches the state expected by the deployed strategy, a managed position integrity warning may appear.

This warning can be triggered by actions such as:

  • manually buying an asset that is being traded by an Astral strategy,
  • manually closing all or part of a position that Astral opened,
  • external transfers that affect the account state,
  • broker liquidations, or
  • other account activity that causes the live broker positions to differ from Astral's expected managed positions.

When managed position integrity fails, Astral may pause the strategy until the issue is resolved.

Common Strategy Errors

Managed Position Integrity Failed

This error appears when Astral detects that the live account no longer matches the position state expected by the deployed strategy. Examples include: unexpected positions in assets being traded by Astral, manual purchases of assets being managed by Astral, partial manual closes of Astral-managed positions, external transfers affecting the position state, and broker liquidations.

Insufficient Funds

This error appears when the account does not have enough available cash or buying power to complete the intended trade at the required size. This can happen because of: cash withdrawals, prior account activity, broker fees or other balance changes, changes to available buying power, or manual trading outside Astral.

Order Rejected

If a broker rejects an order, the strategy is paused. Because orders are ultimately accepted or rejected by the broker, broker-side restrictions, permissions, or account conditions can prevent execution even when a strategy is otherwise deployed in Astral.

Broker Restrictions and Account Rules

Even when a strategy is successfully deployed, your account remains subject to your broker's own rules and restrictions. These can include: cash-account trading restrictions, settled-funds requirements, margin-account restrictions, minimum order requirements, asset availability restrictions, account permission limitations, and other broker-enforced compliance controls.

Two common examples are Pattern Day Trading (PDT) and Good Faith Violations (GFV).

  • A Pattern Day Trader (PDT) designation generally applies to margin accounts that engage in repeated same-day round-trip trades. A common example is buying a stock and then selling that same stock later the same day, multiple times within a short period.
  • A Good Faith Violation (GFV) generally applies in a cash account when a user buys a security using unsettled funds and then sells it before that purchase has been fully paid for with settled funds. For example, a user may sell one position, immediately use those unsettled proceeds to buy another security, and then sell that second security before the original sale has settled.

These requirements may vary slightly based on your brokerage firm, account type, asset class, and jurisdiction. If your broker rejects a trade or applies an account restriction for one of these reasons, your Astral strategy may be paused.

Automatic Undeployment Events

Certain account or subscription changes will cause strategies to be undeployed automatically.

This includes:

  • Broker or account disconnection — If you disconnect a broker or brokerage account from Astral, any associated strategies will be undeployed.
  • Subscription downgrade — If your subscription level is downgraded and no longer includes broker deployment access, all associated user strategies will be undeployed.

Important

If a strategy is undeployed for any reason, you are responsible for managing and closing any open positions that remain in the brokerage account. Undeploying a strategy does not automatically close open positions unless explicitly stated elsewhere in product behavior.

Source of Truth

Your broker is the source of truth for: cash balances, buying power, positions, executions, fills, and account restrictions.

Astral is the source of truth for: strategy status, deployment state, platform controls, and Astral-generated alerts or warnings.

If there is ever a difference between what Astral displays and what your broker reports for live account balances, positions, or fills, the broker record should be treated as authoritative for the account itself.

Best Practices for Live Deployment

To reduce deployment issues and account mismatches, we recommend the following:

  • use a dedicated brokerage account for Astral when possible,
  • deploy only one Astral strategy per account,
  • avoid manual trading in the same account,
  • avoid moving cash in or out of the account while a strategy is deployed,
  • undeploy before making major account changes,
  • confirm that the account matches the intended asset class,
  • and review account restrictions and broker permissions before deploying live.