alchemy_getTokenMetadata

Returns metadata (name, symbol, decimals, logo) for a given token contract address.

ChainMainnetTestnet
Ethereum:white-check-mark::white-check-mark:
Polygon:white-check-mark::white-check-mark:
Optimism:white-check-mark::white-check-mark:
Arbitrum:white-check-mark::white-check-mark:

Helpful tips

name, symbol and decimals are optional methods in the ERC-20 token standard. Therefore, not all contracts will respond correctly to calls requesting this information. While the incorrectness or absence of name and symbol can be an inconvenience, having the correct decimals is absolutely crucial in displaying token balances or converting user inputs accurately when communicating with the contract.

How is token metadata updated?

Alchemy maintains a regularly updated database of contract metadata, with values gathered and intelligently merged from the contracts themselves along with several other sources. Alchemy is therefore able to provide clean, accurate, up-to-date metadata for contracts that may be missing any of these methods or have changed their name or symbol since contract publication.

As a bonus, token logo images are available for many of the popular tokens.

Language
Click Try It! to start a request and see the response here!