{"id":24783207,"url":"https://github.com/thatlinuxguyyouknow/ethereumwalletfilter","last_synced_at":"2025-03-24T06:28:04.738Z","repository":{"id":240371025,"uuid":"802448844","full_name":"ThatLinuxGuyYouKnow/EthereumWalletFilter","owner":"ThatLinuxGuyYouKnow","description":"A python script to filter out new/inactive wallets, suitable for airdrop snapshots","archived":false,"fork":false,"pushed_at":"2024-07-26T22:03:02.000Z","size":35,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T12:15:58.268Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThatLinuxGuyYouKnow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-18T10:22:17.000Z","updated_at":"2024-07-26T22:03:05.000Z","dependencies_parsed_at":"2024-06-07T23:45:36.848Z","dependency_job_id":"163be39e-45fe-4189-8212-9c0923b1b8bf","html_url":"https://github.com/ThatLinuxGuyYouKnow/EthereumWalletFilter","commit_stats":null,"previous_names":["thatlinuxguyyouknow/ethereumwalletfilter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatLinuxGuyYouKnow%2FEthereumWalletFilter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatLinuxGuyYouKnow%2FEthereumWalletFilter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatLinuxGuyYouKnow%2FEthereumWalletFilter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatLinuxGuyYouKnow%2FEthereumWalletFilter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThatLinuxGuyYouKnow","download_url":"https://codeload.github.com/ThatLinuxGuyYouKnow/EthereumWalletFilter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245220531,"owners_count":20579799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-29T12:15:59.858Z","updated_at":"2025-03-24T06:28:04.702Z","avatar_url":"https://github.com/ThatLinuxGuyYouKnow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wallet Screening with Zerion API\n\nThis project was originally developed for a Replit bounty that was cancelled. The goal of this project is to read wallet addresses from a CSV file, screen them using the Zerion API, and apply specific filtering criteria to identify relevant wallets.\n\n## Table of Contents\n- [Introduction](#introduction)\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Filtering Criteria](#filtering-criteria)\n- [Output](#output)\n- [License](#license)\n\n## Introduction\nThis script reads wallet addresses from a CSV file and screens them using the Zerion API. The wallets are filtered based on criteria such as creation time, transaction amount, transaction source, outgoing transactions, and the status of receiving wallets. The filtered results are saved into a JSON file.\n\n## Features\n- Extracts wallet addresses from a CSV file.\n- Uses Zerion API to retrieve transaction history.\n- Applies specific filtering criteria to identify relevant wallets.\n- Saves approved wallets into a JSON file with detailed information.\n\n## Prerequisites\n- Python 3.6 or higher\n- pandas\n- requests\n\n## Installation\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/ThatLinuxGuyYouKnow/EthereumWalletFilter.git wallet-screening\n    cd wallet-screening\n    ```\n\n2. Install the required Python packages:\n    ```bash\n    pip install pandas requests\n    ```\n\n## Usage\n1. Place your CSV file containing wallet addresses in the project directory.\n2. Update the `csv_file_path` variable in the script to point to your CSV file.\n3. Run the script:\n    ```bash\n    python wallet_screening.py\n    ```\n    or\n\n   ```bash\n   python3 wallet_screening.py\n   ```\n\n## Filtering Criteria\n1. **New Wallets:** Newly created wallets, less than 24 hours old.\n2. **Transaction Amount:** Wallets that have received an Ethereum transaction ranging from 0 to 5 ETH.\n3. **Transaction Source:** Transactions originating from another wallet or centralized exchanges like Binance, Bybit, MEXC, etc.\n4. **Outgoing Transactions:** Monitored wallets should have sent two or more transactions of the same amount to two or more newly created wallets, either manually or through dispersing apps like disperse.app.\n5. **No Outgoing Transactions Yet:** The receiving wallets mentioned in point 4 should not have sent any transactions yet; they should have only received Ethereum.\n\n## Output\nThe script will save the approved wallets into a JSON file named `approved_wallets.json`, containing the following information:\n- Wallet address\n- Last transaction date and time\n- Zerion link\n- Last transaction value in EUR(Euros)\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatlinuxguyyouknow%2Fethereumwalletfilter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthatlinuxguyyouknow%2Fethereumwalletfilter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatlinuxguyyouknow%2Fethereumwalletfilter/lists"}