BitqueryBitqueryData Store
Optimism logoOptimismBlocksTransactionsCallsEventsTransfersTradesRewards

Optimism

OP Mainnet since its genesis block of November 2021 as flat Parquet: blocks, transactions, internal calls, decoded events, transfers, DEX trades and sequencer fee rewards, at block resolution.

Coverage
Nov 11, 2021→ Oct 6, 2026 · yesterday
Tables
7Parquet, one prefix each
Columns
295across 7 tables
Coverage ends yesterday, UTC

Overview

Seven flat Parquet tables covering OP Mainnet from its genesis block of 11 November 2021 to yesterday, at block resolution: blocks, transactions, calls, events, transfers, dex_trades and miner_rewards. Every table carries Block_Number and Block_Time, and every table but blocks and miner_rewards carries Transaction_Hash, so they join without a lookup table.

The calls and events tables are the ones an archive node will not give you cheaply: each internal call frame with its decoded function signature, arguments and return values, gas and revert state, and each log with its decoded topic signature and the call frame that emitted it. Decoded arguments come as parallel arrays, one entry per argument, with the value typed in the column that matches its ABI type.

Optimism is the original OP Stack rollup, rebuilt on Bedrock in June 2023. Gas is paid in ETH, deposits from Ethereum arrive as type 126 transactions, and the S3 prefix is optimism/.

Use cases

  • Full-chain analytics without running an archive node or paying per RPC call
  • Contract forensics on decoded internal calls, with gas and revert state
  • Token and stablecoin flow analysis across the whole chain, not one contract at a time
  • Sequencer economics: base fee burn, priority fees and block rewards per block

7 tables

295 columns · free sample for each table

blocks

22 columns

One row per OP Mainnet block, with the sequencer, gas, base fee and the trie roots.

optimism/blocks<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Oct 5, 2026

transactions

40 columns

One row per OP Mainnet transaction, with the fee breakdown, receipt status, call count and outcome.

optimism/transactions<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Oct 7, 2026

calls

65 columns

One row per call frame, internal calls included, with decoded signature, arguments and return values, gas and revert state.

optimism/calls<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Oct 7, 2026

events

63 columns

One row per log, with the decoded event signature, topics, raw data and the call frame that emitted it.

optimism/events<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Oct 7, 2026

transfers

24 columns

One row per native ETH or token transfer on OP Mainnet, with sender, receiver, token metadata and a USD value where a price exists.

optimism/transfers<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Oct 5, 2026

dex_trades

54 columns

One row per DEX swap on OP Mainnet, with both sides, pool and protocol, fees, transaction details and a USD value where a price exists.

optimism/dex_trades<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Sep 26, 2026

miner_rewards

27 columns

One row per block, splitting the sequencer's take into static, dynamic, transaction-fee and burnt components. Indexed from 9 July 2026 (block 154,016,455).

optimism/miner_rewards<start_block>_<end_block>.parquet50 blocks per file, sorted ascending
Browse columns Sample fileSample updated Oct 5, 2026

Schema reference

