FIFO Cripto-Tax Tool 🇪🇸

Herramienta profesional para el cálculo de ganancias y pérdidas patrimoniales por el método FIFO, diseñada específicamente para la declaración de la renta en España (IRPF).

🚀 Características Principales

• Multi-Exchange: Soporte directo para exportaciones CSV de Binance y Kraken, además del formato estándar de CoinTracking.
• Precisión Diaria Oficial: Integra automáticamente el histórico de tipos de cambio del Banco Central Europeo (BCE) para valorar cada operación en EUR con rigor legal.
• Detección de Permutas: Desdobla automáticamente operaciones crypto-crypto (ej: comprar BTC con USDT) generando el evento de venta correspondiente exigido por la AEAT.
• Ajuste de Stablecoins: Lógica especial para evitar ganancias/pérdidas ficticias por fluctuaciones insignificantes en USDT, USDC, DAI, etc.
• Consolidación de Historial: Capacidad de unir múltiples fuentes para rastrear el coste de adquisición original aunque el activo se haya movido entre exchanges.

🛠 Instalación

1. Clona el repositorio.
2. Instala las dependencias necesarias:

   pip install -r requirements.txt

3. Descarga el histórico del BCE (opcional, el script lo intentará hacer solo):

   curl -L "https://data-api.ecb.europa.eu/service/data/EXR/D.USD.EUR.SP00.A?format=csvdata" -o eur_usd_daily.csv

📈 Modo de Uso

1. Vía API (Descarga Directa)

Configura tus claves en un archivo .env (usa .env.example como plantilla) y ejecuta:

python main_api.py --binance --kraken -y 2025

2. Vía CSV (Recomendado para la Declaración Final)

Si prefieres usar archivos descargados manualmente:

# 1. Consolidar archivos de distintos exchanges
python3 -c "import pandas as pd; from fifo_ct import normaliza_cols; df1=pd.read_csv('kraken.csv'); df1=normaliza_cols(df1); df2=pd.read_csv('binance.csv'); df2=normaliza_cols(df2); total=pd.concat([df1, df2], ignore_index=True); total.to_csv('consolidado.csv', index=False)"

# 2. Ejecutar motor FIFO
python fifo_ct.py consolidado.csv -y 2025

📂 Informes Generados

El script genera dos archivos fundamentales:

1. *_detalle.csv: Desglose segundo a segundo de cada venta, justificando el lote FIFO consumido y el cambio aplicado. Guárdalo como prueba ante inspecciones.
2. *_resumen.csv: Totales por moneda y tipo de contraprestación para rellenar directamente las casillas de la Renta.

⚖️ Aviso Legal

Esta herramienta es una ayuda para el cálculo fiscal. Los resultados deben ser validados por el usuario o un asesor profesional antes de presentarlos a la Agencia Tributaria.