qn_getTokenMetadataByContractAddress (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...

contract

string

Loading...

Returns

object

Loading...

name

Loading...

symbol

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_getTokenMetadataByContractAddress",
    "params": [{
      "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
    }]
  }'

 require 'eth'

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

 payload = {
     "id":67,
     "jsonrpc":"2.0",
     "method":"qn_getTokenMetadataByContractAddress",
     "params": [{
       "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
     }]
  }

 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_getTokenMetadataByContractAddress", [
    {
      contract: "0x4d224452801ACEd8B2F0aebE155379bb5D594381",
    },
  ]);
  console.log(heads);
})();

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

var raw = JSON.stringify({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getTokenMetadataByContractAddress",
  "params": [{
    "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
  }]
});

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_getTokenMetadataByContractAddress",
  "params": [{
    "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
  }]
})
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_getTokenMetadataByContractAddress",
  "params": [{
    "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
  }]
})

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_getTokenMetadataByContractAddress', [{
  "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
}])
print(resp)

import { Core } from '@quicknode/sdk'

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

core.client
	.qn_getTokenMetadataByContractAddress({
		contract: '0x4d224452801ACEd8B2F0aebE155379bb5D594381',
	})
	.then(nfts => console.log(nfts))

Response

{
  "jsonrpc": "2.0",
  "id": 67,
  "result": {
    "name": "ApeCoin",
    "symbol": "APE",
    "contractAddress": "0x4d224452801aced8b2f0aebe155379bb5d594381",
    "decimals": "18",
    "genesisBlock": "14204533",
    "genesisTransaction": "0x2761f74e2f45d981a9d7553cbbcfbcc862cae416eb37a820300d4c19516d6fca"
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free