Skip to main content

Input objects

Erc20BalancesFilter

Arguments

NameDescription
ownerAddress
EnsAddress!

Owner address

Erc20TransfersFilter

Arguments

NameDescription
fromAddresses
[EnsAddress]

A list of addresses who received the NFT. Ignored when empty.

toAddresses
[EnsAddress]

A list of addresses who received the NFT.

blockNumbers
[Int!]

A list of block numbers to include transfers from

contractAddresses
[String]

A contract to include transfers from.

exclude
[ExcludeTransferFilter!]

Categories to exclude transfers from

NativeTransferFilter

Arguments

NameDescription
fromAddresses
[EnsAddress!]

A list of addresses who received the native token. Ignored when empty.

toAddresses
[EnsAddress]

A list of addresses to whom the native token was sent. Ignored when empty.

blockNumbers
[Int!]

A list of block numbers to include transfers from

includeFailedTransactions
Boolean

Whether to include traces from failed transactions.

includeErroredTraces
Boolean

Whether to include traces that errored.

TokensFilter

Arguments

NameDescription
ownerAddresses
[String!]

A list of addresses who own the returned tokens.

TransactionFilter

Arguments

NameDescription
fromAddresses
[EnsAddress!]

A list of addresses who initiated transactions. Ignored when empty.

toAddresses
[EnsAddress]

A list of addresses to whom a transaction was sent. Add nil to include contract creation transactions. Ignored when empty.

blockNumbers
[Int!]

A list of block numbers to include transactions from

methodIds
[String!]

A list of methodIds as specified in the first 4 bytes of calldata. Note: this field is not verified to be a valid call. Addresses may send transactions with arbitrary data.

TransactionLogFilter

Arguments

NameDescription
addresses
[EnsAddress!]

A list of contract addresses from which this log was emitted. Ignored when empty.

topics
[[LogTopic!]!]

A list of topics to search for.

Formatting

  • Hex encoded: "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
  • Address: "0xC02AAA39B223FE8D0A0E5C4F27EAD9083C756CC2"
  • ENS address: "gotu.eth"
  • Signature: "Transfer(address,address,uint256)"

Filtering

Topics filter is a list of lists, similar to eth_getLogs. When a second, third or fourth topic has been specified, the first topic must be specified for performance reasons.

  • [[]]: Any topic in the first position
  • [["Transfer(address,address,uint256)"], [], []]: Must match the first topic, any topic in the second and third position, these cannot be null.`
  • [["Transfer(address,address,uint256)"], [], ["gotu.eth", "vitalik.eth"]]: Must match the first topic, any topic in the second position, must match any of the addresses in the third position.`
includeRemoved
Boolean

Whether to include logs which were removed during a block reorg, defaults to false.

blockNumbers
[Int!]

A list of block numbers to include transaction logs from. Cannot be used in combination with toBlock and fromBlock.

toBlock
Int

An upper bound on the block range to include logs from. Cannot be used in combination with blockNumbers.

fromBlock
Int

A lower bound on the block range to include logs from. Cannot be used in combination with blockNumbers.

transaction
TransactionLogTransactionFilter

Filter on the transactions in which a log was emitted.

blockHashes
[String!]

A list of block hashes to include transaction logs from. Cannot be used in combination with blockNumbers or fromBlock/toBlock

TransactionLogTransactionFilter

Arguments

NameDescription
toAddresses
[EnsAddress]

A list of addresses to whom a transaction which emitted this log was sent. Add nil to include contract creation transactions. Ignored when empty.

fromAddresses
[EnsAddress!]

A list of addresses who initiated the transaction this log was emitted from. Ignored when empty.

TransfersFilter

Arguments

NameDescription
fromAddresses
[EnsAddress]

A list of addresses who received the NFT. Ignored when empty.

toAddresses
[EnsAddress]

A list of addresses who received the NFT.

blockNumbers
[Int!]

A list of block numbers to include transfers from

toBlock
Int

An upper bound on the block range to include erc721 transfers from. Cannot be used in combination with blockNumbers.

fromBlock
Int

A lower bound on the block range to include erc721 transfers from. Cannot be used in combination with blockNumbers.

blockHashes
[String!]

A list of block hashes to include erc721 transfers from. Cannot be used in combination with blockNumbers or fromBlock/toBlock

contractAddresses
[String]

A contract to include transfers from.

tokenIds
[String]

Token ids to include transfers from

exclude
[ExcludeTransferFilter!]

Categories to exclude transfers from

TransfersInterfaceFilter

Arguments

NameDescription
fromAddresses
[EnsAddress]

A list of addresses who received the asset. Ignored when empty.

toAddresses
[EnsAddress]

A list of addresses who received the NFT.

blockNumbers
[Int!]

A list of block numbers to include transfers from