yield.rb

This is a simple ruby script that pulls data from supported yield trackers and exchanges, and reconstructs them for one purpose: to get the aggregated amounts and values of underlying tokens.

Why?

In YieldWatch, as much as I love the details it provides on yields, it lacks a consolidated view on how much underlying tokens I have. Imagine having deposited tokens into multiple liquidity pools (LPs) and having to manually find and add up the underlying tokens (not LP tokens) one by one...

Some other wallet trackers support this, but none of them supports all the yield farms I use.

As of July 2021, I've switched to using 0xTracker and ApeBoard. If a farm is supported in both then I'd use 0xTracker as it doesn't require a periodically updated auth token.

Here's what the output data looks like:

BNB   6.9420     USD 1.23     AUD 2.34
BTC   0.6969     USD 12.34    AUD 23.45
ETH   4.2000     USD 3.45     AUD 5.67

Total USD: 17.02
Total AUD: 31.46

Usage

Copy config.sample.yml to config.yml:

cp config{.sample,}.yml

Configurations

• ^{In some cases token symbols are not unique (e.g. BUNNY can be Pancake Bunny, BunnyToken or Rocket Bunny), in this case they need to be added to the token_names mapping. Search CoinGecko for their names.}

• ^{The hide_tokens option is useful for hiding dusts and/or tokens you don't care about.}

• ^{The include_tokens option is useful for adding tokens from places without APIs, such as Nexo. Tokens are categorised under groups (exchanges or farms, etc).}

0xTracker

• ^{Visit 0xTracker and take a look at the GET or POST requests to find all the supported farms.}

• ^{Farm entries are supplied by their name and network, e.g. mochiswap.io, bsc.}

ApeBoard

• ^{Visit ApeBoard and take a look at the GET requests to find all the supported wallets and farms.}

YieldWatch

• ^{Please note that if you are using the wallet address, the wallet balances will be missing from the calculation. To include the wallet balances, go to YieldWatch, fetch your wallet, and open the browser console to copy the JSON payload.}

• ^{Alternatively, find the YieldWatch GET request and copy the JWT (the string after "Authorization: Bearer ") in the header.}

Binance & Bittrex

• ^{The file option is only needed if you don't want to supply the API and secret keys.}

Assumptions

1. You only care about the amounts of the underlying tokens - which changes all the time due to IL (Impermanent Loss).
2. Only tokens that have already been deposited into the vaults will be counted, those that are pending are ignored.
3. Coin names on different protocols are consolidated into one, e.g. WBNB, iBNB and beltBNB are all consolidated into BNB.
4. Only the farms and tokens I personally use have been tested.
5. Token prices are fetched from CoinGecko.

Supported Exchanges

• Binance
• Bittrex

Tested Farms / Yield Aggregators

These are the farms I have used and therefore their outputs are tested.

• ACryptoS - BSC
• Adamant - Polygon
• AutoFarm - BSC, Polygon
• Beefy - BSC, Polygon
• Darkside - Polygon
• EVOdefi - Polygon
• Goose Finance - BSC
• Moonpot - BSC
• KogeFarm - Polygon
• PancakeBunny - BSC
• PancakeSwap - BSC
• PolyCat - Polygon
• PolyCrystal - Polygon
• PolygonFarm - Polygon
• Sushi - Polygon

If a farm is supported on 0xTracker or ApeBoard, it should work fine.

Wallet Trackers

These are the BSC (Binance Smart Chain) wallet trackers I have come across.

• 0xTracker
• ApeBoard
• DeBank
• Farm.Army
• Farmfol.io
• Growing.fi
• SCV
• tin.
• YieldWatch

License

Licensed under MIT.