ghostfolio-importer is a simple utility to import transactions from Scalable Capital and Trade Republic into Ghostfolio.
npx ghostfolio-importer transform [options]
We use the following internal format for transactions.
| Property | Mandatory | Value | Description |
|---|---|---|---|
| type | true | BUY, SELL, DIVIDEND |
|
| ISIN | true | string | |
| quantity | true | number | |
| price | true | number | |
| currency | true | EUR, USD |
|
| date | true | date | |
| _meta | false | any |
Import transactions from Scalable Capital.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| input-filter | false | string | |
| input-dir | true | string | |
| input-provider | true | scalable-capital |
|
| input-format | true | pdf |
Import transactions from Trade Republic.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| input-filter | false | string | |
| input-dir | true | string | |
| input-provider | true | trade-republic |
|
| input-format | true | pdf |
Import transactions from a file using the internal transaction format.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| input-file | false | string | |
| input-provider | true | none |
|
| input-format | true | json, yaml |
Export transactions for Ghostfolio ...
| Option | Mandatory | Value | Description |
|---|---|---|---|
| output-provider | true | ghostfolio |
|
| output-format | true | console, yaml, json, endpoint |
|
| ghostfolio-account-id | true | string | |
| ghostfolio-map | false | string |
... into the console.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| output-format | true | console |
... into a file.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| output-format | true | json, yaml |
|
| output-file | true | string |
... into Ghostfolio.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| output-format | true | endpoint |
|
| ghostfolio-endpoint | true | string | |
| ghostfolio-token | true | string |
Export transactions not for a specific provider but using the internal transaction format.
| Option | Mandatory | Value | Description |
|---|---|---|---|
| output-provider | true | none |
|
| output-format | true | console |
- We do not support fees.
- We do not support taxes.
- We do only support EUR and USD.
- We do rely on a config to map ISINs to symbols that Ghostfolio understands.
- We do rely on transactions provided by PDF.
It is worth to check out the following projects.
ghostfolio, scalable capital, stock, stocks, ETF, ETFs, portfolio, import, importer, export, exporter, extract, pdf, json, yaml