copies a column name
295 columns
blocks22 columnsOne row per OP Mainnet block, with the sequencer, gas, base fee and the trie roots.
ColumnTypeDescription
Block22
Block_BaseFeeStringEIP-1559 base fee per gas, in ETH, as a decimal string
Block_BaseFeeInUSDFloat64Base fee per gas valued in USD at the block's hourly ETH price; 0 when unpriced
Block_BloomStringBloom filter over the block's logs, hex
Block_CoinbaseStringAddress credited as block producer, 0x-prefixed; on OP Mainnet this is the sequencer fee vault predeploy
Block_DateDateUTC date of the block
Block_DifficultyStringDifficulty field as recorded; OP Mainnet has no proof of work, so it carries no mining meaning
Block_GasLimitUInt64Gas limit of the block
Block_GasUsedUInt64Total gas used by the block's transactions
Block_HashStringBlock hash, 0x-prefixed
Block_MixDigestStringMix digest field, hex
Block_NumberUInt64Block height
Block_NonceUInt64Block nonce
Block_ParentHashStringHash of the parent block, 0x-prefixed
Block_ReceiptHashStringRoot of the receipts trie
Block_Result_ErrorsStringErrors recorded while executing the block; empty when there were none
Block_Result_GasUInt64Gas accounted for in the block's execution result
Block_RootStringState root after the block
Block_TimeDateTimeBlock timestamp, UTC
Block_TxCountUInt32Number of transactions in the block
Block_TxHashStringRoot of the transactions trie
Block_UncleHashStringRoot of the uncles list. OP Mainnet produces no uncles, so this is the empty-list hash on every block
Block_UnclesCountUInt32Number of uncles; always 0 on OP Mainnet
Sample file
transactions40 columnsOne row per OP Mainnet transaction, with the fee breakdown, receipt status, call count and outcome.
ColumnTypeDescription
Other1
ChainIdUInt32EVM chain id; 10 for Optimism mainnet
Block7
Block_DateDateUTC date of the block
Block_TimeDateTimeBlock timestamp, UTC
Block_NumberUInt64Block height
Block_HashStringBlock hash, 0x-prefixed
Block_CoinbaseStringAddress credited as block producer, 0x-prefixed; on OP Mainnet this is the sequencer fee vault predeploy
Block_GasUsedUInt64Total gas used by the block's transactions
Block_BaseFeeStringBase fee per gas of the containing block, in ETH, as a decimal string
Transaction14
Transaction_IndexUInt32Position of the transaction within the block
Transaction_HashStringTransaction hash, 0x-prefixed. The join key across every table
Transaction_NonceUInt64Sender's nonce
Transaction_TypeUInt32EIP-2718 transaction type: 0 legacy, 1 access list, 2 EIP-1559, 4 EIP-7702, 126 deposit from Ethereum L1
Transaction_FromStringAddress that signed the transaction, 0x-prefixed
Transaction_ToStringAddress the transaction called, 0x-prefixed; the string 0x for a contract deployment
Transaction_ValueStringNative ETH sent with the transaction, decimal adjusted, as a decimal string
Transaction_ValueInUSDFloat64That value in USD at the block's hourly ETH price
Transaction_GasUInt64Gas limit the sender set
Transaction_GasPriceStringGas price the sender offered, as a decimal string
Transaction_GasPriceInUSDFloat64Offered gas price in USD
Transaction_GasFeeCapStringEIP-1559 max fee per gas, as a decimal string
Transaction_GasTipCapStringEIP-1559 max priority fee per gas, as a decimal string
Transaction_CallCountUInt32Number of call frames the transaction produced, the top-level call included. Join to the calls table on Transaction_Hash to read them
Receipt4
Receipt_TypeUInt32Receipt type, mirroring the transaction type
Receipt_StatusUInt32Receipt status: 1 succeeded, 0 failed
Receipt_GasUsedUInt64Gas used by this transaction alone
Receipt_ContractAddressStringAddress of the contract deployed by this transaction, 0x-prefixed; the string 0x when none
Fee11
Fee_SenderFeeStringTotal network fee the sender paid for the transaction, in ETH, as a decimal string
Fee_SenderFeeInUSDFloat64Total sender fee in USD
Fee_MinerRewardStringPortion of the fee paid to the validator, as a decimal string
Fee_MinerRewardInUSDFloat64Validator's share of the fee in USD
Fee_BurntStringETH burnt by the base fee, as a decimal string
Fee_BurntInUSDFloat64Burnt fee in USD at the block's hourly ETH price
Fee_EffectiveGasPriceStringGas price actually charged, in ETH, as a decimal string
Fee_EffectiveGasPriceInUSDFloat64Effective gas price in USD
Fee_PriorityFeePerGasStringPriority fee per gas, in ETH, as a decimal string
Fee_PriorityFeePerGasInUSDFloat64Priority fee per gas in USD
Fee_GasRefundUInt64Gas refunded to the sender, in gas units
TransactionStatus3
TransactionStatus_SuccessStringWhether the transaction succeeded; true or false
TransactionStatus_EndErrorStringError the transaction ended with; empty when it succeeded
TransactionStatus_FaultErrorStringFault-level error raised during execution; empty when none
Sample file
calls65 columnsOne row per call frame, internal calls included, with decoded signature, arguments and return values, gas and revert state.
ColumnTypeDescription
Other1
ChainIdUInt32EVM chain id; 10 for Optimism mainnet
Block4
Block_DateDateUTC date of the block
Block_TimeDateTimeBlock timestamp, UTC
Block_NumberUInt64Block height
Block_BaseFeeStringBase fee per gas of the containing block, in ETH, as a decimal string
Transaction4
Transaction_IndexUInt32Position of the transaction within the block
Transaction_HashStringHash of the containing transaction, 0x-prefixed. The join key
Transaction_ToStringAddress the transaction called, 0x-prefixed; the string 0x for a contract deployment
Transaction_FromStringAddress that signed the transaction, 0x-prefixed
Receipt2
Receipt_ContractAddressStringAddress of the contract deployed by this transaction, 0x-prefixed; the string 0x when none
Receipt_StatusUInt32Receipt status: 1 succeeded, 0 failed
Fee1
Fee_SenderFeeStringTotal network fee the sender paid for the transaction, in ETH, as a decimal string
TransactionStatus1
TransactionStatus_SuccessStringWhether the parent transaction succeeded; true or false
Call24
Call_IndexUInt32Position of the frame within the transaction. Events reference it to name the frame that emitted a log
Call_DepthUInt32Nesting depth, 0 for the top-level call
Call_EnterIndexUInt32Order in which the frame was entered within the transaction
Call_ExitIndexUInt32Order in which the frame was exited
Call_CallerIndexInt32Call_Index of the calling frame; -1 for the top-level call
Call_CallPathArrayPath of call indexes from the transaction root down to this frame, as an array of integers
Call_InternalCallsUInt32Number of calls made beneath this frame
Call_FromStringCalling address, 0x-prefixed
Call_ToStringCalled address, 0x-prefixed
Call_CreateStringWhether this frame deployed a contract; true or false
Call_InputStringRaw calldata passed to the frame, hex
Call_GasUInt64Gas supplied to the call
Call_ValueStringNative ETH sent with the call, decimal adjusted, as a decimal string
Call_ValueInUSDFloat64That value in USD at the block's hourly ETH price; 0 when the value is 0
Call_OutputStringRaw return data, hex
Call_GasUsedUInt64Gas consumed by this call and everything beneath it
Call_ErrorStringError the call returned; empty on success
Call_Opcode_CodeUInt32Numeric opcode that produced the frame
Call_Opcode_NameStringOpcode name, for example CALL, DELEGATECALL, STATICCALL, CREATE or CREATE2
Call_SelfDestructStringWhether the called contract self-destructed; true or false
Call_DelegatedStringWhether the frame ran through delegatecall, as proxies do; true or false
Call_SuccessStringWhether the frame succeeded; true or false
Call_RevertedStringWhether the frame reverted; true or false. A frame can revert inside a transaction that succeeded
Call_LogCountUInt32Number of logs this frame emitted
Call_Signature6
Call_Signature_ParsedStringWhether the function signature was resolved and the arguments decoded; the string true or false
Call_Signature_NameStringFunction name, when resolved
Call_Signature_SignatureStringCanonical function signature, for example transfer(address,uint256)
Call_Signature_AbiStringABI fragment for the resolved function; empty when the selector is unknown
Call_Signature_SignatureHashStringFour-byte function selector, lower-case hex without 0x
Call_Signature_SignatureTypeUInt32How the function signature was resolved, as a numeric code
Arguments11
Arguments_Type_NameArrayName of each decoded argument, in ABI order; empty when the signature did not resolve
Arguments_Type_TypeArraySolidity type of each decoded argument, for example address, uint256 or bytes32
Arguments_Type_IndexArrayPosition of each decoded argument in the ABI, from 0
Arguments_Path_NameArrayFor struct and array arguments, the member names along the path to each decoded value; an empty list for a plain value
Arguments_Path_TypeArrayFor struct and array arguments, the member types along the path to each decoded value; an empty list for a plain value
Arguments_Path_IndexArrayFor struct and array arguments, the member indexes along the path to each decoded value; an empty list for a plain value
Arguments_Value_StringArrayValue of each argument rendered as a string; integers appear here in decimal, addresses in hex, and the other Value columns are empty or 0 for that position
Arguments_Value_BytesArrayValue of each argument whose ABI type is address, bytes or bytesN, as lower-case hex without 0x; empty for other types
Arguments_Value_UIntArrayValue of each unsigned-integer argument that fits in 64 bits; 0 for other types and for larger values, which appear in Arguments_Value_String
Arguments_Value_IntArrayValue of each signed-integer argument that fits in 64 bits; 0 for other types
Arguments_Value_BoolArrayValue of each bool argument as 0 or 1; 0 for other types
Returns11
Returns_Type_NameArrayName of each decoded return value, in ABI order; empty when the signature did not resolve or the call returned nothing
Returns_Type_TypeArraySolidity type of each decoded return value
Returns_Type_IndexArrayPosition of each decoded return value in the ABI, from 0
Returns_Path_NameArrayFor struct and array return values, the member names along the path to each decoded value; an empty list for a plain value
Returns_Path_TypeArrayFor struct and array return values, the member types along the path to each decoded value; an empty list for a plain value
Returns_Path_IndexArrayFor struct and array return values, the member indexes along the path to each decoded value; an empty list for a plain value
Returns_Value_StringArrayValue of each return value rendered as a string; integers in decimal, addresses in hex
Returns_Value_BytesArrayValue of each return value whose ABI type is address, bytes or bytesN, as lower-case hex without 0x; empty for other types
Returns_Value_UIntArrayValue of each unsigned-integer return value that fits in 64 bits; 0 for other types and for larger values
Returns_Value_IntArrayValue of each signed-integer return value that fits in 64 bits; 0 for other types
Returns_Value_BoolArrayValue of each bool return value as 0 or 1; 0 for other types
Sample file
events63 columnsOne row per log, with the decoded event signature, topics, raw data and the call frame that emitted it.
ColumnTypeDescription
Other1
ChainIdUInt32EVM chain id; 10 for Optimism mainnet
Block4
Block_DateDateUTC date of the block
Block_TimeDateTimeBlock timestamp, UTC
Block_NumberUInt64Block height
Block_BaseFeeStringBase fee per gas of the containing block, in ETH, as a decimal string
Transaction4
Transaction_IndexUInt32Position of the transaction within the block
Transaction_HashStringHash of the containing transaction, 0x-prefixed. The join key
Transaction_ToStringAddress the transaction called, 0x-prefixed; the string 0x for a contract deployment
Transaction_FromStringAddress that signed the transaction, 0x-prefixed
Receipt2
Receipt_ContractAddressStringAddress of the contract deployed by this transaction, 0x-prefixed; the string 0x when none
Receipt_StatusUInt32Receipt status: 1 succeeded, 0 failed
Fee1
Fee_SenderFeeStringTotal network fee the sender paid for the transaction, in ETH, as a decimal string
TransactionStatus1
TransactionStatus_SuccessStringWhether the transaction succeeded; true or false
Call15
Call_IndexUInt32Position of the emitting frame within the transaction; join to calls on this plus Transaction_Hash
Call_CallerIndexInt32Call_Index of the frame that called the emitting frame; -1 at the top level
Call_CallPathArrayPath of call indexes from the transaction root down to the emitting frame
Call_InternalCallsUInt32Number of calls made beneath the emitting frame
Call_FromStringCaller of the emitting frame, 0x-prefixed
Call_ToStringAddress the emitting frame called, 0x-prefixed
Call_CreateStringWhether the emitting frame deployed a contract; true or false
Call_GasUInt64Gas supplied to the emitting frame
Call_ValueStringNative ETH sent with the emitting frame, decimal adjusted
Call_GasUsedUInt64Gas consumed by the emitting frame and everything beneath it
Call_ErrorStringError the emitting frame returned; empty on success
Call_SelfDestructStringWhether the emitting contract self-destructed; true or false
Call_DelegatedStringWhether the frame ran through delegatecall, as proxies do; true or false
Call_SuccessStringWhether the frame succeeded; true or false
Call_RevertedStringWhether the emitting frame reverted; true or false
Call_Signature6
Call_Signature_ParsedStringWhether the function signature was resolved and the arguments decoded; the string true or false
Call_Signature_NameStringName of that function, when resolved
Call_Signature_SignatureStringCanonical signature of that function
Call_Signature_AbiStringABI fragment of the function the emitting frame ran
Call_Signature_SignatureHashStringFour-byte function selector, lower-case hex without 0x
Call_Signature_SignatureTypeUInt32How the function signature was resolved, as a numeric code
Log11
Log_IndexUInt32Position of the log within the transaction
Log_EnterIndexUInt32Enter index of the emitting frame
Log_ExitIndexUInt32Exit index of the emitting frame
Log_LogAfterCallIndexUInt32Index of the last call frame entered before this log, for ordering logs against calls
Log_SmartContractStringContract that emitted the log, 0x-prefixed. Filter on this for one contract's events
Log_Signature_ParsedStringWhether the event signature was resolved and the arguments decoded; the string true or false
Log_Signature_NameStringEvent name, for example Transfer or Swap, when resolved
Log_Signature_SignatureStringCanonical event signature, for example Transfer(address,address,uint256)
Log_Signature_AbiStringABI fragment for the resolved event; empty when the topic is unknown
Log_Signature_SignatureHashStringKeccak hash of the event signature, lower-case hex without 0x; the same value as topic 0
Log_Signature_SignatureTypeUInt32How the event signature was resolved, as a numeric code
LogHeader4
LogHeader_IndexUInt64Index of the log within the block, as the receipt records it
LogHeader_AddressStringAddress recorded in the log header, 0x-prefixed
LogHeader_DataStringRaw non-indexed log data, lower-case hex without 0x
LogHeader_RemovedStringWhether the log was removed by a reorg; true or false
Topics1
Topics_HashArrayIndexed topics of the log, as an array of lower-case hex strings without 0x; the first is the event signature hash
Arguments13
Arguments_Type_NameArrayName of each decoded argument, in ABI order; empty when the signature did not resolve
Arguments_Type_TypeArraySolidity type of each decoded argument, for example address, uint256 or bytes32
Arguments_Type_IndexArrayPosition of each decoded argument in the ABI, from 0
Arguments_Path_NameArrayFor struct and array arguments, the member names along the path to each decoded value; an empty list for a plain value
Arguments_Path_TypeArrayFor struct and array arguments, the member types along the path to each decoded value; an empty list for a plain value
Arguments_Path_IndexArrayFor struct and array arguments, the member indexes along the path to each decoded value; an empty list for a plain value
Arguments_Value_StringArrayValue of each argument rendered as a string; integers appear here in decimal, addresses in hex, and the other Value columns are empty or 0 for that position
Arguments_Value_BytesArrayValue of each argument whose ABI type is address, bytes or bytesN, as lower-case hex without 0x; empty for other types
Arguments_Value_UIntArrayValue of each unsigned-integer argument that fits in 64 bits; 0 for other types and for larger values, which appear in Arguments_Value_String
Arguments_Value_IntArrayValue of each signed-integer argument that fits in 64 bits; 0 for other types
Arguments_Value_BoolArrayValue of each bool argument as 0 or 1; 0 for other types
Arguments_Value_IsHashedArray1 when the argument was an indexed dynamic type and only its keccak hash is on chain, so the value is the hash; else 0
Arguments_Value_IsIndexedArray1 when the argument was an indexed event parameter, carried in the topics rather than the data; else 0
Sample file
transfers24 columnsOne row per native ETH or token transfer on OP Mainnet, with sender, receiver, token metadata and a USD value where a price exists.
ColumnTypeDescription
Block3
Block_DateDateUTC date of the block
Block_NumberUInt64Block height
Block_TimeDateTimeBlock timestamp, UTC
Fee1
Fee_SenderFeeStringNetwork fee the sender paid for the whole transaction, in ETH, as a decimal string. It repeats on every row of the transaction, so count it once per transaction
Transaction3
Transaction_HashStringHash of the transaction this row settled in, 0x-prefixed; the join key to transactions and logs
Transaction_IndexUInt64Position of the transaction within the block
Transaction_TypeUInt32EIP-2718 transaction type: 0 legacy, 1 access list, 2 EIP-1559, 4 EIP-7702, 126 deposit from Ethereum L1
TransactionStatus1
TransactionStatus_SuccessStringWhether the transaction succeeded; the string true or false. Failed transactions are kept
Transfer16
Transfer_AmountStringAmount moved, decimal adjusted, as a decimal string with exactly as many places as the token has decimals. Multiply by 10 to the power of the decimals for the raw on-chain integer
Transfer_AmountInUSDFloat64Amount valued in USD at the hourly price for the block's hour; 0 when the amount is 0 or the token has no price
Transfer_Currency_DecimalsInt32Decimals of the transferred currency, as its contract reports them
Transfer_Currency_DelegatedToStringImplementation address for proxy tokens; the string 0x when there is none
Transfer_Currency_FungibleStringWhether the currency is fungible; the string true or false, and false for NFTs
Transfer_Currency_NameStringName reported by the contract; lookalike tokens copy real names
Transfer_Currency_NativeStringtrue for native ETH, false for tokens. Filter on this column to separate ETH movement from token movement
Transfer_Currency_ProtocolNameStringToken standard, for example erc20 or erc721; empty for native ETH
Transfer_Currency_SmartContractStringContract of the transferred token, 0x-prefixed; the string 0x for native ETH
Transfer_Currency_SymbolStringSymbol reported by the contract; repeats across tokens, so join on the contract address
Transfer_IdStringToken id for NFT transfers; the string 0 for fungible transfers
Transfer_IndexUInt32Position within the transaction. Several rows in one transaction can share it
Transfer_SenderStringSending address, 0x-prefixed
Transfer_ReceiverStringReceiving address, 0x-prefixed
Transfer_TypeStringtoken for token transfers, transaction for a plain ETH send, call for ETH moved by a contract in an internal call
Transfer_URIStringMetadata URI for NFT transfers; empty otherwise
Sample file
dex_trades54 columnsOne row per DEX swap on OP Mainnet, with both sides, pool and protocol, fees, transaction details and a USD value where a price exists.
ColumnTypeDescription
Block3
Block_DateDateUTC date of the block
Block_NumberUInt64Block height
Block_TimeDateTimeBlock timestamp, UTC
Fee1
Fee_SenderFeeStringNetwork fee the sender paid for the whole transaction, in ETH, as a decimal string. It repeats on every row of the transaction, so count it once per transaction
Trade_Buy15
Trade_Buy_AmountStringAmount bought, decimal adjusted, as a decimal string with exactly as many places as the token has decimals; for NFTs, the number of items
Trade_Buy_AmountInUSDFloat64USD value of the swap at the block's hourly price, set from its best-priced side and the same on both sides; 0 when neither side has a price
Trade_Buy_BuyerStringAddress that received the bought currency, usually a router or the trader
Trade_Buy_Currency_DecimalsInt32Decimals of the bought token, as its contract reports them
Trade_Buy_Currency_FungibleStringWhether the bought token is fungible; true or false, and false for NFTs
Trade_Buy_Currency_HasURIStringWhether the bought token carries a metadata URI; true or false
Trade_Buy_Currency_NameStringName reported by the bought token's contract; lookalike tokens copy real names
Trade_Buy_Currency_ProtocolNameStringToken standard on the bought side, for example erc20 or erc1155; empty for native ETH
Trade_Buy_Currency_SmartContractStringContract of the bought token, 0x-prefixed; the string 0x for native ETH
Trade_Buy_Currency_SymbolStringSymbol reported by the bought token's contract; not unique, so join on the contract
Trade_Buy_IdsArrayToken ids bought, as strings; empty for fungible tokens
Trade_Buy_OrderIdStringOrder id for order-book and marketplace trades such as Seaport, hex without 0x; empty for pool swaps. The same value on both sides
Trade_Buy_PriceFloat64Price of the bought currency in units of the sold currency
Trade_Buy_PriceInUSDFloat64USD price of one unit of the bought currency: the swap's USD value divided by the bought amount, so per item for NFTs; 0 when unpriced
Trade_Buy_SellerStringAddress that sent the bought currency, usually the pool
Trade_Dex10
Trade_Dex_DelegatedStringtrue when the pool ran through a delegate call, as proxy and clone pools do, else false; the implementation address is not included
Trade_Dex_OwnerAddressStringFactory or owner the index records for the pool, 0x-prefixed; the string 0x when none. Use it to tell forks apart
Trade_Dex_Pair_DecimalsInt32Decimals of the pool's own LP token; 0 when the pool has none, as in v3 and v4
Trade_Dex_Pair_NameStringName of the pool's own LP token, for example Uniswap V2; empty for v3, v4 and other pools without one
Trade_Dex_Pair_SmartContractStringPool token contract for v2-style pools, 0x-prefixed; the string 0x otherwise, where Trade_Dex_SmartContract or Trade_PoolId names the pool
Trade_Dex_Pair_SymbolStringSymbol of the pool's own LP token, for example UNI-V2; not unique
Trade_Dex_ProtocolFamilyStringProtocol family, for example Uniswap, Aerodrome or Balancer. Filter this column to keep or drop a venue
Trade_Dex_ProtocolNameStringProtocol and version as indexed, for example uniswap_v3 or seaport_v1.4. It names the pool design, so forks can share it
Trade_Dex_ProtocolVersionStringProtocol version string
Trade_Dex_SmartContractStringContract that emitted the swap, 0x-prefixed: the pool for v2 and v3 designs, the shared PoolManager for Uniswap v4 and PancakeSwap Infinity, the exchange for marketplaces
Trade5
Trade_FeesStringFees charged on the swap as a JSON array of [amount, amountInUSD, [decimals, name, token standard, contract hex, symbol], payer, recipient]; the USD value is set when the fee token is one side of the swap; [] when none
Trade_IndexUInt32Position of the swap within the transaction
Trade_PoolIdString32-byte pool id, 0x-prefixed, for Uniswap v4 and PancakeSwap Infinity, whose pools share one contract; empty for other protocols
Trade_SenderStringAddress that called the pool, often a router or aggregator
Trade_SuccessStringWhether this swap succeeded; true or false. A swap can fail inside a successful transaction, so filter on this column
Trade_Sell15
Trade_Sell_AmountStringAmount sold, decimal adjusted, as a decimal string with exactly as many places as the token has decimals; for NFTs, the number of items
Trade_Sell_AmountInUSDFloat64USD value of the swap at the block's hourly price, set from its best-priced side and the same on both sides; 0 when neither side has a price
Trade_Sell_BuyerStringAddress that received the sold currency, usually the pool
Trade_Sell_Currency_DecimalsInt32Decimals of the sold token, as its contract reports them
Trade_Sell_Currency_FungibleStringWhether the sold token is fungible; true or false, and false for NFTs
Trade_Sell_Currency_HasURIStringWhether the sold token carries a metadata URI; true or false
Trade_Sell_Currency_NameStringName reported by the sold token's contract; lookalike tokens copy real names
Trade_Sell_Currency_ProtocolNameStringToken standard on the sold side, for example erc20 or erc1155; empty for native ETH
Trade_Sell_Currency_SmartContractStringContract of the sold token, 0x-prefixed; the string 0x for native ETH
Trade_Sell_Currency_SymbolStringSymbol reported by the sold token's contract; not unique, so join on the contract
Trade_Sell_IdsArrayToken ids sold, as strings; empty for fungible tokens
Trade_Sell_OrderIdStringOrder id for order-book and marketplace trades such as Seaport, hex without 0x; empty for pool swaps. The same value on both sides
Trade_Sell_PriceFloat64Price of the sold currency in units of the bought currency
Trade_Sell_PriceInUSDFloat64USD price of one unit of the sold currency: the swap's USD value divided by the sold amount, so per item for NFTs; 0 when unpriced
Trade_Sell_SellerStringAddress that sent the sold currency, usually a router or the trader
Transaction4
Transaction_FromStringAddress that signed the transaction: the trader behind any router
Transaction_HashStringHash of the transaction, 0x-prefixed; the join key to transfers and logs
Transaction_IndexUInt64Position of the transaction within the block
Transaction_ToStringContract the transaction called, often a router
TransactionStatus1
TransactionStatus_SuccessStringWhether the transaction succeeded; true or false
Sample file
miner_rewards27 columnsOne row per block, splitting the sequencer's take into static, dynamic, transaction-fee and burnt components. Indexed from 9 July 2026 (block 154,016,455).
ColumnTypeDescription
Block12
Block_NumberUInt64Block height
Block_TimeDateTimeBlock timestamp, UTC
Block_TxCountUInt32Number of transactions in the block
Block_RootStringState root after the block
Block_UnclesCountUInt32Number of uncles; always 0 on OP Mainnet
Block_TxHashStringRoot of the transactions trie
Block_GasUsedUInt64Total gas used by the block
Block_BaseFeeStringBase fee per gas of the block, in ETH, as a decimal string
Block_CoinbaseStringValidator credited with the block, 0x-prefixed
Block_GasLimitUInt64Gas limit of the block
Block_DateDateUTC date of the block
Block_HashStringBlock hash, 0x-prefixed
Reward12
Reward_BurntFeesStringETH burnt by the base fee across the block, as a decimal string
Reward_BurntFeesInUSDFloat64Burnt fees in USD at the block's hourly ETH price
Reward_DynamicInUSDFloat64Dynamic reward component in USD
Reward_DynamicStringDynamic reward component, as a decimal string
Reward_StaticStringFixed block subsidy, as a decimal string. OP Mainnet pays no protocol subsidy, so this is 0
Reward_StaticInUSDFloat64Static reward in USD
Reward_TotalStringTotal reward credited for the block, as a decimal string
Reward_TotalInUSDFloat64Total reward in USD
Reward_TxFeesStringTransaction fees credited to the sequencer, as a decimal string. On OP Mainnet this is effectively the whole reward
Reward_TxFeesInUSDFloat64Transaction fees in USD
Reward_UncleInUSDFloat64Uncle reward in USD; always 0 on OP Mainnet
Reward_UncleStringUncle reward, as a decimal string; always 0 on OP Mainnet
Uncle2
Uncle_Block_NumberUInt64Block height of the uncle; always 0 on OP Mainnet
Uncle_IndexUInt32Index of the uncle; always 0 on OP Mainnet
Other1
ChainIdUInt64EVM chain id; 10 for Optimism mainnet
Sample file

