Token

A fungible token contract implementing ERC-20 or a compatible standard. Fungible tokens are interchangeable - each unit is identical to every other unit. Examples: USDC, WETH, UNI, LINK.

Schema Definition

type Token implements HasDecimals, IContract, 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!
  standards: [Standard!]!
  name: String
  symbol: String
  createdAt: Timestamp
  createdInBlock: Block
  createdByTransaction: Transaction
  creator: Address
  decimals: Int!
  totalSupply: TokenAmount!
  holdersCount: Int!
  holders(
    first: Int = 10
    after: Cursor
    where: TokenHolderFilter
    orderBy: TokenHolderOrderBy
    orderDirection: OrderDirection
  ): TokenHolderList!
}

Fields

Field	Type	Description
address	AddressString! non-null scalar	The token contract address as a checksummed hex string (0x-prefixed, 42 characters).
nonce	Int! non-null scalar	Number of internal transactions or contract interactions initiated by this token contract.
lastActiveAt	Timestamp scalar	Timestamp of the most recent transaction involving this token contract, or null if never active after deployment.
transactionCount	Int! non-null scalar	Total number of transactions where this token contract was involved (transfers, approvals, etc.).
tokenBalances	TokenBalanceList! non-null object	ERC-20 token balances held by this token contract itself, paginated. Tokens held by the contract address.
nftBalances	NFTBalanceList! non-null object	NFT balances held by this token contract itself, paginated.
transactions	TransactionList! non-null object	Transactions involving this token contract, paginated.
standards	[Standard!]! non-null enum	Token standards implemented by this contract. Will include ERC20 and possibly others.
name	String scalar	Human-readable name of the token (e.g., USD Coin, Wrapped Ether), or null if not available.
symbol	String scalar	Token symbol used for display (e.g., USDC, WETH), or null if not available.
createdAt	Timestamp scalar	Timestamp when the token contract was deployed to the blockchain.
createdInBlock	Block object	The block in which the token contract was deployed.
createdByTransaction	Transaction object	The transaction that deployed this token contract.
creator	Address interface	The address (EOA or contract) that deployed this token contract.
decimals	Int! non-null scalar	Number of decimal places used to represent token amounts. Common values: 18 (most tokens), 6 (USDC, USDT), 8 (WBTC).
totalSupply	TokenAmount! non-null object	Total supply of tokens currently in existence, including raw and formatted values.
holdersCount	Int! non-null scalar	Number of unique addresses holding a non-zero balance of this token.
holders	TokenHolderList! non-null object	Paginated list of addresses holding this token and their balances.

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).

holders 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	TokenHolderFilter input	Filter criteria for token holders.
orderBy	TokenHolderOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

Interfaces

Interface	Description
HasDecimals interface	Implemented by token contracts that use decimal precision for amounts. Primarily ERC-20 tokens and similar fungible token standards where amounts need decimal representation.
IContract interface	Base interface for smart contracts deployed on chain. Extends the Address interface with contract-specific metadata including deployment information and token standards.
Address interface	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.

Returned By

token query

Member Of

TokenBalance object ● TokenList object