Skip to main content
Version: 2.2

Token API - Full Guide & Walkthrough

What is a Token API?

An Token API is a collection of APIs that can be used to index ERC20 token-related data, e.g. ERC20 token balance, ERC20 token metadata, from multiple EVM chains that we support.

The Token API is designed to provide high-quality, structured NFT data to developers to build application that interact with various ERC20 tokens.

Therefore, the ideal use cases for the Token API are listed as below, but not limited to:

Get Price

The Get Price API is a collection of Token API that provides developer with real-time price data of ERC20 tokens indexed from multiple DEXs on multiple chains.

This API category comprised of 2 APIs:

API NamePathUse Cases
getMultipleTokenPrices/erc20/pricesFetch multiple ERC20 token prices.
getTokenPrice/erc20/{address}/priceFetch an ERC20 token price specified by its address.

Get Balance

The Get Balance API is a collection of Token API that provides developer with real-time balances and allowances of ERC20 tokens on wallet addresses.

This API category comprised of 2 APIs:

API NamePathUse Cases
getWalletTokenBalances/{address}/erc20Fetch ERC20 token balances for a specific wallet address.
getTokenAllowance/erc20/{address}/allowanceFetch the allowance of a specific ERC20 token given its address by the spender_address on behalf of the owner_address.

Get Transfers

The Get Transfers API is a collection of Token API that provides developer with all ERC20 token transfers on the EVM chains the Moralis supported.

This API category comprised of 3 APIs:

API NamePathUse Cases
getErc20Transfers/erc20/transfersFetch historical ERC20 token transactions ordered by descending block order.
getWalletTokenTransfers/{address}/erc20/transfersFetch historical ERC20 token transactions on a given wallet address by descending block order.
getTokenTransfers/erc20/{address}/transfersFetch historical ERC20 token transactions on a given ERC20 token address by descending block order.

Get Mints

The Get Mints API is a collection of Token API that provides developer with real-time minting information on any ERC20 tokens.

This API category comprised of 1 API:

API NamePathUse Case
getErc20Mints/erc20/mintsFetch ERC20 token mints, minted by one or many wallet addresses and/or contract addresses, ordered by block number in descending order.

Get Burns

The Get Burns API is a collection of Token API that provides developer with real-time burning information on any ERC20 tokens.

This API category comprised of 1 API:

API NamePathUse Case
getErc20Burns/erc20/burnsFetch ERC20 token burns, burned by one or many wallet addresses and/or contract addresses, ordered by block number in descending order.

Get Approvals

The Get Approvals API is a collection of Token API that provides developer with real-time approvals information on any ERC20 tokens.

This API category comprised of 1 API:

API NamePathUse Case
getErc20Approvals/erc20/approvalsFetch ERC20 approvals for one or many wallet addresses and/or contract addresses, ordered by block number in descending order.

Get Metadata

The Get Metadata API is a collection of Token API that provides developer with detailed metadata on any ERC20 tokens.

This API category comprised of 2 APIs:

API NamePathUse Case
getTokenMetadata/erc20/metadataFetch the metadata (name, symbol, decimals, logo) of a given ERC20 token contract address.
getTokenMetadataBySymbol/erc20/metadata/symbolsFetch the metadata (name, symbol, decimals, logo) of a given ERC20 token's symbol.

How to get started?

To get started with Moralis Token API, there are two methods that can be used, depending on the programming language that you are using:

Programming LanguagesMethod
JavaScript/TypeScript, PythonMoralis SDKs
Others (e.g. Java, C/C++, Ruby, etc.)REST API

For this guide, we'll particularly use the Moralis SDK for examples.

If you would like to use other languages calling the Moralis Token API using regular REST API call, then make sure to check the Token API reference pages to get all the parameters and responses type.

Step 1: Install the Moralis SDK

First register your Moralis account and get your Moralis API Key.

Once you have your Moralis API Key, install the Moralis SDK in your project.

npm install moralis

Step 2: Add to Your Code

To use the Token API, it is very simple. All the Token API can be called by using Moralis.EvmApi.token.{apiName} where apiName will be replaced by the Token API used.

In this guide, suppose you are building a simple ERC20 token explorer that helps user get information on a specific ERC20 token address.

Let's start to use the Token API to build these three initial features:

Feature #1: Fetch the Metadata of an ERC20 token

Here you'll need two parameters: addresses and chain.

Once you've obtained both the addresses and chain, you can copy the following code and add it to your existing codebase:

const Moralis = require("moralis").default;
const { EvmChain } = require("@moralisweb3/common-evm-utils");

const runApp = async () => {
await Moralis.start({
apiKey: "YOUR_API_KEY",
// ...and any other configuration
});

const addresses = ["ERC20_TOKEN_ADDRESS"];

const chain = "CHAIN"; // e.g EvmChain.ETHEREUM, EvmChain.POLYGON

const response = await Moralis.EvmApi.token.getTokenMetadata({
chain,
addresses,
});

console.log(response.raw);
};

runApp();

Once the code is added, you will be able to obtain all the metadata, which includes name, symbol, and decimals information on a given specific ERC20 token address using just a few lines of code with Moralis Token API.

Feature #2: Fetch the balance of an ERC20 token in the user's wallet address

Here you'll need three parameters: address, tokenAddresses, and chain.

Once you've obtained both the address, tokenAddresses, and chain, you can copy the following code and add it to your existing codebase:

const Moralis = require("moralis").default;
const { EvmChain } = require("@moralisweb3/common-evm-utils");

const runApp = async () => {
await Moralis.start({
apiKey: "YOUR_API_KEY",
// ...and any other configuration
});

const address = "USER_WALLET_ADDRESS";

const tokenAddresses = ["ERC20_TOKEN_ADDRESS"];

const chain = "CHAIN"; // e.g EvmChain.ETHEREUM, EvmChain.POLYGON

const response = await Moralis.EvmApi.token.getWalletTokenBalances({
chain,
tokenAddresses,
address,
});

console.log(response.raw);
};

runApp();

Once the code is added, you will be able to obtain the balance of a given specific ERC20 token address held in the user wallet address using just a few lines of code with Moralis Token API.

Feature #3: Fetch the price of a given ERC20 token

Here you'll need two parameters: address and chain.

Once you've obtained both the address and chain, you can copy the following code and add it to your existing codebase:

const Moralis = require("moralis").default;
const { EvmChain } = require("@moralisweb3/common-evm-utils");

const runApp = async () => {
await Moralis.start({
apiKey: "YOUR_API_KEY",
// ...and any other configuration
});

const address = "ERC20_TOKEN_ADDRESS";

const chain = "CHAIN"; // e.g EvmChain.ETHEREUM, EvmChain.POLYGON

const response = await Moralis.EvmApi.token.getTokenPrice({
chain,
address,
});

console.log(response.raw);
};

runApp();

Once the code is added, you will be able to obtain real-time pricing data on the given ERC20 token using just a few lines of code with Moralis Token API.

Step 3: Going Live!

Once you have a few lines of new code, you have successfully integrated the Moralis Token API to your simple ERC20 token explorer app.

Now, it's time to push your code to production.

Before doing so, make sure that your API key is stored in a secure place. The best practice for this will be:

  • Storing your API key in an environment variable (secrets) process.env
  • Have your API called on the backend. While it is possible to call the NFT API on the fronted, it is highly discouraged as it can easily reveal your API key on the browser.

Once everything checks out, your app is good to go live with Moralis Token API! 🚀