Links

Accounts API

Learn all the detailed references of Accounts API that provide ERC6551 accounts information, including the input filters, supported chains, and output fields.
The Accounts API fetches the list of all ERC6551s or TBAs (token-bound accounts), both deployed on-chain and non-deployed (optimistic).

Supported ERC6551 Registries

Currently, Airstack indexes all the official ERC6551 registry contracts on Ethereum, Polygon, and Base:
If you are deploying ERC6551 using a custom registry contract, please reach out to us to add it to the Airstack API by joining our Telegram.

Inputs

Filter

Name
Type
Description
standard
AccountStandard_Comparator_Exp
The standard of the ERC6551.
tokenAddress
Address_Comparator_Exp
The token address of the ERC721 token that owns the ERC6551.
tokenId
String_Comparator_Exp
The token ID of the ERC721 token that owns the ERC6551.
address
Identity_Comparator_Exp
The address of an ERC6551 account.
createdAtBlockTimestamp
Time_Comparator_Exp
The block timestamp of the ERC6551 creation transaction.
registry
Address_Comparator_Exp
The registry of the ERC6551 account. This can be used to fetch certain versions of ERC6551 accounts. For non-deployed (optimistic) accounts in tokenNfts nested queries, this defaults to registry v.0.3.1
implementation
Address_Comparator_Exp
The implementation address of the ERC6551 account. For non-deployed (optimistic) accounts in tokenNfts nested queries, this defaults to the official standard ERC6551 implementation address.
salt
String_Eq_Comparator_Exp
The salt of ERC6551 account. For non-deployed (optimistic) accounts in tokenNfts nested queries, this defaults to 0.

Blockchain

Enum
Description
ethereum
Ethereum mainnet
polygon
Polygon mainnet
base
Base mainnet

Order

Name
Description
createdAtBlockTimestamp
Sort the result by the block timestamp of the ERC6551 creation transaction, either in ascending (ASC) or descending (DESC) order.

Nested Input*

The nested inputs only appear within the nested input, but not for top-level Accounts APIs.
Name
Type
Description
showOptimisticAddress
Boolean
If set true, it will show all the optimistic/non-deployed TBA addresses. Otherwise, the optimistic/non-deployed TBAs will be hidden and only the deployed ones will be shown.

Outputs

Name
Type
Description
id
ID!
Airstack unique identifier for the ERC6551 account.
standard
AccountStandard!
The standard of the ERC6551.
blockchain
Blockchain
The blockchain where the ERC6551 token-bound account is deployed.
tokenAddress
String
The token address of the ERC721 token that owns the ERC6551.
tokenId
String
The token ID of the ERC721 token that owns the ERC6551.
address
Wallet!
The details of an ERC6551 account (address, socials, token balances).
registry
String
The registry address used to deploy the smart contract wallet.
implementation
String
The implementation address of the on-chain smart contract account.
salt
String
The salt for ERC6551 creation.
createdAtBlockNumber
Int
The block number of the ERC6551 creation transaction. For non-deployed (optimistic) accounts in tokenNfts nested queries, this will return -1 as the account was never deployed on-chain.
createdAtBlockTimestamp
Time
The block timestamp of the ERC6551 creation transaction. For non-deployed (optimistic) accounts in tokenNfts nested queries, this will return null as the account was never deployed on-chain.
creationTransactionHash
String
The transaction Hash of the ERC6551 creation transaction. For non-deployed (optimistic) accounts in tokenNfts nested queries, this will return null as the account was never deployed on-chain.
deployer
String
The address of the deployer.
nft
TokenNft
The NFT that owns the ERC6551 account.
updatedAtBlockNumber
Int
The block number of the latest update on the ERC6551.
updatedAtBlockTimestamp
Time
The block timestamp of the latest update on the ERC6551.