Get ERC20 token metadata by symbols

GEThttps://deep-index.moralis.io/api/v2.2/erc20/metadata/symbols

Fetch metadata (name, symbol, decimals, logo) for a list of ERC20 token symbols.

QUERY PARAMS

chainstring

The chain to query

symbolsarrayrequired

The symbols to get metadata for

No items in the array

Responses

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

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL
Node.js
Python
Go
PHP

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/erc20/metadata/symbols?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/erc20/metadata/symbols?chain=eth', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/erc20/metadata/symbols?chain=eth"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/erc20/metadata/symbols?chain=eth"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/erc20/metadata/symbols?chain=eth', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

[
  {
    "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "address_label": "Binance 1",
    "name": "Kylin Network",
    "symbol": "KYL",
    "decimals": "18",
    "logo": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    "logo_hash": "ee7aa2cdf100649a3521a082116258e862e6971261a39b5cd4e4354fcccbc54d",
    "thumbnail": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c_thumb.png",
    "total_supply": "420689899999994793099999999997400",
    "total_supply_formatted": "420689899999994.7930999999999974",
    "implementations": [
      ""
    ],
    "fully_diluted_valuation": "3407271444.05",
    "block_number": "",
    "validated": "",
    "created_at": "",
    "possible_spam": "false",
    "verified_contract": "",
    "categories": [
      ""
    ],
    "circulating_supply": "4206864.7489303",
    "market_cap": "3407271444.05"
  }
]

Don't have an API key yet?

Get ERC20 token metadata by symbols