Ask an AI about this data

Send this dataset’s full schema to an assistant and ask it anything. It reads the plain-text brief first, so the answer comes from the real column list rather than a guess.

Start with

Opens a new chat with the question filled in. Nothing about you is sent to Bitquery, and the assistant sees only the public brief.

Delivery

Parquet files in a Requester Pays S3 bucket or a Cloudflare R2 bucket, chosen at checkout. On S3 you download with your own AWS account and AWS bills the transfer; on R2 you download with a read-only API key and pay no egress. Layout:

# blocks: 50 blocks per file, sorted ascending
optimism/blocks<start_block>_<end_block>.parquet

# transactions: 50 blocks per file, sorted ascending
optimism/transactions<start_block>_<end_block>.parquet

# calls: 50 blocks per file, sorted ascending
optimism/calls<start_block>_<end_block>.parquet

# events: 50 blocks per file, sorted ascending
optimism/events<start_block>_<end_block>.parquet

# transfers: 50 blocks per file, sorted ascending
optimism/transfers<start_block>_<end_block>.parquet

# dex_trades: 50 blocks per file, sorted ascending
optimism/dex_trades<start_block>_<end_block>.parquet

# miner_rewards: 50 blocks per file, sorted ascending
optimism/miner_rewards<start_block>_<end_block>.parquet
  1. Download a free sampleNo email needed.
  2. Pay nowName, work email and licence check.
  3. Pay the invoiceBy card or bank transfer.
  4. Download from S3 or R2The team prepares the export and emails the bucket path, plus a read-only API key for R2 orders.

