hermes is a lightweight finance API for personal/private use. It currently provides:

• Currency conversions

I plan to add:

• Stock market graph generation

hermes fetches data using the yfinance python library from Yahoo Finance.

• Easy-to-use endpoints for currency data
• Simple setup for personal projects or experimentation

You may run the process in the background using PM2 or systemd on supported linux distributions.

By default, the API runs on port 8000. You can change this by editing start.sh.

chmod +x start.sh
./start.sh

# with pm2
pm2 start start.sh --name "hermes"

hermes is licensed under the MIT License. See the LICENSE file for details.

hermes is not affiliated, endorsed, or vetted by Yahoo, Inc. You should refer to Yahoo!'s terms of use for details on your rights to use the actual data downloaded.

cosmicle 2025.