Get Token Details Premium Endpoint

💡Premium Endpoint

To use this API, you will need an API key associated with a Moralis account on the Pro plan or higher.

GEThttps://deep-index.moralis.io/api/v2.2/discovery/token

Retrieve comprehensive details for a specific token, including metadata and stats. For more detailed tokens stats we recommended to use getTokenAnalytics or getMultipleTokenAnalytics. For pair stats, we recommend to use getPairStats.

QUERY PARAMS

chainstringrequired

The chain to query

ethmainnet0x1matic0x89polygonbscbinance0x38fantomftm0xfaarbitrum0xa4b1optimism0xabase0x2105linea0xe7080x7e4roninsei0x531

token_addressstringrequired

The address of the token

Responses

200Returns the token details

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/discovery/token?chain=eth&token_address=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Node.js

// 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/discovery/token?chain=eth&token_address=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

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

import requests

url = "https://deep-index.moralis.io/api/v2.2/discovery/token?chain=eth&token_address=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"

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

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

print(response.text)

Go

package main

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

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/discovery/token?chain=eth&token_address=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"

  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

<?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/discovery/token?chain=eth&token_address=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the token details

{
  "chain_id": "0x1",
  "token_address": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
  "token_name": "Maker",
  "token_symbol": "MKR",
  "token_logo": "",
  "block_number": "",
  "block_timestamp": "",
  "rating": "",
  "total_number_of_rating": "",
  "total_liquidity_locked_in_percent": "",
  "total_supply_locked_in_percent": "",
  "price_usd": "",
  "token_age_in_days": "",
  "on_chain_strength_index": "",
  "security_score": 88,
  "market_cap": 1351767630.85,
  "fully_diluted_valuation": 1363915420.28,
  "twitter_followers": 255217
}