Database and tools to monitor whale wallets on chain

serinko 2ab2d1ee9a todos added		3 years ago
.idea	d35ad2be49 researching on etherscan with api	4 years ago
__pycache__	bba08a6667 moved dict to /data	3 years ago
data	bba08a6667 moved dict to /data	3 years ago
docs	e11ab9b0e4 more info on python modules, resources and getting info from api	4 years ago
README.md	2f9b8f15f9 installing and running the whallet_cli	4 years ago
spl_csv_search.py	a4102aea8a correcting scale	4 years ago
texts_cli.py	05e02136fc deleted redundant, cleaned the code	3 years ago
wallets_dict.json	01fadb0c87 adding smart wallets	3 years ago
whale_watching_intro.md	a434ec9c18 made a new repo	4 years ago
whallets_cli.py	2ab2d1ee9a todos added	3 years ago

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