Skip to main content

​
Overview

Connecting your wallet is the first step to accessing Staxiq’s Bitcoin DeFi analytics and AI-powered strategies. This guide walks you through connecting supported Stacks wallets and troubleshooting common issues.
Staxiq supports all Stacks-compatible wallets including Leather Wallet (formerly Hiro Wallet), Xverse, and Asigna.

​
Prerequisites

Before connecting, make sure you have:
  • A Stacks wallet installed (browser extension or mobile app)
  • Some STX or sBTC in your wallet (even small amounts work)
  • Access to Stacks mainnet or testnet

​
Connecting Your Wallet

1

Open Staxiq Dashboard

Navigate to the Staxiq dashboard. You’ll see a Connect Wallet button in the top navigation bar.The button displays prominently with an orange gradient:
<button className="bg-orange-500 hover:bg-orange-600 text-white">
  Connect Wallet
</button>
2

Click Connect Wallet

Click the Connect Wallet button. This triggers the wallet connection flow.Behind the scenes, Staxiq calls the connectWallet function:
// Initiates connection request to your wallet
connectWallet()
You’ll see a loading state while the connection is being established:
<span className="flex items-center gap-2">
  <svg className="animate-spin h-4 w-4" />
  Connecting...
</span>
3

Approve Connection in Wallet

Your wallet extension will prompt you to approve the connection. Review the permissions and click Approve or Connect.
Staxiq only requests read access to your wallet. It cannot execute transactions without your explicit approval.
4

Verify Connection

Once connected, you’ll see your shortened wallet address displayed:
{shortAddress(address)}
// Example: SP2J6...K5Z8
The address format shows the first 5 characters and last 4 characters:
function shortAddress(addr) {
  return `${addr.slice(0, 5)}...${addr.slice(-4)}`;
}

​
What Happens After Connection

Once your wallet is connected, Staxiq automatically:

Fetches Portfolio Data

Loads your STX and sBTC balances from the Stacks blockchain

Analyzes Transactions

Reviews your transaction history to understand your DeFi activity

Detects Protocol Positions

Identifies active positions in protocols like StackingDAO, ALEX, and Zest

Enables AI Copilot

Unlocks personalized strategy recommendations based on your portfolio

​
Portfolio Data Fetching

Staxiq uses the usePortfolio hook to fetch your data: 
export function usePortfolio(address) {
  const [portfolio, setPortfolio] = useState({
    stxBalance: '--',
    sbtcBalance: '--',
    totalUSD: '--',
    txHistory: [],
    stxPrice: 0,
  });
  
  useEffect(() => {
    async function fetchPortfolio() {
      const data = await getFullPortfolio(address);
      setPortfolio(data);
    }
    
    fetchPortfolio();
    // Auto-refresh every 30 seconds
    const interval = setInterval(fetchPortfolio, 30000);
    return () => clearInterval(interval);
  }, [address]);
  
  return { portfolio, loading, error };
}
Your portfolio data refreshes automatically every 30 seconds to show real-time balances.

​
Disconnecting Your Wallet

To disconnect your wallet:
1

Click Disconnect Icon

Click the disconnect icon (logout symbol) next to your address.
2

Confirm Disconnection

Your wallet will be disconnected and the dashboard will return to the connection prompt.
<button
  onClick={disconnectWallet}
  className="text-[#4a5a7a] hover:text-red-400"
  title="Disconnect Wallet"
>
  <svg className="w-4 h-4" />
</button>

​
Troubleshooting

​
Wallet Extension Not Detected

If Staxiq doesn’t detect your wallet, make sure:
  • Your wallet extension is installed and enabled
  • You’re not in private/incognito mode (some wallets don’t work in private browsing)
  • No other dApp is currently using the wallet connection
Solution: Refresh the page and try connecting again. If issues persist, try disabling and re-enabling your wallet extension.

​
Connection Fails or Times Out

If the connection times out:
  1. Check that your wallet is unlocked
  2. Verify you’re on the correct network (mainnet/testnet)
  3. Clear your browser cache and try again
  4. Try a different wallet if available

​
Wrong Network Connected

Staxiq works on both Stacks mainnet and testnet. Make sure your wallet is connected to the network you intend to use.
Testnet is useful for exploring Staxiq features without risking real funds.

​
Portfolio Shows Zero Balance

If your wallet connects but shows zero balances:
  • Wait 30 seconds for the first data refresh
  • Verify your wallet actually has STX/sBTC on the connected network
  • Check the browser console for API errors
  • The Hiro API may be experiencing delays

​
Security Best Practices

Verify Domain

Always check you’re on the official Staxiq domain before connecting

Review Permissions

Only approve read-access permissions during connection

Keep Wallet Updated

Use the latest version of your wallet extension

Never Share Keys

Staxiq will never ask for your private keys or seed phrase

​
Next Steps

Now that your wallet is connected, you can:

Build docs developers (and LLMs) love

Get started for freeTalk to us