Skip to main content
A wallet view is built from a few core data sources: balances, transaction history, token movements, and address metadata. This guide shows the endpoints behind each piece. New to the API? Start with Make your first call.
Every endpoint in this guide works on all 60+ supported chains, just switch the chainid. For example, set chainid=42161 to read the same wallet on Arbitrum. See Supported chains for the full list.

​
Portfolio

Show what a wallet holds: native coins, ERC-20 tokens, and NFT assets.
1

Get the native balance

Retrieve the wallet’s native coin balance. The value is returned in wei, so divide by 10^18 for display.
2

Get ERC-20 token holdings

ERC-20 token balances held by the address, for displaying the token portfolio. This is a PRO endpoint, available to the Standard plan and above.
3

Get ERC-721 (NFT) holdings

ERC-721 NFT holdings for displaying NFT assets owned by the address. This is a PRO endpoint, available to the Standard plan and above.

​
Activity

Build the wallet’s activity history: transactions it sent, value moved by contracts, and token transfers.
1

Normal transactions

The regular transactions the address signed: sends, receives, and contract calls. The backbone of any activity feed.
2

Internal transactions

Internal transactions are value transfers triggered by contract execution. They are separate from normal transactions, so include them when tracking complete fund movements.
3

ERC-20 transfers

Every ERC-20 token that moved in or out of the address, for a token activity feed.
4

ERC-721 transfers

ERC-721 NFT transfers in and out of the address, showing when each NFT was acquired or sold.

​
Name Tags

Replace raw addresses with recognizable names and labels to make wallet activity easier to understand.
1

Look up an address name tag and labels

Returns the same name tag, labels, and reputation shown on etherscan.io, part of Etherscan Metadata. Use it to label the wallet and the counterparties in its activity feed. This is a PRO endpoint, available on the Pro Plus plan.

​
Putting it together

Combine these endpoints to create a wallet experience:
  • Portfolio view: balance + addresstokenbalance + addresstokennftbalance
  • Activity feed: txlist + txlistinternal + tokentx + tokennfttx
  • Readable identities: getaddresstag
Use the same approach across each supported chain by changing the chainid.