A specialized skill for querying Ghostfolio portfolio metrics, holdings, and dividend data via automated API interactions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ghostfolio
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ghostfolio using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Ghostfolio?
The Ghostfolio skill for Openclaw Skills provides a robust interface for developers and investors to programmatically access their financial data. By leveraging this skill, users can monitor portfolio performance, audit current holdings, and track dividend payouts directly through their AI agent. It is designed to bridge the gap between self-hosted finance dashboards and intelligent automation, offering a streamlined way to extract wealth management insights.
This integration is particularly valuable for those maintaining personal finance stacks who need a reliable way to interact with the Ghostfolio API. It handles the nuances of financial data retrieval, ensuring that complex metrics are fetched accurately and efficiently within the Openclaw Skills ecosystem.
Ghostfolio Use Cases
- Tracking year-to-date (YTD) portfolio performance and net worth fluctuations.
- Auditing asset holdings and distribution across different investment accounts.
- Grouping and analyzing dividend income by month for tax or budgeting purposes.
- Troubleshooting Ghostfolio API connectivity and authentication states in self-hosted environments.
How Ghostfolio Works
- The skill first identifies the Ghostfolio instance location via the GHOSTFOLIO_BASE_URL environment variable.
- It attempts to establish a secure connection using the provided GHOSTFOLIO_TOKEN.
- The skill evaluates the required authentication mode, supporting both direct bearer tokens and anonymous exchange patterns to retrieve a valid session.
- It executes targeted curl commands to specific API endpoints such as performance, holdings, or dividends.
- Resulting JSON data is processed and formatted using jq to provide the user with clear, actionable financial summaries.
Ghostfolio Setup
To get started with this skill in your Openclaw Skills environment, configure your local environment variables:
# Define your Ghostfolio instance URL
export GHOSTFOLIO_BASE_URL="http://127.0.0.1:3333"
# Provide your long-lived access token
export GHOSTFOLIO_TOKEN="your_secret_token"
# Optional: Set your local timezone for accurate reporting
export GHOSTFOLIO_TIMEZONE="Europe/Paris"
Ghostfolio Data Schema & Taxonomy
The Ghostfolio skill organizes data retrieval into clear categories for optimal analysis within Openclaw Skills:
| Data Type | API Endpoint | Key Metadata |
|---|---|---|
| Performance | /api/v2/portfolio/performance | Range (e.g., ytd), Net Worth, Performance % |
| Holdings | /api/v1/portfolio/holdings | Asset Name, Quantity, Value, Timezone |
| Dividends | /api/v1/portfolio/dividends | Monthly Groups, Payout Amount, Currency |
Ghostfolio Advanced Features
- Multi-mode authentication support for handling both standard and anonymous exchange token flows.
- Automated connectivity probing to detect and diagnose 401 Unauthorized or 403 Forbidden errors.
- Explicit timezone handling via x-ghostfolio-timezone headers to prevent data drift in financial reports.
- Integration with jq for advanced filtering of complex JSON responses within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Nmap Recon
A comprehensive network reconnaissance tool for port scanning, service detection, and security auditing using the Nmap engine.
Devtopia
A compounding tool ecosystem designed for AI agents to create, discover, and compose functional tools for each other.
Devtopia Identity
Securely manage wallet-backed on-chain agent identities and cryptographic proofs on the Base blockchain.
Task System
A complete task lifecycle management system with SQLite persistence and automated monitoring for AI agents.
Beautiful Mermaid
A high-performance, zero-dependency engine for rendering Mermaid diagrams into themed SVGs or terminal-friendly ASCII art.
PinMe - IPFS Deployment
Deploy static websites to the decentralized IPFS network with a single command and zero server configuration.
Featured*
