dexamine: A Python package for Uniswap event data on Ethereum

Paper: arXiv 2609.10407

Authors: Magnus Hansson

Abstract

Decentralized exchanges record trading and liquidity provision on public blockchains, but empirical analysis requires interpreting these records and linking them to execution metadata. dexamine is a Python package that parses Uniswap v2 and v3 events on Ethereum. It converts transaction receipt logs into observations of trades and liquidity changes, with token quantities, pool state, transaction order, and gas information. The package separates data retrieval, contract metadata, protocol interpretation, and output construction. The repository provides recorded Ethereum responses and an offline reproducible example, and version 1 has been used to construct data for an empirical study of price discovery in decentralized markets.

Complexity vs Empirical Score

• Math Complexity: 2.0/10
• Empirical Rigor: 7.0/10
• Quadrant: Street Traders — practical and empirical, lighter on theory

Why this score: This paper presents a highly practical and well-documented Python package for processing Uniswap data, demonstrating strong empirical rigor through its focus on data extraction and validation. While the mathematical complexity is low, the novelty lies in providing a robust, reusable tool for a complex data domain, which is crucial for empirical research in DeFi. The paper excels in clarity and reproducibility, making it a valuable contribution for researchers.

Research Flowchart

  flowchart TD
    A[Research Goal: Analyze Uniswap Event Data] --> B{Key Methodology Steps};
    B --> C[Data/Inputs: Ethereum Transaction Logs (Uniswap v2/v3)];
    C --> D[Computational Processes: dexamine Package];
    D --> E[Computational Processes: Parse Logs, Interpret Events, Link Metadata];
    E --> F[Key Outcomes: Structured Data on Trades, Liquidity, Pool State, Gas];
    F --> G[Key Outcomes: Reproducible Example, Data for Empirical Studies];

Cited References (13)

1. Uniswap v2 Core (2020) — link
2. Uniswap v3 Core (2021) — link
3. Requests : HTTP for Humans (n.d.) — link
4. web3.py : A Python library for interacting with Ethereum (n.d.) — link
5. Ethereum ETL : Export blockchain data to CSV or JSON files (n.d.) — link
6. cryo : Extract blockchain data to Parquet , CSV , JSON or Python dataframes (n.d.) — link
7. Graph Node : An indexing and query layer for blockchain data (n.d.) — link
8. Erigon : An Ethereum implementation on the efficiency frontier (n.d.) — link

0 of 13 cited works are in the corpus; resolved via arXiv source bundles, Semantic Scholar and OpenAlex. Corpus-wide: 2518 linked papers.