Account Analysis

Tools for analyzing accounts, balances, and tokens.

1. getAccountBalance - Get native token balance for an Arbitrum address

   Demo

   • Parameters:

     • address: Ethereum address to check balance for

     • blockTag: The optional block number, hash, or tag (e.g., 'latest', 'pending', 'safe', 'finalized', 'earliest') to get the balance for. Defaults to 'latest' if unspecified.

2. getTokenBalances - Get ERC-20 token balances for an Arbitrum address, optionally filtered by a list of contract addresses.

   Demo

   • Parameters:

     • address: The owner address or ENS name to get the token balances for

     • contractAddresses: Optional list of contract addresses to filter by

3. getNfts - Get NFTs owned by an address, with options for filtering, pagination, and ordering.

   Demo

   • Parameters:

     • owner: The address of the owner

     • options: (Optional) Object containing:

       • contractAddresses: Optional list of contract addresses to filter by (Limit 45)

       • omitMetadata: Optional boolean to omit NFT metadata (default: false)

       • excludeFilters: Optional list of filters (SPAM, AIRDROPS) to exclude

       • includeFilters: Optional list of filters (SPAM, AIRDROPS) to include

       • pageSize: Max NFTs to return (API default 50, max 100)

       • tokenUriTimeoutInMs: Timeout for metadata fetch

       • orderBy: Order by 'TRANSFERTIME'

       • pageKey: Optional page key for pagination

4. getTransactionHistory - Get transaction history for an Arbitrum address, with options for filtering and pagination.

   Demo

   • Parameters:

     • address: The address to check transactions for (used as fromAddress)

     • options: (Optional) Object containing:

       • fromBlock: Start block ("0x0" default)

       • toBlock: End block ("latest" default)

       • toAddress: Recipient filter

       • contractAddresses: Contract filter (ERC20/721/1155)

       • excludeZeroValue: Exclude zero value transfers (true default)

       • order: 'asc'/'desc' by block number ('asc' default)

       • category: Array of categories (EXTERNAL, INTERNAL, ERC20, ERC721, ERC1155, SPECIALNFT)

       • maxCount: Max results per page (50 default)

       • withMetadata: Include transfer metadata (false default)

       • pageKey: Optional page key for pagination

5. getNftMetadata - Get metadata for an NFT given its contract address and token ID, with options for caching and token type.

   Demo

   • Parameters:

     • contractAddress: NFT contract address

     • tokenId: Token ID

     • options: (Optional) Object containing:

       • tokenType: Specify token type (ERC721, ERC1155, UNKNOWN)

       • tokenUriTimeoutInMs: Timeout for metadata fetch

       • refreshCache: Refresh metadata before response (false default)

6. getAccountProtocols - Analyze which smart contracts (protocols) an address interacts with most frequently.

   Demo

   • Parameters:

     • address: The address to analyze for protocol interactions

     • maxResults: Maximum number of top interacted protocol addresses to return (optional, default: 10)

---