11 releases

0.4.0 Mar 2, 2025
0.3.4 Feb 10, 2025
0.3.0 Apr 1, 2024
0.2.0 Mar 4, 2024
0.0.3 Feb 27, 2024

#334 in Filesystem

Apache-2.0

66KB
590 lines

Wen moon?

GitHub Actions CI Workflow Status GitHub Actions Release Workflow Status Crates.io Version

Your crypto portfolio and terminal together at last 🤝

wen moon?

Installation

From cargo

cargo install wenmoon --locked

Build from source

git clone https://github.com/shapeshed/wenmoon
cd wenmoon
cargo install --path .

Configuration

The following are supported as data providers

CoinMarketCap

Obtain a CoinMarketCap API key. Create a file at ~/.config/wenmoon/config.toml. Ticker values can be found by searching on CoinMarketCap.

amount and entry_price are optional fields if you want to compute the value and P&L of your position.

[coinmarketcap]
api_key: [YOUR_API_KEY_HERE]

[[portfolio]]
ticker: AAVE
amount: 100.02
entry_price: 100.02

[[portfolio]]
ticker: MATIC
amount: 0.643
entry_price: 1.22

[[portfolio]]
ticker: SOL
amount: 98.45
entry_price: 150

[[portfolio]]
ticker: OSMO
amount: 265.84
entry_price: 1.45

[[portfolio]]
ticker: KUJI
amount: 1053.34
entry_price: 3.95

CoinGecko

Obtain a CoinGecko API key. Create a file at ~/.config/wenmoon/config.toml. Ticker values can be found by searching for the coin on CoinGecko and finding the API ID field under Info.

amount and entry_price are optional fields if you want to compute the value and P&L of your position.

[coingecko]
api_key: [YOUR_API_KEY_HERE]

[[portfolio]]
ticker: aave
amount: 100.02

[[portfolio]]
entry_price: 100.02
ticker: matic-network
amount: 0.643

[[portfolio]]
entry_price: 1.22
ticker: solana
amount: 98.45
entry_price: 150

[[portfolio]]
ticker: osmosis
amount: 265.84
entry_price: 1.45

[[portfolio]]
ticker: kujira
amount: 1053.34
entry_price: 3.95

Usage

Vanilla usage. Will read file from ~/.config/wenmoon/config.toml

wenmoon

Custom config file. Pass the -c flag followed by the path to the file

wenmoon -c ./path/to/custom/config.toml

Multiple portfolios and watchlists using different files

wenmoon -c ~/.config/wenmoon/watchlist.toml
wenmoon -c ~/.config/wenmoon/shitcoins.toml
wenmoon -c ~/.config/wenmoon/vegas_fund.toml

Sorting the list on hourly, daily, weekly and monthly change

wenmoon -s h
wenmoon -s d
wenmoon -s w
wenmoon -s m

If your list is long and you just want to see a single price wenmoon plays nice with UNIX tools such as grep or ripgrep.

wenmoon | grep BTC
wenmoon | rg BTC

Dependencies

~14–32MB
~536K SLoC