Fetch the status of your Vanguard investment funds as JSON
Last updated 2 years ago by mheap .
MIT · Original npm · Tarball · package.json
$ cnpm install vanguard-funds 
SYNC missed versions from official npm registry.

Vanguard Funds

This tool uses Puppeteer to log in to your Vanguard account and fetch your current fund status. The current date (UTC) and all of your fund information will be written to stdout as JSON.


npm install vanguard-funds


There are three ways to provide authentication details to this tool.

  • If you provide a config file that only contains username but not password, the command will prompt you for a username and a password. You can press enter to skip the username field and it will default to your config file value
  • Command line arguments override configuration files

Config file

Create ~/.vanguard/credentials with the following contents, replacing the values with your credentials:


Command line parameters

vanguard-funds -u myusername123 -p this1s4pAssw0rD

Let the tool prompt you

If you don't provide a config file or command line arguments, the tool will prompt you to input your credentials when it runs (don't worry, the password is masked).


Assuming that you've configured your credentials correctly, all you need to do is run vanguard-funds on the command line


If you put your Vanguard password in a config file or on the command line history, make sure that no-one else can read those files.

I run this on the command line, passing my Vanguard password as a parameter, populated from 1Password:

vanguard-funds -p $(op get item VanguardInvestments | jq -r '.details.fields[] | select(.designation == "password").value')

Current Tags

  • 0.0.3                                ...           latest (2 years ago)

3 Versions

  • 0.0.3                                ...           2 years ago
  • 0.0.2                                ...           2 years ago
  • 0.0.1                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 3
Last Day 0
Last Week 1
Last Month 1
Dependencies (4)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2017 © |