Address

Base interface for any address on chain, whether an externally owned account (EOA) or a smart contract. Provides common fields for address identification, activity tracking, and asset balances.

Schema Definition

interface Address {
  address: AddressString!
  nonce: Int!
  lastActiveAt: Timestamp
  transactionCount: Int!
  tokenBalances(
    first: Int = 10
    after: Cursor
    where: TokenBalanceFilter
    orderBy: TokenBalanceOrderBy
    orderDirection: OrderDirection
  ): TokenBalanceList!
  nftBalances(
    first: Int = 10
    after: Cursor
    where: NFTBalanceFilter
    orderBy: NFTBalanceOrderBy
    orderDirection: OrderDirection
  ): NFTBalanceList!
  transactions(
    first: Int = 10
    after: Cursor
    where: TransactionFilter
    orderBy: TransactionOrderBy
    orderDirection: OrderDirection
  ): TransactionList!
}

Fields

Field	Type	Description
address	AddressString! non-null scalar	The address as a checksummed hex string (0x-prefixed, 42 characters).
nonce	Int! non-null scalar	Number of transactions sent from this address. For EOAs, this is the account nonce. For contracts, this represents internal transaction count.
lastActiveAt	Timestamp scalar	Timestamp of the most recent transaction involving this address, or null if never active.
transactionCount	Int! non-null scalar	Total number of transactions where this address was the sender or recipient.
tokenBalances	TokenBalanceList! non-null object	ERC-20 token balances held by this address, paginated.
nftBalances	NFTBalanceList! non-null object	NFT balances held by this address, paginated.
transactions	TransactionList! non-null object	Transactions involving this address as sender or recipient, paginated.

tokenBalances Arguments

Argument	Type	Description
first	Int scalar	Maximum number of results to return (default: 10, max: 100).
after	Cursor scalar	Cursor for pagination. Pass the endCursor from a previous query to get the next page.
where	TokenBalanceFilter input	Filter criteria for token balances.
orderBy	TokenBalanceOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

nftBalances Arguments

Argument	Type	Description
first	Int scalar	Maximum number of results to return (default: 10, max: 100).
after	Cursor scalar	Cursor for pagination. Pass the endCursor from a previous query to get the next page.
where	NFTBalanceFilter input	Filter criteria for NFT balances.
orderBy	NFTBalanceOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

transactions Arguments

Argument	Type	Description
first	Int scalar	Maximum number of results to return (default: 10, max: 100).
after	Cursor scalar	Cursor for pagination. Pass the endCursor from a previous query to get the next page.
where	TransactionFilter input	Filter criteria for transactions.
orderBy	TransactionOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

Returned By

address query

Member Of

AddressList object ● BlockTransaction object ● Contract object ● EOA object ● IContract interface ● NFTContract object ● NFTContractHolder object ● NFTHolder object ● SingleHolder interface ● SingleHolderNFT object ● Token object ● TokenHolder object ● Transaction object

Implemented By

Contract object ● EOA object ● IContract interface ● NFTContract object ● Token object