Overview Staxiq provides comprehensive portfolio analytics for your Stacks wallet, showing your STX and sBTC balances, protocol positions, transaction history, and 30-day performance trends.
Portfolio Dashboard Components Your portfolio dashboard displays several key components:
Balance Overview Real-time STX and sBTC balances with USD valuations
Performance Chart 30-day portfolio value trend with percentage gains
Protocol Positions Active positions across detected DeFi protocols
Transaction History Recent wallet activity and interactions
Viewing Your Balances STX Balance Your STX holdings are displayed in the portfolio summary:
< div className = "bg-[#141c2e]/50 border border-[#2a3f6a] p-4 rounded-xl" > < p className = "text-sm text-[#8899bb] uppercase" > STX Balance </ p > < p className = "text-3xl font-bold text-white" > { stxBalance } < span className = "text-lg" > STX </ span > </ p > </ div >
sBTC Balance Your Bitcoin holdings on Stacks (sBTC) are highlighted:
< div className = "bg-bitcoin/10 border border-bitcoin/20 p-4 rounded-xl" > < p className = "text-sm text-bitcoin font-semibold uppercase" > sBTC Balance </ p > < p className = "text-3xl font-bold text-white" > { sbtcBalance } < span className = "text-lg" > sBTC </ span > </ p > </ div >
sBTC (Stacks Bitcoin) is a 1:1 Bitcoin-backed asset on Stacks. It represents actual BTC locked in the protocol.
30-Day Chart Staxiq generates a portfolio performance chart showing your value trend:
function generateChartData ( currentValue , address ) { const data = []; const days = 30 ; const baseValue = currentValue * 0.8 ; for ( let i = days ; i >= 0 ; i -- ) { const noise = ( customRandom () - 0.45 ) * currentValue * 0.08 ; const trend = ( currentValue - baseValue ) * (( days - i ) / days ); data . push ({ day: i === 0 ? 'Today' : ` ${ i } d` , value: parseFloat ( Math . max ( 0 , baseValue + trend + noise ). toFixed ( 2 )), }); } return data . reverse (); }
The chart displays:
X-axis : Time period (30 days ago to today)Y-axis : Portfolio value in USDGradient fill : Visual representation of value trendPerformance badge : Percentage gain/loss with direction indicator
Hover Over Chart
Hover over any point on the chart to see the exact portfolio value for that day: < CustomTooltip > < p style = { { color: '#F7931A' } } > $ { payload [ 0 ]. value . toLocaleString () } </ p > < p style = { { color: '#8899bb' } } > { payload [ 0 ]. payload . day } </ p > </ CustomTooltip >
Check Performance Badge
The performance badge shows your overall gain: < span style = { { background: '#22c55e22' , color: '#22c55e' , border: '1px solid #22c55e44' } } > ↑ +12.5% </ span >
Compare Time Periods
Use the chart to identify trends and compare your current value to previous periods.
Detecting Protocol Positions Staxiq automatically detects which DeFi protocols you have active positions in by analyzing:
Token Balances : Checks for protocol receipt tokens (stSTX, LP tokens, etc.)Transaction History : Identifies recent interactions with protocol contracts
How Protocol Detection Works export async function detectWalletProtocols ( address ) { // Fetch token balances and recent transactions const [ tokenBalances , recentTxs ] = await Promise . all ([ fetchTokenBalances ( address ), fetchRecentTxs ( address ), ]); const detected = []; for ( const protocol of PROTOCOL_CONTRACTS ) { const tokenBalance = tokenBalances [ protocol . tokenContract ]?. balance ?? '0' ; const hasToken = BigInt ( tokenBalance ) > 0 n ; // Check if wallet has transacted with protocol const hasInteracted = recentTxs . some ( tx => tx . contract_call ?. contract_id ?. startsWith ( protocol . contractAddr ) ); if ( hasToken || hasInteracted ) { detected . push ({ ... protocol , balance: tokenBalance , confidence: hasToken ? 'confirmed' : 'likely' , }); } } return detected ; }
Supported Protocol Detections Staxiq can detect positions in:
StackingDAO stSTX liquid stacking tokens
ALEX Lab atALEX auto-compounding positions
Zest Protocol zsBTC lending positions
Bitflow LP tokens for liquidity pools
Hermetica USDh synthetic dollar positions
Velar LP tokens and perpetuals
Protocol Contract References Here are the contract addresses Staxiq monitors:
const PROTOCOL_CONTRACTS = [ { id: 'stackingdao' , name: 'StackingDAO' , asset: 'stSTX' , tokenContract: 'SP4SZE494VC2YC5JYG7AYFQ44F5Q4PYV7DVMDPBG.ststx-token' , }, { id: 'zest' , name: 'Zest Protocol' , asset: 'zsBTC' , tokenContract: 'SP2VCQJGH7PHP2DJK7Z0V48AGBHQAW3R3ZW1QF4N.zest-reward-dist' , }, { id: 'alex' , name: 'ALEX Lab' , asset: 'atALEX' , tokenContract: 'SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.auto-alex-v3' , }, // ... more protocols ];
If you hold protocol tokens but they’re not showing up, wait for the next refresh cycle (30 seconds) or check that you’re on the correct network.
Understanding Your Data Portfolio Refresh Cycle Your portfolio data automatically refreshes:
useEffect (() => { fetchPortfolio (); // Auto-refresh every 30 seconds const interval = setInterval ( fetchPortfolio , 30000 ); return () => clearInterval ( interval ); }, [ address ]);
Initial load : When you first connectAutomatic refresh : Every 30 secondsManual refresh : Reload the page
Data Sources Staxiq pulls data from:
Hiro API : For wallet balances and transaction historyStacks Blockchain : For real-time network dataDeFi Llama : For protocol TVL and APY dataCoinGecko : For STX price data
Analyzing Your Activity
Check Total Value
Review your total portfolio value in USD, calculated from: totalUSD = ( stxBalance * stxPrice ) + ( sbtcBalance * btcPrice )
Identify Protocol Positions
See which protocols you’re actively using in the “Wallet Protocols” section.
Review Transaction Count
Your transaction count (txCount) influences AI strategy recommendations:
< 3 txs : Considered a new user, gets beginner-friendly advice> 20 txs : Considered experienced, gets advanced strategies
Track Performance Trend
Use the 30-day chart to understand if your portfolio is growing or declining.
Portfolio Insights New User Detection If you’re new to Stacks DeFi, Staxiq provides extra context:
const isNewUser = strategyCount === 0 && txCount < 3 ; if ( isNewUser ) { // Shows beginner-friendly explanations // Recommends safe starting protocols // Provides educational content }
Experienced User Recognition For experienced users, Staxiq offers advanced insights:
const isExperienced = strategyCount > 5 || txCount > 20 ; if ( isExperienced ) { // Advanced multi-protocol strategies // Yield optimization tactics // Compounding recommendations }
Troubleshooting Portfolio Shows ”—” or Loading State If your portfolio stays in loading state:
Check your internet connection
Verify the Hiro API is accessible
Try disconnecting and reconnecting your wallet
Clear browser cache and refresh
Protocol Positions Not Detected If you know you have a protocol position but it’s not showing:
Ensure you hold the protocol’s receipt token (not just the base asset)
Check that you’ve completed the deposit transaction
Wait for the next blockchain confirmation
Verify you’re on the correct network
The chart uses your current value and address to generate historical data. If it seems stuck:
// Chart regenerates when these values change: const data = useMemo (() => generateChartData ( value , address ), [ value , address ] );
Disconnect and reconnect to force a regeneration.
Next Steps With your portfolio analyzed, you can:
