dexamine: A Python package for Uniswap event data on Ethereum

By Magnus Hansson

Rating

1315
Battle Count: 98

Relevance

6/10
The paper provides critical data infrastructure for quantitative research in DeFi markets. While not a trading strategy or model itself, it enables construction of event-level datasets essential for studying price discovery, liquidity dynamics, transaction ordering, and execution costs in automated market makers. Version 1 was used in an empirical study of price discovery. The tool is relevant for researchers building quantitative analyses of DEX microstructure but does not directly implement trading algorithms or risk models.

Implementation Complexity

5/10
Moderate complexity: requires understanding of Ethereum JSON-RPC, Uniswap v2/v3 protocol mechanics (Sync events, ticks, virtual reserves, fee structures), token decimal conventions, and Python packaging. The API is straightforward (supply block number, transaction index, protocol selection), but correct interpretation of outputs (virtual reserves vs. actual balances, receipt_log_index vs. block-wide logIndex, sign conventions) requires domain knowledge. Dependencies are minimal (web3.py, Requests). Offline example lowers barrier to entry.

Reproducibility

5/5
Excellent reproducibility: the repository includes recorded Ethereum responses for offline replay, an executable example with --check option comparing output to committed JSON, a separate verification script using ABI decoding and high-precision decimal arithmetic, continuous integration running tests/formatting/linting/type-checking on Python 3.10-3.13, and explicit metadata seeding via MetadataResolver.seed. The paper describes version v1.1.0 with pinned dependencies.

About this paper

Methodology: Protocol-specific event parsing and data joining. Problem types: Data Extraction and Parsing, Market Microstructure Analysis.

The interactive Everscope explorer (charts, battles, favorites) loads below.