portfolio-monitor

Monitors portfolio holdings by fetching prices and computing profit/loss.

4|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/alexhegit/sovereign-IQ --skill portfolio-monitor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: portfolio-monitor
Source: https://github.com/alexhegit/sovereign-IQ/tree/main/workspace/skills/portfolio-monitor
Command: npx skills add https://github.com/alexhegit/sovereign-IQ --skill portfolio-monitor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yfinance, and includes scripts (resource) components.

What problem does it solve?

It helps you monitor a multi-asset investment portfolio by automatically fetching current prices, calculating cost and profit/loss, and flagging positions that move beyond your alert threshold.

Core Features & Use Cases

  • Portfolio tracking: Keeps track of holdings across multiple currencies (e.g., HKD, USD) and computes total value, total cost, and overall profit/loss.
  • Per-position analytics: Calculates each holding’s current price, market value, profit/loss amount, and profit/loss percentage.
  • Price movement alerts: Triggers reminders when a holding’s move exceeds the configured threshold (default 5%).
  • Use Case: If you hold Tencent, Apple, and BTC in different currencies, you can run this Skill to get an updated snapshot of totals plus per-asset gains/losses and see which positions crossed your alert threshold.

Quick Start

Install the required package and run the portfolio monitoring script to generate the latest portfolio report.

Frequently Asked Questions about portfolio-monitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track profit and loss across multiple stock and cryptocurrency holdings?

To track profit and loss across multiple stock and cryptocurrency holdings, you configure your assets and cost basis in a local YAML or JSON file, and the script fetches real-time prices via yfinance to compute per-position and total portfolio value.

How do I get price movement alerts when my portfolio holdings change significantly?

To get price movement alerts for your portfolio holdings, you set a percentage threshold in your configuration file, and the monitoring script flags any positions that move beyond that default 5% boundary in its snapshot report.

Can I calculate cost basis and market value for stocks and crypto held in different currencies?

Yes, you can calculate cost basis and market value for stocks and crypto held in different currencies like USD and HKD by defining them in your local settings file, which allows the script to compute overall profit and loss across the multi-asset portfolio.

How do I fetch real-time market prices for my local investment portfolio configuration?

To fetch real-time market prices for your local investment portfolio configuration, the script uses the yfinance Python library to retrieve current asset values and writes a portfolio state snapshot to local storage for your analysis.

Does yfinance support retrieving accurate real-time data for both stocks and cryptocurrency?

Yes, yfinance supports retrieving real-time market prices for both traditional stocks and cryptocurrency, allowing you to calculate current market value and profit metrics for a mixed-asset investment portfolio within a single tracking workflow.

What are the limitations of using a YAML configuration file for portfolio monitoring?

A limitation of using a YAML configuration file for portfolio monitoring is that you must manually maintain your holdings and settings data, meaning the script only processes static local inputs rather than syncing directly with live brokerage accounts.