Registry / payments / ghostfolio

ghostfolio

JSON →
library0.8.0pypypi✓ verified 30d ago

Python API client for Ghostfolio, an open-source personal finance dashboard. Current version 0.8.0 enables portfolio management, holdings, activities, and admin operations. Release cadence is irregular.

paymentshttp-networkingcrm-productivity
github ↗package ↗homepage ↗
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

from ghostfolio import Ghostfolio

Initialize client with base URL and access token, then fetch holdings.

from ghostfolio import GhostfolioClient client = GhostfolioClient( base_url=os.environ.get('GHOSTFOLIO_URL', 'http://localhost:3000'), access_token=os.environ.get('GHOSTFOLIO_ACCESS_TOKEN', '') ) # Fetch all holdings holdings = client.get_holdings() print(holdings)
Debug
Known footguns
breakingIn version 0.4.0, the method `get_positions` was renamed to `get_holdings`. Old code will fail.
deprecatedAuthentication via `access_token` query parameter is deprecated; use header-based authentication (Authorization: Bearer <token>) which is the only supported method as of 0.8.0.
gotchaClient does not validate credentials on initialization; invalid tokens or URLs raise exceptions only on first API call. This can mask configuration errors.
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
0 hits · last 30 days

No traffic data recorded yet.

Resources
githubhttps://github.com/ms32035/ghostfolio-py ↗
packagehttps://pypi.org/project/ghostfolio/ ↗
homepagehttps://ghostfol.io ↗