crypto-tracker/README.md

🔍 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:

1. Alege Bitcoin sau Ethereum
2. Introdu adresa ta de wallet
3. (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

1. Notează data primei achiziții
2. Mergi pe CoinMarketCap/CoinGecko și caută prețul istoric pentru acea dată
3. Acesta este prețul tău de achiziție pentru calculul impozitului
4. Calculează profitul: Preț vânzare - Preț achiziție = Profit
5. Impozit = Profit × 10%

🔑 API Key pentru Ethereum (Optional)

Pentru rezultate mai rapide la Ethereum, obține un API key gratuit:

1. Mergi la etherscan.io/apis
2. Creează cont gratuit
3. Generează API key
4. 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:

1. Verifică că ai Python 3.7+: python --version
2. Verifică că ai instalat requests: pip list | grep requests
3. 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! 🚀