KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

EllipticPlusPlus

★ 159 Open GitHub ↗

Elliptic++ Dataset: A Graph Network of Bitcoin Blockchain Transactions and Wallet Addresses

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Elliptic++ Dataset: A Graph Network of Bitcoin Blockchain Transactions and Wallet Addresses

The Elliptic++ dataset consists of 203k Bitcoin transactions and 822k wallet addresses to enable both the detection of fraudulent transactions and the detection of illicit addresses (actors) in the Bitcoin network by leveraging graph data.

If you have any questions or create something with this dataset, please let us know by email: [yelmougy3@gatech.edu](mailto:yelmougy3@gatech.edu).

**DATASET CAN BE FOUND HERE: [Google Drive](https://drive.google.com/drive/folders/1MRPXz79Lu_JGLlJ21MDfML44dKN9R08l?usp=sharing)**

## Dataset Summary

The Elliptic++ dataset contains a transactions dataset and an actors (wallet addresses) dataset.

Elliptic++ Transactions Dataset:

|  |  |
|---|---|
| # Nodes (transactions) | 203,769 |
| # Edges (money flow) | 234,355 |
| # Time steps | 49 |
| # Illicit (class-1) | 4,545 |
| # Licit (class-2) | 42,019 |
| # Unknown (class-3) | 157,205 |
| # Features | 183 |

Elliptic++ Actors (Wallet Addresses) Dataset:

|  |  |
|---|---|
| # Wallet addresses | 822,942 |
| # Nodes (temporal interactions) | 1,268,260 |
| # Edges (addr-addr) | 2,868,964 |
| # Edges (addr-tx-addr) | 1,314,241 |
| # Time steps | 49 |
| # Illicit (class-1) | 14,266 |
| # Licit (class-2) | 251,088 |
| # Unknown (class-3) | 557,588 |
| # Features | 56 |

**DATASET CAN BE FOUND HERE: [Google Drive](https://drive.google.com/drive/folders/1MRPXz79Lu_JGLlJ21MDfML44dKN9R08l?usp=sharing)**

## Dataset Tutorials

We are sharing tutorial notebooks for users and researchers to explore, study, and learn from. The tutorial notebooks are available for both datasets and cover dataset statistics, graph visualization, model training and classification, case analysis, and feature refinement.

[`Transactions dataset statistics`](Transactions%20Dataset/Elliptic++_Transactions_Dataset_Statistics.ipynb) : overall transactions data statistics. 

 <img src="images/txsstats.jpg" width="680" alt="txsstats" />

[`Actors dataset statistics`](Actors%20Dataset/Elliptic++_Actors_Dataset_Statistics.ipynb) : overall actors data statistics. 

 <img src="images/addrstats.jpg" width="650" alt="addrstats" />

[`Transactions graph visualization`](Transactions%20Dataset/Elliptic++_Transactions_Graph_Visualization.ipynb) : visualizations of the Money Flow Transaction graph (tx-tx graph). 

 <img src="images/txsviz.jpg" width="800" alt="txsviz" />

[`Actors graph visualization (Actor Interaction)`](Actors%20Dataset/Elliptic++_Actors_ActorInteraction_Graph_Viz.ipynb) : visualizations of the Actor Interaction graph (addr-addr graph). 

 <img src="images/actorvizaddr.jpg" width="800" alt="actorvizaddr" />

[`Actors graph visualization (Address-Transaction)`](Actors%20Dataset/Elliptic++_Actors_AddrTx_Graph_Viz.ipynb) : visualizations of the Address-Transaction graph (addr-tx-addr graph). 

 <img src="images/actorvizaddrtx.jpg" width="550" alt="actorvizaddrtx" />

[`Transactions classification`](Transactions%20Dataset/Elliptic++_Transactions_Classification.ipynb) : model training and classification on the transactions data. 

 <img src="images/classification.jpg" width="550" alt="txsclassification" />

[`Actors classification`](Actors%20Dataset/Elliptic++_Actors_Classification.ipynb) : model training and classification on the actors data. 

 <img src="images/classification.jpg" width="550" alt="actorclassification" />

[`Transactions case analysis`](Transactions%20Dataset/Elliptic++_Transactions_Case_Analysis.ipynb) : unique case (EASY, HARD, AVERAGE) analysis using the transactions data. 

 <img src="images/txscaseanalysis.jpg" width="680" alt="txscaseanalysis" />

[`Transactions feature analysis`](Transactions%20Dataset/Elliptic++_Transactions_Feature_Analysis.ipynb) : feature importance analysis of the transactions data.

 <img src="images/txsfeatureanalysis.jpg" width="680" alt="txsfeatureanalysis" />

[`Actors feature analysis`](Actors%20Dataset/Elliptic++_Actors_Feature_Analysis.ipynb) : feature importance analysis of the actors data.

 <img src="images/actorsfeatureanalysis.jpg" width="680" alt="actorsfeatureanalysis" />

## Top-Level Directory Organization

The folder structure of this dataset repository is as follows:

.
    ├── Transactions Dataset                                    # Contains csv files and tutorial notebooks for the Elliptic++ Transactions Dataset
    │   ├── txs_features.csv                                    # Feature data for all transactions
    │   ├── txs_classes.csv                                     # Class data for all transactions
    │   ├── txs_edgelist.csv                                    # Transaction-Transaction graph edgelist
    │   ├── Elliptic++ Transactions Dataset Statistics.ipynb    # Tutorial notebook: dataset statistics
    │   ├── Elliptic++ Transactions Graph Visualization.ipynb   # Tutorial notebook: transaction-transaction graph visualization
    │   ├── Elliptic++ Transactions Classification.ipynb        # Tutorial notebook: model training and classification
    │   ├── Elliptic++ Transactions Case Analysis.ipynb         # Tutorial notebook: Unique case (EASY, HARD, AVERAGE) analysis
    │   └── Elliptic++ Transactions Feature Analysis.ipynb      # Tutorial notebook: feature importance analysis
    ├── Actors Dataset                                          # Contains csv files and tutorial notebooks for the Elliptic++ Actors Dataset
    │   ├── wallets_features.csv                                # Feature data for all actors
    │   ├── wallets_classes.csv                                 # Class data for all actors
    │   ├── AddrAddr_edgelist.csv                               # Address-Address graph edgelist
    │   ├── AddrTx_edgelist.csv                                 # Address-Transaction graph edgelist
    │   ├── TxAddr_edgelist.csv                                 # Transaction-Address graph edgelist
    │   ├── Elliptic++ Actors Dataset Statistics.ipynb          # Tutorial notebook: dataset statistics
    │   ├── Elliptic++ Actors ActorInteraction Graph Viz.ipynb  # Tutorial notebook: address-address graph visualization
    │   ├── Elliptic++ Actors AddrTx Graph Viz.ipynb            # Tutorial notebook: address-transaction-address graph visualization
    │   ├── Elliptic++ Actors Classification.ipynb              # Tutorial notebook: model training and classification
    │   └── Elliptic++ Actors Feature Analysis.ipynb            # Tutorial notebook: feature importance analysis
    └── README.md

**DATASET CAN BE FOUND HERE: [Google Drive](https://drive.google.com/drive/folders/1MRPXz79Lu_JGLlJ21MDfML44dKN9R08l?usp=sharing)**

# Citation

If you use our dataset in your work, please cite [our paper](https://doi.org/10.1145/3580305.3599803).

> Youssef Elmougy and Ling Liu. 2023. Demystifying Fraudulent Transactions and Illicit Nodes in the Bitcoin Network for Financial Forensics. In Proceedings of the 29th ACM SIGKDD Conference on Knowledge Discovery and Data Mining (KDD ’23), August 6–10, 2023, Long Beach, CA, USA. ACM, New York, NY, USA, 12 pages. https://doi.org/10.1145/3580305.3599803

For a longer version of the paper, please refer to our ArXiv paper: [ArXiv version](https://arxiv.org/pdf/2306.06108.pdf)

```
@article{elmougy2023demystifying,
  title={Demystifying Fraudulent Transactions and Illicit Nodes in the Bitcoin Network for Financial Forensics},
  author={Elmougy, Youssef and Liu, Ling},
  journal={arXiv preprint arXiv:2306.06108},
  year={2023}
}
```

# Acknowledgement

Released by: [Youssef Elmougy](https://www.yelmougy.com), [Ling Liu](https://www.cc.gatech.edu/home/lingliu/)

School of Computer Science, Georgia Institute of Technology

If you have any questions or create something with this dataset, please let us know by email: [yelmougy3@gatech.edu](mailto:yelmougy3@gatech.edu).

**DATASET CAN BE FOUND HERE: [Google Drive](https://drive.google.com/drive/folders/1MRPXz79Lu_JGLlJ21MDfML44dKN9R08l?usp=sharing)**

EllipticPlusPlus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README