A Better Crypto Tracker
ABCT is a privacy-first cryptocurrency portfolio tracker that aggregates wallet balances, exchange accounts, DeFi positions, NFT collections, and P&L tracking across 53 blockchains — all running on your own hardware.
Quick Start
Get up and running in three steps. No API keys are required for basic functionality — you can always add them later to unlock more features.
Architecture Overview
ABCT uses a four-layer architecture. The frontend talks to a FastAPI backend, which delegates to specialized service modules that call external blockchain and pricing APIs.
Frontend
Vanilla HTML/CSS/JS • Chart.js • TradingView widgets
FastAPI Backend
REST API routers • SQLite database • Session auth
Services Layer
Blockchain services • Exchange connectors • Price aggregator
External APIs
Blockfrost • Alchemy • Helius • CoinGecko • XRPL • Hedera • BlockCypher • TzKT • Hiro • Exchanges
Supported Blockchains
ABCT tracks on-chain balances, tokens, staking rewards, and NFTs across these networks.
Cardano
Bitcoin
Ethereum
Solana
Polygon
Base
Algorand
Tron
BSC
Arbitrum
Avalanche
XRP Ledger
Hedera
MultiversX
Sui
Aptos
Filecoin
Litecoin
Dogecoin
Zcash
Tezos
Stacks
VeChain
Cosmos
NEAR
ICP
Optimism
zkSync Era
Linea
Scroll
Fantom
Cronos
Gnosis
Moonbeam
Osmosis
Celestia
Injective
dYdX
Sei
Akash
TON
Polkadot
Kusama
Stellar
Kaspa
Kaia (Klaytn)
Ergo
IOTA
Waves
Mina
Zilliqa
Monero
Secret Network
API Key Guide
ABCT works without any API keys, but adding free keys dramatically improves data coverage. Here's what each tier unlocks.
✅ Tier 1: Works Without Any Keys
These APIs are public and require no authentication. Basic portfolio tracking works out of the box.
Blockstream
Bitcoin balances, UTXOs, and transaction history
TronGrid
Tron TRX and TRC-20 token balances
Algonode
Algorand ALGO and ASA token balances
DefiLlama
Fallback token pricing for all chains
Coinbase Public API
Spot prices for major pairs (no key needed)
CoinGecko (Free Tier)
Basic pricing with generous rate limits (30 calls/min)
XRPL Cluster
XRP Ledger balances and trust line tokens
Hedera Mirror Node
HBAR balances, HTS tokens, and proxy staking
MultiversX API
EGLD balances, ESDT tokens, and delegation staking
Sui JSON-RPC
SUI balances, coins, and validator staking
Aptos REST API
APT balances, coins, and validator staking
Glif RPC
Filecoin FIL balance tracking
BlockCypher
Litecoin and Dogecoin balance tracking
Blockchair
Zcash ZEC balance tracking
TzKT API
Tezos XTZ balances, FA tokens, and NFTs
Hiro API
Stacks STX balances, SIP-010 tokens, and NFTs
VeBlocks
VeChain VET balance tracking
PublicNode LCD
Cosmos ATOM balances, IBC tokens, and staking
NEAR RPC + NearBlocks
NEAR balances, NEP-141 tokens, and NFTs
Rosetta API
ICP balance tracking
🔑 Tier 2: Free API Keys
Sign up for free accounts at these providers to unlock full chain support and higher rate limits.
Alchemy
Ethereum, Polygon, Base, Arbitrum, Optimism, zkSync, Linea, Scroll: tokens, NFTs, balances
alchemy.com →Subscan
Polkadot DOT and Kusama KSM balances and tokens. Optional key for higher limits
subscan.io →⭐ Tier 3: Paid API Keys
Premium APIs that unlock advanced features like NFT floor prices and historical OHLCV chart data.
TapTools (~$10/mo)
Cardano NFT floor prices, token analytics, OHLCV history, portfolio insights
taptools.io →CoinGecko Pro
Higher rate limits (500 calls/min), historical data, advanced endpoints
coingecko.com →Exchange Integration
Connect centralized exchange accounts to include held balances in your portfolio. All connections are read-only.
Binance
Binance US
Coinbase
OKX
Bitget
KuCoin
Gate.io
Kraken
Bybit
HTX (Huobi)
MEXC
Bitfinex
Gemini
Crypto.com
Phemex
Poloniex
Bitstamp
Bittrex
BingX
AscendEX
LBank
Coinex
XT.com
DigiFinex
Exmo
Probit
Tidex
Latoken
BigONE
Whitebit
Upbit
Bithumb
Coinone
Indodax
Coinhako
Luno
Bitso
Mercado Bitcoin
Foxbit
CoinDCX
WazirX
DeFi Protocol Support
ABCT tracks staking, liquidity, and lending positions across 80+ DeFi protocols. Positions are detected automatically when you scan a wallet.
Cardano (13 Protocols)
Indigo Protocol
INDY governance staking and synthetic asset positions (iAssets)
Liqwid Finance
LQ governance staking and ADA/token lending positions
Strike Finance
STRIKE governance staking positions
Iagon
IAG token staking in decentralized storage network
Surf Lending
ADA supplied to Surf Lending (Flow Lending) protocol
Minswap
MIN governance staking and liquidity pool positions
SundaeSwap
SUNDAE governance staking and LP positions
WingRiders
WRT governance staking and AMM liquidity positions
VyFi
VYFI staking and yield farming positions
Optim Finance
OPTIM bond staking and liquidity positions
Genius Yield
GENS yield optimizer and DEX positions
Meld
MELD staking and lending protocol positions
Axo
AXO order-book DEX trading positions
EVM Chains (55+ Protocols)
Lido
stETH and wstETH liquid staking positions (Ethereum)
Rocket Pool
rETH liquid staking positions (Ethereum)
Chainlink Staking
Staked LINK and pending rewards via Chainlink v0.2
Aave v3
Lending and borrowing positions across EVM chains
Compound v3
Lending positions (Ethereum, Polygon, Arbitrum, Base)
Uniswap V3
Concentrated liquidity positions via The Graph
Curve Finance
Liquidity pool and gauge staking positions
Convex Finance
cvxCRV and Curve LP staking positions
Frax Finance
sFRAX, frxETH and liquid staking positions
EigenLayer
ETH and LST restaking positions
Pendle Finance
Yield tokenization positions and LP
Yearn Finance
Vault deposit positions (yTokens)
Solana (15 Protocols)
Marinade Finance
mSOL liquid staking positions
Jito
JitoSOL liquid staking and MEV rewards
Orca
Whirlpool concentrated liquidity positions
Marginfi
Lending and borrowing positions
Kamino Finance
Automated liquidity vaults and lending
Raydium
AMM and concentrated liquidity positions
Drift Protocol
Perpetuals and lending positions
Helium (HNT)
Hotspot rewards and veHNT staking
Pricing System
ABCT uses a multi-source pricing engine with automatic failover. If one source is rate-limited or down, the next one takes over seamlessly.
General Pricing Chain
Cardano Token Pricing
Cache TTL Tiers
| Tier | Duration | Data Type |
|---|---|---|
| Hot | 5 minutes | Prices, exchange balances, wallet balances |
| Warm | 1 hour | Analytics, charts, allocation breakdowns |
| Cold | 24 hours | NFT data, DeFi positions |
| Persistent | 7 days | Portfolio summary snapshots |
Security Tools
ABCT includes four dedicated wallet security scanners, accessible from the Data & Security tab. All scanners are read-only — they analyze your wallets but never modify wallet state, revoke approvals, or move funds.
Token Approval Security
When you interact with DeFi protocols, you grant ERC-20 token approvals that let smart contracts spend your tokens. Some approvals are set to unlimited amounts and remain active even after you stop using a protocol. If that contract is later compromised, an attacker can drain the approved tokens from your wallet.
This scanner checks your EVM wallets for:
• Unlimited approvals — contracts authorized to spend your entire token balance
• Stale approvals — active approvals for contracts you haven't interacted with recently
• Risky spenders — contracts flagged by security databases
To actually revoke an approval, use a tool like revoke.cash — ABCT identifies the risks, but revoking requires a wallet transaction.
Requires Moralis API key (free tier)
Spam Token Detection
Scammers airdrop worthless or malicious tokens to active wallets. These spam tokens clutter your portfolio and can be dangerous if you try to interact with them (some contain malicious approval logic).
This scanner identifies known spam and scam tokens using Moralis’s spam classification database. Detected spam tokens can be hidden from your portfolio display with one click. Hiding is display-only — the tokens still exist in your wallet on-chain, but they won’t affect your portfolio valuation or charts.
Requires Moralis API key (free tier)
Address Poisoning Scanner
Address poisoning is an attack where a scammer sends tiny (dust) transactions to your wallet from an address that looks almost identical to one you’ve transacted with before. The goal is to trick you into copying the wrong address from your transaction history when sending funds.
This scanner analyzes your transaction history for:
• Zero-value transfers — transactions with no real value, planted to appear in your history
• Lookalike addresses — addresses that share the same first and last characters as your real contacts
• Dust deposits — tiny amounts from unknown addresses designed to seed your history
Cardano Shield Scanner
Cardano has its own token threat ecosystem. This scanner cross-references your Cardano native tokens against two authoritative sources:
• Shield Blacklist — a community-maintained list of known malicious or scam Cardano tokens
• Cardano Foundation Token Registry — the official registry of verified legitimate tokens
Tokens that appear on the blacklist or are absent from the registry are flagged with risk levels. The scanner generates a per-wallet threat report you can review.
Feature Matrix
What you can do at each API configuration level.
| Feature | No Keys | Free Keys | All Keys |
|---|---|---|---|
| BTC / TRX / ALGO / XRP / HBAR / EGLD / SUI / APT / FIL / LTC / DOGE / ZEC / XTZ / STX / VET / ATOM / NEAR / ICP / FTM / CRO / xDAI / GLMR balances | ✓ | ✓ | ✓ |
| Basic price data | ✓ | ✓ | ✓ |
| Exchange balances | ✓ | ✓ | ✓ |
| ETH / SOL / ADA / OPT / zkSync / Linea / Scroll balances | ✗ | ✓ | ✓ |
| ERC-20 / SPL token balances | ✗ | ✓ | ✓ |
| NFT display & gallery | ✗ | ✓ | ✓ |
| Transaction history | ✗ | ✓ | ✓ |
| DeFi & staking tracking | ✗ | ✓ | ✓ |
| XRP trust lines / HBAR HTS tokens | ✓ | ✓ | ✓ |
| EGLD ESDT / SUI coins / APT coins | ✓ | ✓ | ✓ |
| HBAR / EGLD / SUI / APT / ATOM staking | ✓ | ✓ | ✓ |
| XTZ FA tokens / STX SIP-010 / ATOM IBC / NEAR NEP-141 | ✓ | ✓ | ✓ |
| XTZ / STX / NEAR NFTs | ✓ | ✓ | ✓ |
| Chainlink staking (ETH) | ✗ | ✓ | ✓ |
| Token logos | ✗ | Partial | ✓ |
| NFT floor prices | ✗ | ✗ | ✓ |
| Historical OHLCV charts | ✗ | ✗ | ✓ |
| Higher rate limits | ✗ | ✗ | ✓ |
| P&L / cost basis tracking | ✓ | ✓ | ✓ |
| DeFi protocol detection (80+ protocols) | ✗ | ✓ | ✓ |
| Token approval security (EVM) | ✗ | ✓ | ✓ |
| Spam token detection (EVM + SOL) | ✗ | ✓ | ✓ |
| Address poisoning scanner | ✓ | ✓ | ✓ |
| Cardano Shield threat scanner | ✓ | ✓ | ✓ |
Recommended Setup
For the best experience, add API keys in this priority order. Each step significantly improves data coverage.
-
Blockfrost High Impact
Unlocks full Cardano support: ADA, native tokens, staking rewards, NFTs, and DeFi positions. Essential if you hold any Cardano assets.
-
Alchemy High Impact
Covers Ethereum, Polygon, Base, and Arbitrum with a single key. Unlocks ERC-20 tokens, NFTs, and transaction history across 4 EVM chains.
-
Helius High Impact
Full Solana support including SPL tokens, compressed NFTs, and DeFi positions. Free tier is generous for personal use.
-
CoinMarketCap Medium Impact
Adds a pricing fallback source, improving price reliability. 10,000 free credits per month.
-
Etherscan Medium Impact
Ethereum transaction history and internal transactions. Useful for tracking gas costs and token transfers.
-
TapTools Optional
Paid (~$10/mo). Adds Cardano NFT floor prices, OHLCV charts, and advanced token analytics. Only needed for heavy Cardano users.
FAQ & Troubleshooting
Why are some token prices showing as $0 or missing?
This usually means the token isn't listed on any of your configured pricing sources. ABCT tries CoinGecko, CoinMarketCap, Coinbase, and DefiLlama in order. Very small or new tokens may not be listed on any of these.
For Cardano native tokens, adding TapTools provides the best coverage. Check the API Keys page to make sure your pricing APIs are configured.
I'm getting rate-limited. What should I do?
Rate limiting means you've hit the free tier call limit for an API. ABCT handles this automatically by switching to fallback sources and caching results.
If it happens frequently, consider upgrading to a paid CoinGecko plan or reducing refresh frequency. The cache system ensures your portfolio always shows recent data even during rate limits.
How do I clear cached data?
Go to Settings → Cache tab. You can clear all caches or selectively clear specific cache keys. The dashboard also has a refresh button that forces a fresh data fetch.
What permissions should I use for exchange API keys?
Always use read-only permissions. ABCT only needs to read your balances. Specifically:
• Enable: View/Read balances, View account info
• Disable: Trading, Withdrawals, Transfers, Futures
For OKX, Bitget, and KuCoin, you'll also need the passphrase you set during key creation.
How does Privacy Mode work?
Privacy Mode hides all dollar values and balances on screen. Toggle it from the user menu (avatar icon) in the top-right corner. Your data isn't deleted — it's just hidden from view. Useful for screen sharing or public environments.
Can I change the theme?
Yes! Open the user menu (avatar icon in the top-right) and use the Theme dropdown. Available themes: Dark Mode, Light, Cypherpunk 1, Ocean Depths, Sunset Horizon, and several Cypher variants. Your choice is saved in your browser.
How do I back up my data?
Go to Settings → Backup & Restore. You can export your wallets, API keys, and settings as an encrypted backup file. The same page lets you restore from a previous backup.
The SQLite database file is stored at data/portfolio.db — you can also copy this file directly for a full backup.
Why isn't my wallet balance updating?
Check a few things:
• API key configured? Most chains need an API key (see the API Key Guide above)
• Correct address format? Make sure the address matches the chain (e.g., addr1... for Cardano, 0x... for Ethereum)
• Cache stale? Try the refresh button or clear caches in Settings
Check Settings → Logs for any error messages from the backend.
What is cost basis tracking and P&L?
Cost basis tracking records what you originally paid for each asset so ABCT can calculate your unrealized and realized profit and loss (P&L). You can enter purchase prices and dates manually in the Transactions section.
P&L is calculated as: Current Value − Cost Basis. A positive value means you're in profit; negative means a loss relative to what you paid.
What costing methods are supported (FIFO, LIFO, Average)?
ABCT supports three cost basis accounting methods:
• FIFO (First In, First Out) — The oldest purchases are considered sold first. Most common for tax reporting.
• LIFO (Last In, First Out) — The newest purchases are considered sold first. Can minimize gains when prices rise.
• Average Cost — All purchases are averaged together. Simplest calculation.
The method can be configured per-asset or globally in the P&L settings. Consult a tax professional to determine which method is appropriate for your jurisdiction.
How do I add manual cost basis entries?
Go to the Transactions page and use the "Add Entry" button. You can specify:
• Asset and chain
• Purchase date and quantity
• Purchase price (cost basis)
• Transaction type (buy, sell, transfer, airdrop)
Manual entries are combined with automatically-fetched transaction history to calculate your overall P&L. You can also import a CSV file for bulk entry.
What are the security scanning tools and where do I find them?
ABCT includes four built-in wallet security scanners, all accessible from the Data & Security tab:
• Token Approval Security — scans ERC-20 approvals for unlimited spend, stale contracts, and risky spenders (requires Moralis API key)
• Spam Token Detection — identifies known spam/scam tokens so you can hide them from your portfolio (requires Moralis API key)
• Address Poisoning Scanner — detects dust attacks and lookalike addresses in your transaction history (no API key needed)
• Cardano Shield Scanner — cross-refs tokens against the Shield blacklist and CF Token Registry (no API key needed)
The Moralis API key is free to obtain. See the Security Tools section above for full details.
Do the security scanners modify my wallets or revoke approvals automatically?
No. All four scanners are completely read-only. They analyze your wallet data and report findings, but they never modify wallet state, revoke token approvals, or move any funds.
To revoke a risky token approval identified by the scanner, use a dedicated tool like revoke.cash — this requires connecting your wallet and signing a transaction.
Hiding spam tokens is display-only within ABCT — the tokens still exist on-chain but won’t show in your portfolio valuation or charts.