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](https://www.python.org/downloads/)
- Mac: `brew install python3`
- Linux: `sudo apt install python3 python3-pip`

### Pas 2: Instalează dependențele
```bash
pip install -r requirements.txt
```

SAU simplu:
```bash
pip install requests
```

## 💻 Cum se folosește

### Mod 1: Interactiv (cel mai simplu)
```bash
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
```python
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
```python
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](https://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'"
```bash
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! 🚀