Check Wallet Tax Liability

WHAT IT DOES

This tool connects to your MetaMask wallet and provides a rough estimate of potential tax liability by analyzing incoming transfers. It scans a configurable block range for transactions sent to your wallet, values each incoming transfer using historical ETH price data at the time of receipt, and applies a default estimated tax rate to calculate a potential tax figure. The tool displays total income received, estimated tax liability, and a list of individual incoming transfers with their USD values. All data is processed locally — the only external call is to CoinGecko for historical price data.

HOW TO USE

Connect your MetaMask wallet using the Connect button. Enter the number of recent blocks to scan (default 5000) — larger values find more transfers but take longer. Click "Estimate Tax" to start the scan. The tool will show progress as it scans blocks in chunks. Once complete, you'll see total income received, estimated tax liability (using a default 20% effective rate), and a list of incoming transfers with their USD values at the time of receipt. A warning banner reminds you that this is a rough estimate only.

TECHNICAL MECHANISM

The tool uses the BGWallet bridge to access the blockchain provider via ethers.js. It implements a robust chunked scanning strategy to handle varying RPC eth_getLogs limits — when the RPC returns a "limit exceeded" error, the tool halves the chunk size and retries, ensuring scanning completes even on restrictive providers. For each transaction hash found, it fetches the full transaction and receipt, extracting the ETH value transferred and the block number. It then fetches the block timestamp to determine when the transfer occurred. For each incoming transfer, it queries CoinGecko's historical price API for the ETH price on that date, multiplies the transfer amount by the price to get an estimated USD value. Total income is summed, and a default 20% effective tax rate is applied to estimate potential tax liability.

WHAT IT CANNOT SEE

This tool cannot provide accurate tax liability without complete transaction history, cost basis, and jurisdiction-specific tax rules. It cannot account for tax-loss harvesting, deductions, or exemptions that vary by jurisdiction. It cannot detect off-chain trades or transfers that occur outside the blockchain. It cannot account for tokens received via airdrops, mining, staking rewards, or other non-transaction sources. It cannot read transaction history beyond the RPC provider's block range limits. It cannot account for tokens bridged or swapped across chains. It cannot determine cost basis for tokens received without price data. It cannot account for NFTs or collectibles. It cannot provide tax advice or filing guidance. It cannot account for capital gains vs. income distinctions that vary by jurisdiction.

PLEASE NOTE

This tool works only with EVM-compatible wallets connected via the BGWallet bridge. The tax estimate is a rough approximation and should not be used for actual tax filing. Tax laws vary significantly by jurisdiction — this tool does not apply any specific tax code. Historical price data is fetched from CoinGecko's public API, which may have rate limits or be unavailable. The default 20% tax rate is an assumption and may not reflect your actual rate. The tool does not store or transmit any data — all processing occurs in your browser. This tool is provided for educational and estimation purposes only. Always consult a qualified tax professional for accurate tax guidance.