qn_getTokenMetadataBySymbol (v2) RPC Method - Token and NFT API

Please note that this RPC method requires the Token and NFT API v2 bundle add-on enabled on your QuickNode endpoint. Additionally, for a contract to be fully indexed, it must be verified on Etherscan.

Parameters

array

array

Loading...

object

Loading...

symbol

string

Loading...

page

integer

Loading...

perPage

integer

Loading...

Returns

pageNumber

Loading...

totalPages

Loading...

totalItems

Loading...

tokens

Loading...

name

Loading...

symbol

Loading...

address

Loading...

decimals

Loading...

genesisBlock

Loading...

genesisTransaction

Loading...

Request

curl https://docs-demo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_getTokenMetadataBySymbol",
    "params": [{
      "symbol": "USDC"
    }]
  }'

 require 'eth'

 client = Eth::Client.create 'https://docs-demo.quiknode.pro/'

 payload = {
     "id":67,
     "jsonrpc":"2.0",
     "method":"qn_getTokenMetadataBySymbol",
     "params": [{
       "symbol": "USDC"
     }]
  }

 response = client.send(payload.to_json)
 puts response

import { ethers } from "ethers";
(async () => {
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
  const heads = await provider.send("qn_getTokenMetadataBySymbol", [
    {
      symbol: "USDC",
    },
  ]);
  console.log(heads);
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getTokenMetadataBySymbol",
  "params": [{
    "symbol": "USDC"
  }]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.quiknode.pro/"

payload = json.dumps({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getTokenMetadataBySymbol",
  "params": [{
    "symbol": "USDC"
  }]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getTokenMetadataBySymbol",
  "params": [{
    "symbol": "USDC"
  }]
})

response = https.request(request)
puts response.read_body

from web3 import Web3, HTTPProvider
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/'))
resp = w3.provider.make_request('qn_getTokenMetadataBySymbol', [{
  "symbol": "USDC"
}])
print(resp)

import { Core } from '@quicknode/sdk'

const core = new Core({
  endpointUrl: "https://docs-demo.quiknode.pro/",
  config: {
    addOns: {
      nftTokenV2: true,
    },
  },
})

core.client
    .qn_getTokenMetadataBySymbol(
      { symbol: "WETH", perPage: 2 }
    )
    .then(res => console.log(res))

Response

{
  "jsonrpc": "2.0",
  "id": 67,
  "result": {
    "tokens": [
      {
        "name": "RUSDC",
        "symbol": "USDC",
        "contractAddress": "0x732ed72509c3ac9ed1af61510c43dc454e6db75c",
        "decimals": "6",
        "genesisBlock": "19680970",
        "genesisTransaction": "0x8506f1216c008f1478a5fa984944a227a44bcd829d526bd2acf9dff49fc9789a"
      },
      {
        "name": "USD Coin (PoS)",
        "symbol": "USDC",
        "contractAddress": "0x566957ef80f9fd5526cd2bef8be67035c0b81130",
        "decimals": "6",
        "genesisBlock": null,
        "genesisTransaction": null
      },
      {
        "name": "USD Coin (Arb1)",
        "symbol": "USDC",
        "contractAddress": "0x5c14172d3876200ad4063a33aee47a281020d4b3",
        "decimals": "6",
        "genesisBlock": null,
        "genesisTransaction": null
      },
      {
        "name": "USD Coin",
        "symbol": "USDC",
        "contractAddress": "0x969c5e0cd6658e1c4a273120481d8817b509a9ae",
        "decimals": "6",
        "genesisBlock": "17933593",
        "genesisTransaction": "0xf84c194d02d1828ce6fc8d2552d9454739d37101af502890eb525eb8807918ef"
      },
      {
        "name": "USD Coin",
        "symbol": "USDC",
        "contractAddress": "0x7b90b3eaa113fa733869bfa401b86e04cea7eb48",
        "decimals": "6",
        "genesisBlock": "17273354",
        "genesisTransaction": "0x4e50728790047ad5ef6d70080a7a74d5659a9f4b84ea08456cdbf077ffc760c3"
      },
      {
        "name": "USD CRYPTO",
        "symbol": "USDC",
        "contractAddress": "0x7dd41ab7298181581a05d7c46a199f6ba77aac96",
        "decimals": "6",
        "genesisBlock": "7041374",
        "genesisTransaction": "0x7a0a5ab7740f26b5354fe6d0ea933a4e4393103edaf15fb5d0db11e0e139b95f"
      },
      {
        "name": "USD CLASSIC",
        "symbol": "USDC",
        "contractAddress": "0xc93a59888e7e6f2849ba94acf767266299c4c415",
        "decimals": "8",
        "genesisBlock": "6886723",
        "genesisTransaction": "0x3889aa64997d15841a6ef309469afa0e871a72aed5599db290946fa505cf11b2"
      },
      {
        "name": null,
        "symbol": null,
        "contractAddress": "0x59ef697894da6f943ce8d534b98f89cdbfbc763d",
        "decimals": null,
        "genesisBlock": "7141781",
        "genesisTransaction": "0xeb2f3c01438c2c357e7b3815829b016d66d4b58a004e0ce1ea9915772d12c230"
      },
      {
        "name": "Usdcoins",
        "symbol": "USDC",
        "contractAddress": "0x1f8abd8e5fb90c7c4076fca58fe335ba55da5945",
        "decimals": "18",
        "genesisBlock": "5367027",
        "genesisTransaction": "0xdd28b5b301413560b6710fa4d41daa7c39c5ad87dc2d824fb56863b83bdd0758"
      },
      {
        "name": "USDC",
        "symbol": "USDC",
        "contractAddress": "0xb9e31a22e3a1c743c6720f3b723923e91f3c0f8b",
        "decimals": "18",
        "genesisBlock": "5690329",
        "genesisTransaction": "0xd63128b64436182847e7d36ece3f1fb13d5b14ef5dc9f77563be3f674552097c"
      },
      {
        "name": "USD Coin ",
        "symbol": "USDC",
        "contractAddress": "0x763ea572940b6c30b83aa2c52b62981b63f51748",
        "decimals": "4",
        "genesisBlock": "6188338",
        "genesisTransaction": "0x9841631d695af74454f79e366a02511c9f331f8bcc40c2a7744fa8b325a79b24"
      },
      {
        "name": "USD Coin (USDC)",
        "symbol": "USDC",
        "contractAddress": "0x008b01bd2fe6cebe1990abde4584c8d98584683f",
        "decimals": "6",
        "genesisBlock": "17407225",
        "genesisTransaction": "0x11511b77b3d3b3be69e1ff9bcb316bfd9a3183ef44578151e23b966485c4e8cb"
      },
      {
        "name": "USDC",
        "symbol": "USDC",
        "contractAddress": "0xf53f5ca534d30674aa1fa5b1b221c6bf777ffc5c",
        "decimals": "6",
        "genesisBlock": "18963017",
        "genesisTransaction": "0x18537fcd9b6716a736d8455f8e2d3604839c88d11aeb88c5c672ef4c35a4918b"
      },
      {
        "name": "USD Coin (USDC)",
        "symbol": "USDC",
        "contractAddress": "0x03d2bad5ed52975fa68337d65cace7e2045a4b8f",
        "decimals": "15",
        "genesisBlock": "17559027",
        "genesisTransaction": "0x74e7be031b29897e1bb93e7832a9d0845f1fcd301ab0a4ab8d071a5b23bdb897"
      },
      {
        "name": "USD...C",
        "symbol": "USDC",
        "contractAddress": "0x04b4c8bac137789ee37a4788026e5fa5094ddd86",
        "decimals": "15",
        "genesisBlock": "17591068",
        "genesisTransaction": "0x286e07b299c931d940c14f43e1e874bc7ded110170aa1c1c40728ffec2abd6a7"
      },
      {
        "name": "USDCoin",
        "symbol": "USDC",
        "contractAddress": "0x00df26b7412981f31eb043350e939ec0751bd786",
        "decimals": "15",
        "genesisBlock": "17521370",
        "genesisTransaction": "0x8619f976692ac229b525b9639d1e1942bde6fbd94a3558741dfa92277e469994"
      },
      {
        "name": "USD Coin",
        "symbol": "USDC",
        "contractAddress": "0x0634fb92ebf80d27e8bf167f3babf2590d9e2fab",
        "decimals": "6",
        "genesisBlock": "18032272",
        "genesisTransaction": "0x598afcbfd544406d038e6885a8b405d311733b4bcb8fa820b20f799281f66d4c"
      },
      {
        "name": "USDC",
        "symbol": "USDC",
        "contractAddress": "0x81559f30086badc59b8403e5256f8ea8c5522f40",
        "decimals": "6",
        "genesisBlock": "19918390",
        "genesisTransaction": "0x9bfbe92444acd84ee9b4452e6c40ff0fd84fb5fba8c03837d2d7b1bb81272e9f"
      },
      {
        "name": "USDC...",
        "symbol": "USDC",
        "contractAddress": "0x01f2cc993b74d2406385444d8e9b4cb7f842a0a3",
        "decimals": "15",
        "genesisBlock": "17393891",
        "genesisTransaction": "0xc38d983d21999abe103b12d23e3afb47df1d81b2f8e5cbcca1c5ff1eabee43e1"
      },
      {
        "name": "USDC...",
        "symbol": "USDC",
        "contractAddress": "0x061b3a1af7ae27db0200f0ce445f6c7a3f2f8365",
        "decimals": "15",
        "genesisBlock": "17590182",
        "genesisTransaction": "0x1ac7dbc7cd863c664def489359e9b55cd2422080b07b2039fde451657778ba16"
      }
    ],
    "totalPages": 72,
    "pageNumber": 1,
    "totalItems": 1428
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free