blocktorch
Search
K
🧞♂

Queries

Queries can be used to find some high level information super fast or to look for deeply layered metadata as well as building very complex monitors.
if you have specific queries you want to build and cannot find the relevant facet you need don't hesitate to reach out.

Facets overview

Search (logs) facets

The search for logs supports fuzzy search, so simply search for any keyword or data. For example for wallets, contracts, status (Success/Fail) simply search for it directly. Fuzzy search can be combined with the query chips
To following query chips are provided:
Facet key
Values
Info
chain
Ethereum, Polygon, BNB chain, Optimism, Arbitrum, Base, Gnosis Chain
By default search is multichain
contract address
the address of a contract starting with 0x
type
Dragon, Transactions, Traces
Dragon data only shows up if the Dragon SDK is installed
timestamp
timerange as Dates or Date/Time format
Data is supported on a 7 day trailing time period for free users
block(s)
specific block number or range between two blocks
gas
specific gas units or range of gas as integers
transaction hash
hash of a transaction starting with 0x
transaction status
Success, Fail

Monitor facets for metrics and conditions

To query all values from the facet do not set a condition
Metric: Transaction Gas Used
  • Metric type:
    • positive integer
  • Unit:
    • gas units
  • Functions:
    • SUM
    • AVERAGE
    • COUNT
    • MAX
    • MIN
  • Source:
    • EVM Node
  • Info:
    • gas units are a quantitative measure, not to be confused with gas paid in gwei
Metric: Transaction Count
  • Metric type:
    • positive integer
  • Unit:
    • count
  • Functions:
    • COUNT
  • Source:
    • EVM Node
  • Info:
    • Transaction Count only works without setting a condition, so to get purely the count of transactions of a smart contract remove the conditional input field
Metric: Transaction Status
  • Metric type:
    • positive integer
  • Unit:
    • if used as a condition, depending on facet chosen. If used as a facet only count of transactions
  • Functions:
    • COUNT
    • SUM
    • AVERAGE
    • MIN
    • MAX
  • Source:
    • EVM Node
  • Info:
    • values are case sensitive
Metric: Transaction Index
  • Metric type:
    • positive integer
  • Unit:
    • index position
  • Functions:
    • SUM
    • AVERAGE
    • COUNT
    • MAX
    • MIN
  • Source:
    • EVM Node
  • Info:
    • The index of the transaction within the block
Metric: Transaction Value
  • Metric type:
    • positive integer
  • Unit:
    • value of transaction in wei
  • Functions:
    • SUM
    • AVERAGE
    • COUNT
    • MAX
    • MIN
  • Source:
    • EVM Node
Metric: Transaction Gas Price
  • Metric type:
    • positive integer
  • Value:
    • gwei
  • Functions:
    • SUM
    • AVERAGE
    • COUNT
    • MAX
    • MIN
  • Source:
    • EVM Node
  • Info:
    • the gas price is the base fee for the transaction to be mined
Metric: Transaction Max Fee Per Gas
  • Metric type:
    • positive integer
  • Value:
    • gwei
  • Functions:
    • SUM
    • AVERAGE
    • COUNT
    • MAX
    • MIN
  • Source:
    • EVM Node
  • Info:
    • The maximum fee amount a user is willing to pay for the transaction

Monitor Operators overview

Operator
sign
available for value of type
meaning
Equal
=
string, integer
Filter for results only containing the specified value
Unequal
!=
string, integer
Exclude all results containing the specified value
Less than
<
integer
Filter for results containing values smaller than the specified value, excluding the specified value
Greater than
>
integer
Filter for results containing values greater than the specified value, excluding the specified value
Equal and less than
>=
integer
Filter for results containing values smaller than the specified value, including the specified value
Equal and greater than
=<
integer
Filter for results containing values greater than the specified value, including the specified value