Database and tools to monitor whale wallets on chain

serinko a4102aea8a correcting scale		4 lat temu
.idea	d35ad2be49 researching on etherscan with api	4 lat temu
__pycache__	fd69796733 csv export	4 lat temu
data	a434ec9c18 made a new repo	4 lat temu
docs	e11ab9b0e4 more info on python modules, resources and getting info from api	4 lat temu
README.md	2f9b8f15f9 installing and running the whallet_cli	4 lat temu
spl_csv_search.py	a4102aea8a correcting scale	4 lat temu
texts_cli.py	a7383b544b cleaning code	4 lat temu
wallets_dict.json	d582f573bf deleted template dict	4 lat temu
whale_watching_intro.md	a434ec9c18 made a new repo	4 lat temu
whallets_cli.py	0e668db08f TODO	4 lat temu

List of Interesting Wallets to Follow

Introduction

Compiling a list (dictionary) of wallets and an automatized tool to follow monitor them, can generate solid Alpha.

Feedback and cooperation/guidance is welcome.

Installation

$ git clone https://github.com/darkrenaissance/whallets

Programs

whallets_cli.py - the main CLI to interact with the wallet database python whallets_cli.py
spl_scv_search.py - contains function to get transactions within a chosen price range
- spl_csv_search needs csv files with on chain data to be downloaded to the ~\whallets\data first
- to run python spl_csv_search.py

Dictionaries

The wallet dictionary is used to store all the information according to this template:

Template

This is a simple template to make a database dictionary. Fill all <strings> with real data.


{
        "<template_name_wallet>": {
            "twitter": "<https://twitter.com/full_address>",
            "info": "<info>",
            "ens": "<...> ",
            "wallets": {
                "wallet_0": {
                    "address": "<paste 0x... address>",
                    "networks": [
                        "erc",
                        "<paste all the networks separated by a comma>"

                    ]
                },
                "<wallet_1: in case another wallet of the same user>": {
                    "address": "<0x...>",
                    "networks": [
                        "<...>",
                        "<...>"
                    ]
                },
                "<wallet_2: in case of another wallet of the same user>": {
                    "address": "<0x...>",
                    "networks": [
                        "<..>"
                    ]
                }
            }
        }
}

Unified syntax

To be able to automatize the data research later, particularly the on chain movement, some arbitrary variables must follow the same syntax expression. Different whales have wallets on different chains, and to be able to pull form the scans, the chain keys for particular wallets must be noted, and unified across the whales.

Use these ticks for different chains

Syntax	Chain	Explorer
'btc'	Bitcoin
'erc'	Erc 20 (Etherum)	Etherscan
'ens'	Etherum Name service
'bsc'	Binance Smart Chain
'spl'	Solana	Solscan
'poly'	Polygon (Matic)
'heco'	Huobi
'ftm'	Fantom
'avax'	Avalanche
'arb'	Arbitrum
'optm'	Optimism
'gns'	Gnosis
'aur'	Aurora
'one'	Harmony
'fuse'	Fuse

README.md