Skip to content

Latest commit

 

History

History
45 lines (32 loc) · 1.87 KB

README.md

File metadata and controls

45 lines (32 loc) · 1.87 KB
Raw

tl;dr

Displays a list of your last ~8 months of Gemini crypto transfers on the command line. Also displays your current total trading portfolio.

About

I wanted a quick way of retrieving my latest transfers from the command line, without fiddling with Gemini's web site or manual authentication. This does the job, and is based on https://docs.gemini.com/rest-api/#transfers

geminixferscreenshot

Getting Started

  1. git clone https://github.com/ulysseskan/geminitransfers.git
  2. cd geminitransfers
  3. pip3 install -r requirements.txt
  4. Within config.py, edit GEMINI_API_KEY, GEMINI_API_SECRET, obtainable from https://exchange.gemini.com/settings/api The key needs read-only auditor permissions and time based nonces.
  5. python3 geminitransfers.py

Prerequisites

You need a copy of Python 3. I only tested with Python 3.10. One way to install Python 3 is:

  1. Install Brew.
  2. brew install python3
  3. Ensure Brew's executable bin directory is in your PATH variable, for example:
    echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.profile

Potential improvements

  • SSL certificate verification could be enabled by setting verify=True in the requests.post() method, and the hashlib module could be used to encode the API secret properly
  • Don't use time-based nonces
  • Filter transfers by date range or specific months
  • Calculate and display total values of each currency in portfolio
  • Add pagination support to handle large amounts of transfers

Limitations

The transfers API request path has an undocumented limitation: it can only retrieve the last 8 or so months of data.

License

Distributed under the MIT License. See LICENSE for more information.