Crypto Tracer

A Python toolkit for interacting with blockchain analytics APIs (Chainalysis and Etherscan) to trace cryptocurrency transactions, analyze clusters, and gather wallet observations.

Description

This project provides a set of Python scripts and API wrappers to automate blockchain data extraction and analysis. It includes modules for querying cluster information, transaction details, exposures, and wallet observations using the Chainalysis and Etherscan APIs.

Setup

brew update brew install pyenv

1. Clone the repository:

   git clone https://github.com/yourusername/crypto-tracer.git
   cd crypto-tracer

2. Create a virtual environment:

   pyenv install 3.11.8
   pyenv local 3.11.8
   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Install dependencies:

   pip install -r requirements.txt
   pip install --upgrade pip

4. Configure API keys:

   • Obtain API keys from Chainalysis and Etherscan.
   • Update the API key in the respective API wrapper files (chainalysis/chainalysis_api.py and etherscan/etherscan_api.py).

5. Run the scripts:

   • Use the provided scripts (e.g., get_usage_by_user.py, get_observations_by_ip.py) to fetch and analyze blockchain data.

TODOs

• Add comprehensive documentation for each script and API wrapper.
• Implement error handling and logging improvements.
• Add unit tests for all scripts and API wrappers.
• Integrate additional blockchain analytics APIs (e.g., Blockchair, Blockchain.info).
• Create a command-line interface (CLI) for easier interaction with the scripts.
• Optimize API calls for better performance and rate limiting.
• Add support for asynchronous API requests.
• Implement data visualization tools for blockchain analytics.
• Add a contribution guide and code of conduct.
• Set up continuous integration (CI) for automated testing and deployment.