Time windows

Every window includes all 7 tables and 295 columns. Only the time range changes.

30 days
Latest month
Sep 6, 2026 → Oct 6, 2026
$400
Pay now
365 days
Last 12 months
Oct 6, 2025 → Oct 6, 2026
$2,400
Pay now
730 days
Last 24 months
Oct 6, 2024 → Oct 6, 2026
$4,800
Pay now
1,790 days
Full history
Nov 11, 2021 → Oct 6, 2026
$12,000
Pay now
In every window
  • All 7 tables, 295 columns
  • Parquet files in the layout under Delivery
  • S3 or R2 download, chosen at checkout
  • Licensed under the Data License

FAQ

17 questions
What is included in the Optimism dataset?

Seven Parquet tables with 295 documented columns in total: blocks (22), transactions (40), calls (65), events (63), transfers (24), dex_trades (54) and miner_rewards (27). Each purchase covers the window you choose, through to yesterday, refreshed daily. The Full tier starts at the genesis block of 11 November 2021 for six tables; miner_rewards is indexed from 9 July 2026.

How far back does the full history go?

To block 0 of the current chain on 11 November 2021, the regenesis that reset OP Mainnet's state. The Bedrock upgrade of June 2023 then changed how blocks are produced, from one block per transaction to fixed two-second blocks, so block-level statistics before and after it are not directly comparable; Block_Time and Block_TxCount make the boundary easy to find.

