Documentación de Portfolio Tools

🌐 Language / Idioma: English Español (actual)

Portfolio Toolkit es una biblioteca completa de Python para gestión, análisis y visualización de carteras. Soporta carteras multi-moneda con conversión automática de divisas, cálculo de costos FIFO y análisis avanzados.

Características

Soporte Multi-Moneda: Maneja carteras con transacciones en diferentes divisas (USD, EUR, CAD, etc.)
Cálculo de Costos FIFO: Seguimiento preciso de base de costo usando metodología First-In-First-Out
Conversión Automática de Divisas: Conversión de divisas en tiempo real con tipos de cambio configurables
Análisis de Carteras: Herramientas de análisis integral incluyendo rendimientos, composición y seguimiento de evolución
Visualización de Datos: Capacidades de gráficos enriquecidas para análisis de composición y rendimiento de carteras
Exportación CSV: Exporta datos de transacciones y posiciones de carteras a formato CSV
Interfaz CLI: Herramientas de línea de comandos potentes construidas con Click para análisis de carteras, visualización de datos e investigación de mercados

Inicio Rápido

Instalación

pip install portfolio-toolkit

Uso Básico (CLI)

La forma más fácil de comenzar es usando la interfaz de línea de comandos:

# Ver comandos disponibles
portfolio-toolkit --help

# Mostrar posiciones actuales de la cartera
portfolio-toolkit portfolio positions portfolio.json 2025-07-30

# Ver transacciones de la cartera
portfolio-toolkit portfolio transactions portfolio.json

# Analizar rendimiento en el tiempo
portfolio-toolkit portfolio performance portfolio.json

# Generar gráfico de evolución de la cartera
portfolio-toolkit portfolio evolution portfolio.json

Uso de la Biblioteca

Para acceso programático, puedes usar la biblioteca de Python:

from portfolio_toolkit.data_provider.yf_data_provider import YFDataProvider
from portfolio_toolkit.portfolio.load_portfolio_json import load_portfolio_json
from portfolio_toolkit.cli.commands.utils import load_json_file

# Cargar cartera
data = load_json_file('portfolio.json')
data_provider = YFDataProvider()
portfolio = load_portfolio_json(data, data_provider=data_provider)

Para uso detallado de la biblioteca, ve Ejemplos de Uso Básico.

Formato JSON de Cartera

Crea un archivo JSON de cartera para empezar. Para documentación detallada del formato, ve Formato JSON de Cartera.

{
  "name": "My Investment Portfolio",
  "currency": "USD",
  "account": [
    {
      "date": "2023-01-15",
      "type": "deposit",
      "amount": 10000,
      "currency": "USD"
    }
  ],
  "assets": [
    {
      "ticker": "AAPL",
      "transactions": [
        {
          "date": "2023-01-20",
          "type": "buy",
          "quantity": 50,
          "price": 150.25,
          "currency": "USD"
        }
      ]
    },
    {
      "ticker": "MSFT",
      "transactions": [
        {
          "date": "2023-02-10",
          "type": "buy",
          "quantity": 30,
          "price": 280.50,
          "currency": "USD"
        }
      ]
    }
  ]
}

Interfaz de Línea de Comandos

El CLI proporciona herramientas poderosas para el análisis de cartera:

# Comandos de análisis de cartera
portfolio-toolkit portfolio transactions portfolio.json              # Ver transacciones
portfolio-toolkit portfolio positions portfolio.json 2025-07-30     # Posiciones actuales
portfolio-toolkit portfolio performance portfolio.json               # Análisis de rendimiento
portfolio-toolkit portfolio evolution portfolio.json                 # Gráfico de evolución

# Opciones de exportación
portfolio-toolkit portfolio transactions portfolio.json --output transactions.csv
portfolio-toolkit portfolio performance portfolio.json --output performance.csv

# Análisis de rendimiento con diferentes períodos de tiempo
portfolio-toolkit portfolio performance portfolio.json --period-type months -n 6
portfolio-toolkit portfolio performance portfolio.json --period-type quarters -n 4

Para documentación completa del CLI, ve Ejemplos de Uso de CLI.

Guía de Usuario

Guía de Usuario

Referencia de API

Documentación de API

Pruebas

Pruebas