-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
readme
- Loading branch information
Showing
1 changed file
with
49 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,49 @@ | ||
# WalletTracker | ||
Script for tracking wallets on ethscan | ||
|
||
# CryptoTransactionTracker | ||
|
||
## Overview | ||
CryptoTransactionTracker is a Python tool designed to track and analyze cryptocurrency transactions from Ethereum wallets. It fetches transaction data from the Etherscan API, processes it, and compiles detailed transaction histories for specified wallet addresses. | ||
|
||
## Features | ||
- Fetch Ethereum and token transactions from multiple wallet addresses. | ||
- Identify and label transaction types (Buy/Sell). | ||
- Convert Unix timestamps to human-readable dates. | ||
- Cache token names to optimize performance. | ||
- Export transaction data to a CSV file. | ||
|
||
## Installation | ||
To use CryptoTransactionTracker, you need Python 3 and the following packages: | ||
- `requests` | ||
- `pandas` | ||
|
||
Install the required packages using pip: | ||
``` | ||
pip install requests pandas | ||
``` | ||
|
||
## Usage | ||
1. **Set up API Key**: Obtain an API key from [Etherscan.io](https://etherscan.io/apis). | ||
2. **Configure Wallet Addresses**: List the Ethereum wallet addresses you want to track. | ||
3. **Run the Tracker**: Use the script to fetch and process transaction data. | ||
|
||
Example: | ||
```python | ||
from CryptoTransactionTracker import CryptoTransactionTracker | ||
|
||
api_key = "YOUR_ETHERSCAN_API_KEY" | ||
wallet_addresses = ["Wallet1_Address", "Wallet2_Address"] | ||
tracker = CryptoTransactionTracker(wallet_addresses, api_key) | ||
|
||
transactions = tracker.fetch_transactions() | ||
combined_transactions = tracker.filter_and_label_transactions(transactions) | ||
combined_transactions.to_csv('path_to_your_csv_file.csv', sep='|', decimal=',', index=False) | ||
``` | ||
|
||
## Contribution | ||
Contributions to the CryptoTransactionTracker are welcome. Here are some ways you can contribute: | ||
- Reporting bugs | ||
- Suggesting enhancements | ||
- Submitting pull requests for new features or bug fixes | ||
|
||
|
||
Feel free to adjust the content according to your specific needs and preferences. For instance, if you have additional features, dependencies, or specific installation steps, make sure to include them. Also, choose an appropriate license for your project. |