Skip to main content

Connection FAQ

Troubleshooting for the three connection rails: Broker Connect (SnapTrade), On-Chain Bind (Hyperliquid), and Telegram Bind.


My broker isn't in the SnapTrade list.

warning

Broker coverage is driven by SnapTrade's integration roadmap, not by Alphio directly. New brokers are added incrementally. If your broker isn't listed today, you can:

  • Request it via the in-app feedback form — we forward broker requests to SnapTrade and weigh them by demand.
  • Join the waitlist for the broker if one is shown.
  • Use a supported broker that operates in your region as an interim option.

We cannot give you a firm ETA for any specific broker until SnapTrade announces it.

SnapTrade connection keeps disconnecting. The most common cause is an expired broker OAuth / API token, which most brokers force-rotate every 30 to 90 days.

  1. Go to /account/connect.
  2. Find the disconnected broker entry.
  3. Click Reconnect and complete the broker's auth flow again.
  4. Confirm the green "Connected" status returns and account balances refresh.

If the connection drops again within a day of reconnecting, contact support with the broker name and approximate disconnect time so we can pull SnapTrade logs.

Hyperliquid bind fails on WalletConnect. WalletConnect has known deeplink issues on some mobile wallets that cause the Hyperliquid signature step to time out or never return. Recommended alternatives:

  • Privy — Alphio's built-in embedded wallet, no external app needed.
  • Browser extension — MetaMask / Rabby / OKX Wallet via the desktop extension flow.

See Connect On-Chain for the full walkthrough. If you must use WalletConnect, ensure the mobile wallet app is open in the foreground when you tap Approve in Alphio.

MetaMask shows wrong network. Alphio uses different chains depending on the trade rail:

  • Spot / ERC-20 depositsEthereum mainnet.
  • PerpetualsHyperliquid chain (HyperEVM / HyperL1).
  • PolymarketPolygon.

Switch the network manually in MetaMask before signing. If the target chain isn't in your MetaMask, Alphio will prompt MetaMask to add it on the first attempt — approve the "Add Network" request.

Telegram bot didn't send my code. Run through these checks:

  • Confirm you started the chat with the official bot: t.me/AlphioBot. Imposter bots will not send Alphio codes.
  • Make sure you tapped Start at least once — Telegram blocks bots from messaging users who never initiated a conversation.
  • The bot may be rate-limited if you requested multiple codes in a short window. Wait 60 seconds and tap Resend.
  • Check your Telegram notification settings — the bot chat may be muted or archived.

I bound the wrong wallet — how to switch?

  1. Go to /account/wallets.
  2. Locate the wrong wallet entry.
  3. Click Remove and confirm.
  4. Click Add Wallet and re-bind the correct address.

Open positions on the removed wallet are not affected on-chain, but Alphio will stop tracking them until you re-bind that address.


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/support/faq/connect.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.