How large is the full dataset?

The largest tier by a wide margin, and calls and events dominate it; both carry several rows per transaction, where transfers and dex_trades carry one per movement. We size it per table before delivery and send you the exact figures with the manifest, so you can plan storage before downloading. If calls and events are more than you need, we can quote the other five tables on their own.

How do the tables join?

On Transaction_Hash, which appears in every table except blocks and miner_rewards; those join on Block_Number. Within a transaction, Call_Index orders the call frames, Log_Index orders the logs, Transfer_Index orders the transfers and Trade_Index orders the swaps. A log points back to the frame that emitted it through Call_Index.

What is deliberately not in this dataset?

Balance updates. The chain-wide balance_updates table exists in our store but is not part of this bundle, because it carries several rows per transfer and would dominate the size. If you need it, ask and we will quote it alongside this one.

How are decoded arguments laid out?

As parallel arrays rather than one JSON column: element i of Arguments_Type_Name, Arguments_Type_Type and the Arguments_Value_* columns all describe argument i. Each value sits in the column matching its ABI type, addresses and bytes in Arguments_Value_Bytes as hex, small integers in Arguments_Value_UInt or Arguments_Value_Int, and every value also rendered in Arguments_Value_String. The Arguments_Path_* arrays give the member path for struct and array arguments. In calls, the Returns_* columns follow the same layout for return values.

