README.md

OP Analytics

Onchain Data, Utilities, References, and other Analytics on Optimism. Join the conversation with other numba nerds in the #analytics channel in the Optimism Discord.

Table of Contents

• I'm looking for Data About
• Select Optimism Data Abstractions
• Contributors

---

I'm Looking for Data About:

A select list of Optimism data dashboards:

Network Usage

• Optimism Protocol Metrics (i.e. transactions, fees, onchain value)
• Popular Apps on Optimism and Project Usage Trends

Token House & Citizen's House Governance

• OP Token House Delegates
• Governance & Voting (by Flipside Crypto)
• AttestationStation Usage
• AttestationStation Key and Creator Distributions

OP Token Distributions & Growth Programs Tracking

• Incentive Program Onchain Usage Summary Dashboard
• Time-Series of TVL Flows by Program (Sourced from DefiLlama and TheGraph API)
• Program-Specific TVL Flows Charts

See Distributions mapping resources in Select Optimism Data Abstractions

DeFi

• Perpetuals Market (by rplust)
• Total Value Locked in DeFi (by Defillama)
• App Fees & Revenue (by Defillama)
• DEX Trade Volume (by Defillama)
• TVL Flows Between Apps and Chains: Last 7 Days, 30 Days, 90 Days, 180 Days, 365 Days (From Defillama API)

NFTs

• NFT Marketplaces and Collection Volume
• L1<>L2 NFT Bridge

Protocol Economics

• L2 Transaction Fees, L1 Security Costs, Sequencer Fees
• Protocol Revenue (by TokenTerminal)

Transaction Costs

• Transaction Fee Savings Calculator

User Onboarding

• CEX & On/Off-Ramp Usage
• App Growth on Optimism After Quests

Select Optimism Data Abstractions

Dune Spellbook: Tables can be used in Dune Analytics

• contracts_optimism.contract_mapping: Near exhaustive mappings of contracts to project names on Optimism - uses decoded contracts in Dune (optimism.contracts) and known deployer addresses to map contracts.
• op_token_distributions_optimism.transfer_mapping: Mappings of token distributions from the OP Foundation & by Grant/Growth Experiment recipients. You can use this table to count h0w much OP has been deployed, by who, and to where. Note: These are "best guess" mappings (contirbute address mappings in the Dune Spellbook repo).
• dex.trades: Aggregation of swaps across many decentralized exchanges
• nft.trades: Aggregation of swaps across many NFT marketplaces. Also see nft.wash_trades by hildobby for filtering out likely wash trades.
• perpetual.trades: Aggregation of swaps across many perpetuals exchanges (by rplust)

Flipside Crypto - Optimism Models > Gold-Level Tables: Tables can be used in Flipside

• optimism.core.ez_dex_swaps: Aggregation of swaps across many decentralized exchanges
• optimism.core.ez_nft_sales: Aggregation of swaps across many NFT marketplaces
• optimism.core.fact_delegations: Aggregation of OP governance delegation events.

Contributors

Configs

For scripts which use APIs from providers with API keys, add the lines like below in a .env file (Replace with your API key - remember to add to gitignore):

DUNE_API_KEY = 'Your API Key'
FLIPSIDE_SHROOMDK_KEY = 'Your API Key'

Installation

python -m pip install pipenv
pipenv install

See Pipfile for all the requirements.

Common Requirements

Common packages used for python scripts include

• pandas
• requests
• aiohttp-retry
• dune-client
• subgrounds
• web3.py
• ethereum-etl

In this repository, we use pre-commit to ensure consistency of formatting. To install for Mac, run

brew install pre-commit

Once installed, in the command line of the repository, run

pre-commit install

This will install pre-commit to the Git hook, so that pre-commit will run and fix files covered in its config before committing.