- Bitcoin and Ethereum address tracking - Identifies first purchase from exchanges - Interactive CLI mode with historical price lookup links - Test suite with public addresses - Documentation for Claude Code 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
🔍 Crypto Address Tracker - Găsește Prima Achiziție
Program Python care urmărește automat adresele de Bitcoin și Ethereum pentru a găsi prima ta achiziție - esențial pentru calculul impozitului pe crypto în România.
📋 Ce face programul?
✅ Analizează orice adresă Bitcoin sau Ethereum
✅ Urmărește toate tranzacțiile înapoi în timp
✅ Identifică exchange-uri cunoscute (Binance, Coinbase, Kraken, etc.)
✅ Găsește prima ta achiziție cu data exactă
✅ Îți oferă link-uri pentru a verifica prețul istoric
🚀 Instalare
Pas 1: Instalează Python
Dacă nu ai Python instalat:
- Windows: Descarcă de la python.org
- Mac:
brew install python3 - Linux:
sudo apt install python3 python3-pip
Pas 2: Instalează dependențele
pip install -r requirements.txt
SAU simplu:
pip install requests
💻 Cum se folosește
Mod 1: Interactiv (cel mai simplu)
python crypto_tracker.py
Apoi urmează instrucțiunile pe ecran:
- Alege Bitcoin sau Ethereum
- Introdu adresa ta de wallet
- (Pentru Ethereum) Optional: adaugă API key de la Etherscan
Mod 2: În cod (pentru programatori)
Bitcoin
from crypto_tracker import CryptoTracker
tracker = CryptoTracker()
results = tracker.track_bitcoin_address('1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa')
if results['first_purchase']:
print(f"Prima achiziție: {results['first_purchase']['date']}")
print(f"Exchange: {results['exchange_found']}")
Ethereum
tracker = CryptoTracker()
results = tracker.track_ethereum_address('0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb')
if results['first_purchase']:
print(f"Prima achiziție: {results['first_purchase']['date']}")
📱 Unde găsești adresa ta de wallet?
Bitcoin
- Blockchain.com wallet: Settings → Addresses
- Ledger/Trezor: În aplicația wallet-ului
- Exchange (Binance, etc): Wallet → Deposit → Bitcoin → Vezi adresa
Ethereum
- MetaMask: Click pe numele contului pentru a copia adresa
- MyEtherWallet: Se vede în dashboard
- Exchange: Wallet → Deposit → Ethereum → Vezi adresa (începe cu 0x)
🎯 Ce informații vei primi?
Programul îți arată:
- ✅ Data primei achiziții (FOARTE IMPORTANT pentru impozit!)
- ✅ Exchange-ul sursă (Binance, Coinbase, etc.)
- ✅ Suma primită
- ✅ Hash-ul tranzacției (pentru verificare)
- ✅ Link direct către blockchain explorer
- ✅ Link pentru preț istoric
📊 Exemplu de rezultat
🔍 Tracking Bitcoin address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
======================================================================
✅ Found 15 transactions
📊 REZULTATE:
======================================================================
🎯 PRIMA ACHIZIȚIE GĂSITĂ!
Exchange: BINANCE
Data: 2021-03-15 14:23:45
Sumă: 0.50000000 BTC
Hash: 3a4b5c6d7e8f9g0h1i2j3k4l5m6n7o8p9q0r1s2t3u4v5w6x7y8z9
🔗 Vezi tranzacția: https://blockchain.com/btc/tx/3a4b5c6d...
💰 Pentru preț istoric, verifică:
https://coinmarketcap.com/currencies/bitcoin/historical-data/
Data: 2021-03-15
💡 Următorii pași după ce găsești data
- Notează data primei achiziții
- Mergi pe CoinMarketCap/CoinGecko și caută prețul istoric pentru acea dată
- Acesta este prețul tău de achiziție pentru calculul impozitului
- Calculează profitul: Preț vânzare - Preț achiziție = Profit
- Impozit = Profit × 10%
🔑 API Key pentru Ethereum (Optional)
Pentru rezultate mai rapide la Ethereum, obține un API key gratuit:
- Mergi la etherscan.io/apis
- Creează cont gratuit
- Generează API key
- Folosește-l când programul te întreabă
Fără API key: 5 requests/secundă (suficient pentru majoritatea cazurilor)
Cu API key: Rate limit mai mare
⚠️ Limitări
- Bitcoin: Identifică exchange-uri majore, dar nu toate
- Ethereum: Trebuie verificat manual pe Etherscan dacă adresa are tag de exchange
- Privacy coins (Monero): Nu pot fi urmărite
- Mixere/Tumblers: Greu de urmărit
- Transfer între wallet-uri proprii: Trebuie urmărit manual mai departe
🛡️ Securitate
✅ 100% Safe: Programul folosește doar API-uri publice
✅ Read-only: Nu are acces la private keys
✅ Nu trimite date: Totul rulează local pe calculatorul tău
✅ Open source: Poți verifica codul
🐛 Probleme comune
"ModuleNotFoundError: No module named 'requests'"
pip install requests
"No transactions found"
- Verifică că adresa este corectă
- Unele adrese noi pot să nu aibă istoric încă
"API rate limit exceeded" (Ethereum)
- Așteaptă 1 minut și încearcă din nou
- SAU obține un API key gratuit de la Etherscan
Nu găsește exchange-ul
- Programul arată primele tranzacții
- Verifică manual pe blockchain explorer dacă exchange-ul are tag
📞 Suport
Dacă întâmpini probleme:
- Verifică că ai Python 3.7+:
python --version - Verifică că ai instalat
requests:pip list | grep requests - Rulează cu debug:
python -v crypto_tracker.py
🎓 Pentru dezvoltatori
Extensii posibile
- Adaugă suport pentru mai multe blockchain-uri (Solana, Cardano, etc.)
- Integrare cu CoinMarketCap API pentru prețuri istorice automate
- Export către Excel/CSV
- GUI cu Tkinter sau web interface cu Flask
Structura codului
crypto_tracker.py
├── CryptoTracker class
│ ├── track_bitcoin_address() # Analizează Bitcoin
│ ├── track_ethereum_address() # Analizează Ethereum
│ ├── _check_exchange() # Verifică exchange-uri cunoscute
│ └── _display_results() # Afișează rezultate formatate
└── main() # Mod interactiv
📄 Licență
Free to use, modify, and distribute. Folosește-l responsabil!
⭐ Dacă te ajută
Dacă programul te ajută să îți calculezi corect impozitul, share it cu alții care au nevoie! 🚀