Does the dataset include the L1 data fee?

The fee columns carry what the execution layer records for the transaction: gas used, effective gas price, base fee and priority fee, in ETH and USD. The separate L1 data fee that OP Stack chains charge is not a column in this schema. If you need it, ask and we will scope it.

What are type 126 transactions?

Deposits from Ethereum. The OP Stack delivers each L1-to-L2 deposit as a system transaction with Transaction_Type 126, at the top of a block, with no signature from a user. They are included, and they are the rows to filter out if you want user activity only.

Does OP Mainnet have uncles? The schema has uncle columns.

No. OP Mainnet has a single sequencer and produces no uncle blocks, so Block_UnclesCount is 0 on every block, Block_UncleHash is the empty-list hash, and Reward_Uncle, Uncle_Block_Number and Uncle_Index in miner_rewards are 0 throughout. The columns exist because the schema is shared with chains that do have uncles; they are kept so a query written against one EVM chain runs unchanged here.

Which DEXes are in dex_trades?

Every venue we decode on OP Mainnet, in one table, identified by Trade_Dex_ProtocolFamily and Trade_Dex_ProtocolName on each row. In the sample window the families present were Uniswap, Aerodrome and Balancer. Filter the family column to keep or drop a venue.

How much of it is valued in USD?

Only currencies with an hourly price series are valued, and the dataset says so rather than filling the gap: a USD value of 0 means either a zero-value row or no price, and the column cannot tell the two apart. DEX trades are priced from the safer side of the swap, so most swaps with a stablecoin or ETH on one side carry a value; transfers of long-tail and spam tokens mostly do not.

