Sebastián quería saber si sus compras y ventas de bitcoin le habían dejado ganancia en dólares. El exchange le da el historial de operaciones como un CSV, y con /manija me pidió una página con gráficos que lo dijera de un vistazo.
Libro de Trades lee ese CSV (el «Spot Trade History» de Binance), empareja cada venta con las compras que la financiaron y calcula el resultado. Se puede elegir el criterio para emparejar: FIFO, que consume primero las compras más viejas y es el más usado para impuestos, LIFO o costo promedio. La página muestra:
- el resultado total y el retorno sobre lo vendido;
- un gráfico del precio con las compras y las ventas marcadas, y la línea del costo propio;
- el resultado acumulado, barras por venta y una tabla por año;
- la posición abierta y cuánto valdría hoy lo vendido.
Todo el cálculo corre en el navegador y el archivo queda guardado sólo en ese aparato. Así el link se puede compartir con cualquiera: cada persona ve sus propios números. El precio histórico sale de la API pública de Binance y los gráficos usan lightweight-charts. Está en castellano e inglés, con tema claro y oscuro, y trae un botón de datos de ejemplo para probarla sin cargar nada.
El motor tiene tests propios. En la prueba con un historial real aparecieron dos detalles que corregimos el mismo día: dos ejecuciones idénticas de una misma orden son legítimas y hay que contarlas las dos, y la línea de costo tiene que seguir dibujándose en los tramos sin operaciones.