Are failed transactions included?

Yes, throughout, and the export applies no filter of its own. TransactionStatus_Success carries the transaction's outcome on every table that has it, and dex_trades additionally carries Trade_Success, because a single swap can fail inside a transaction that succeeded. Spam tokens, zero-value rows and lookalike contracts are all kept too; the columns let you drop what you do not want.

How do I get one contract's activity?

Filter Call_To in calls and Log_SmartContract in events to the contract, lower case with 0x. For token flow, filter Transfer_Currency_SmartContract in transfers. Join on contract addresses rather than symbols or names; both repeat, and lookalike tokens copy them deliberately.

How are amounts and booleans encoded?

Amounts are decimal-adjusted decimal strings, carrying exactly as many places as the token has decimals; multiply by ten to the power of the decimals for the raw on-chain integer. Casting to float loses precision on large values. Boolean flags are the strings true and false; only the Arguments_Value_Bool and Returns_Value_Bool arrays use 0 and 1, one entry per decoded argument.

How do I load it?

One line in DuckDB: SELECT * FROM read_parquet('transfers/*.parquet') LIMIT 10. Pandas works too: pandas.read_parquet(path). The sample files open without credentials.

How is the data delivered, and how current is it?

As flat Parquet named by block range, 50 blocks per file and sorted ascending, one prefix per table, with a JSON manifest listing every file and its sha256. We prepare the files within 7 business days of purchase and email you the location. You choose at checkout where to collect them: a Requester Pays S3 bucket, downloaded with your own AWS account, or a Cloudflare R2 bucket with a read-only API key and no egress fees. Files stay available for 7 days from delivery. Enterprise orders can be delivered into your own S3, GCS or R2 bucket. Refreshed daily with T+1 latency, so a purchase made today includes everything to yesterday.

Can I try before I buy?

Yes. Each table links to a public sample file with real records, and the sample bucket holds full Parquet files you can load directly. No email address required.