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

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "id":67,
6
    "jsonrpc":"2.0",
7
    "method":"qn_getTokenMetadataBySymbol",
8
    "params": [{
9
      "symbol": "USDC"
10
    }]
11
  }'
12

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "id":67,
6
    "jsonrpc":"2.0",
7
    "method":"qn_getTokenMetadataBySymbol",
8
    "params": [{
9
      "symbol": "USDC"
10
    }]
11
  }'
12

1
 require 'eth'
2

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

5
 payload = {
6
     "id":67,
7
     "jsonrpc":"2.0",
8
     "method":"qn_getTokenMetadataBySymbol",
9
     "params": [{
10
       "symbol": "USDC"
11
     }]
12
  }
13

14
 response = client.send(payload.to_json)
15
 puts response
16

1
 require 'eth'
2

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

5
 payload = {
6
     "id":67,
7
     "jsonrpc":"2.0",
8
     "method":"qn_getTokenMetadataBySymbol",
9
     "params": [{
10
       "symbol": "USDC"
11
     }]
12
  }
13

14
 response = client.send(payload.to_json)
15
 puts response
16

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
4
  const heads = await provider.send("qn_getTokenMetadataBySymbol", [
5
    {
6
      symbol: "USDC",
7
    },
8
  ]);
9
  console.log(heads);
10
})();
11

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
4
  const heads = await provider.send("qn_getTokenMetadataBySymbol", [
5
    {
6
      symbol: "USDC",
7
    },
8
  ]);
9
  console.log(heads);
10
})();
11

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

4
var raw = JSON.stringify({
5
  "id": 67,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getTokenMetadataBySymbol",
8
  "params": [{
9
    "symbol": "USDC"
10
  }]
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

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

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

4
var raw = JSON.stringify({
5
  "id": 67,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getTokenMetadataBySymbol",
8
  "params": [{
9
    "symbol": "USDC"
10
  }]
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

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

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 67,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getTokenMetadataBySymbol",
10
  "params": [{
11
    "symbol": "USDC"
12
  }]
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

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

20
print(response.text)
21

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 67,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getTokenMetadataBySymbol",
10
  "params": [{
11
    "symbol": "USDC"
12
  }]
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

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

20
print(response.text)
21

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "id": 67,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getTokenMetadataBySymbol",
16
  "params": [{
17
    "symbol": "USDC"
18
  }]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "id": 67,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getTokenMetadataBySymbol",
16
  "params": [{
17
    "symbol": "USDC"
18
  }]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

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

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

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.quiknode.pro/",
5
  config: {
6
    addOns: {
7
      nftTokenV2: true,
8
    },
9
  },
10
})
11

12
core.client
13
    .qn_getTokenMetadataBySymbol(
14
      { symbol: "WETH", perPage: 2 }
15
    )
16
    .then(res => console.log(res))
17

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.quiknode.pro/",
5
  config: {
6
    addOns: {
7
      nftTokenV2: true,
8
    },
9
  },
10
})
11

12
core.client
13
    .qn_getTokenMetadataBySymbol(
14
      { symbol: "WETH", perPage: 2 }
15
    )
16
    .then(res => console.log(res))
17

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "tokens": [
6
      {
7
        "name": "RUSDC",
8
        "symbol": "USDC",
9
        "contractAddress": "0x732ed72509c3ac9ed1af61510c43dc454e6db75c",
10
        "decimals": "6",
11
        "genesisBlock": "19680970",
12
        "genesisTransaction": "0x8506f1216c008f1478a5fa984944a227a44bcd829d526bd2acf9dff49fc9789a"
13
      },
14
      {
15
        "name": "USD Coin (PoS)",
16
        "symbol": "USDC",
17
        "contractAddress": "0x566957ef80f9fd5526cd2bef8be67035c0b81130",
18
        "decimals": "6",
19
        "genesisBlock": null,
20
        "genesisTransaction": null
21
      },
22
      {
23
        "name": "USD Coin (Arb1)",
24
        "symbol": "USDC",
25
        "contractAddress": "0x5c14172d3876200ad4063a33aee47a281020d4b3",
26
        "decimals": "6",
27
        "genesisBlock": null,
28
        "genesisTransaction": null
29
      },
30
      {
31
        "name": "USD Coin",
32
        "symbol": "USDC",
33
        "contractAddress": "0x969c5e0cd6658e1c4a273120481d8817b509a9ae",
34
        "decimals": "6",
35
        "genesisBlock": "17933593",
36
        "genesisTransaction": "0xf84c194d02d1828ce6fc8d2552d9454739d37101af502890eb525eb8807918ef"
37
      },
38
      {
39
        "name": "USD Coin",
40
        "symbol": "USDC",
41
        "contractAddress": "0x7b90b3eaa113fa733869bfa401b86e04cea7eb48",
42
        "decimals": "6",
43
        "genesisBlock": "17273354",
44
        "genesisTransaction": "0x4e50728790047ad5ef6d70080a7a74d5659a9f4b84ea08456cdbf077ffc760c3"
45
      },
46
      {
47
        "name": "USD CRYPTO",
48
        "symbol": "USDC",
49
        "contractAddress": "0x7dd41ab7298181581a05d7c46a199f6ba77aac96",
50
        "decimals": "6",
51
        "genesisBlock": "7041374",
52
        "genesisTransaction": "0x7a0a5ab7740f26b5354fe6d0ea933a4e4393103edaf15fb5d0db11e0e139b95f"
53
      },
54
      {
55
        "name": "USD CLASSIC",
56
        "symbol": "USDC",
57
        "contractAddress": "0xc93a59888e7e6f2849ba94acf767266299c4c415",
58
        "decimals": "8",
59
        "genesisBlock": "6886723",
60
        "genesisTransaction": "0x3889aa64997d15841a6ef309469afa0e871a72aed5599db290946fa505cf11b2"
61
      },
62
      {
63
        "name": null,
64
        "symbol": null,
65
        "contractAddress": "0x59ef697894da6f943ce8d534b98f89cdbfbc763d",
66
        "decimals": null,
67
        "genesisBlock": "7141781",
68
        "genesisTransaction": "0xeb2f3c01438c2c357e7b3815829b016d66d4b58a004e0ce1ea9915772d12c230"
69
      },
70
      {
71
        "name": "Usdcoins",
72
        "symbol": "USDC",
73
        "contractAddress": "0x1f8abd8e5fb90c7c4076fca58fe335ba55da5945",
74
        "decimals": "18",
75
        "genesisBlock": "5367027",
76
        "genesisTransaction": "0xdd28b5b301413560b6710fa4d41daa7c39c5ad87dc2d824fb56863b83bdd0758"
77
      },
78
      {
79
        "name": "USDC",
80
        "symbol": "USDC",
81
        "contractAddress": "0xb9e31a22e3a1c743c6720f3b723923e91f3c0f8b",
82
        "decimals": "18",
83
        "genesisBlock": "5690329",
84
        "genesisTransaction": "0xd63128b64436182847e7d36ece3f1fb13d5b14ef5dc9f77563be3f674552097c"
85
      },
86
      {
87
        "name": "USD Coin ",
88
        "symbol": "USDC",
89
        "contractAddress": "0x763ea572940b6c30b83aa2c52b62981b63f51748",
90
        "decimals": "4",
91
        "genesisBlock": "6188338",
92
        "genesisTransaction": "0x9841631d695af74454f79e366a02511c9f331f8bcc40c2a7744fa8b325a79b24"
93
      },
94
      {
95
        "name": "USD Coin (USDC)",
96
        "symbol": "USDC",
97
        "contractAddress": "0x008b01bd2fe6cebe1990abde4584c8d98584683f",
98
        "decimals": "6",
99
        "genesisBlock": "17407225",
100
        "genesisTransaction": "0x11511b77b3d3b3be69e1ff9bcb316bfd9a3183ef44578151e23b966485c4e8cb"
101
      },
102
      {
103
        "name": "USDC",
104
        "symbol": "USDC",
105
        "contractAddress": "0xf53f5ca534d30674aa1fa5b1b221c6bf777ffc5c",
106
        "decimals": "6",
107
        "genesisBlock": "18963017",
108
        "genesisTransaction": "0x18537fcd9b6716a736d8455f8e2d3604839c88d11aeb88c5c672ef4c35a4918b"
109
      },
110
      {
111
        "name": "USD Coin (USDC)",
112
        "symbol": "USDC",
113
        "contractAddress": "0x03d2bad5ed52975fa68337d65cace7e2045a4b8f",
114
        "decimals": "15",
115
        "genesisBlock": "17559027",
116
        "genesisTransaction": "0x74e7be031b29897e1bb93e7832a9d0845f1fcd301ab0a4ab8d071a5b23bdb897"
117
      },
118
      {
119
        "name": "USD...C",
120
        "symbol": "USDC",
121
        "contractAddress": "0x04b4c8bac137789ee37a4788026e5fa5094ddd86",
122
        "decimals": "15",
123
        "genesisBlock": "17591068",
124
        "genesisTransaction": "0x286e07b299c931d940c14f43e1e874bc7ded110170aa1c1c40728ffec2abd6a7"
125
      },
126
      {
127
        "name": "USDCoin",
128
        "symbol": "USDC",
129
        "contractAddress": "0x00df26b7412981f31eb043350e939ec0751bd786",
130
        "decimals": "15",
131
        "genesisBlock": "17521370",
132
        "genesisTransaction": "0x8619f976692ac229b525b9639d1e1942bde6fbd94a3558741dfa92277e469994"
133
      },
134
      {
135
        "name": "USD Coin",
136
        "symbol": "USDC",
137
        "contractAddress": "0x0634fb92ebf80d27e8bf167f3babf2590d9e2fab",
138
        "decimals": "6",
139
        "genesisBlock": "18032272",
140
        "genesisTransaction": "0x598afcbfd544406d038e6885a8b405d311733b4bcb8fa820b20f799281f66d4c"
141
      },
142
      {
143
        "name": "USDC",
144
        "symbol": "USDC",
145
        "contractAddress": "0x81559f30086badc59b8403e5256f8ea8c5522f40",
146
        "decimals": "6",
147
        "genesisBlock": "19918390",
148
        "genesisTransaction": "0x9bfbe92444acd84ee9b4452e6c40ff0fd84fb5fba8c03837d2d7b1bb81272e9f"
149
      },
150
      {
151
        "name": "USDC...",
152
        "symbol": "USDC",
153
        "contractAddress": "0x01f2cc993b74d2406385444d8e9b4cb7f842a0a3",
154
        "decimals": "15",
155
        "genesisBlock": "17393891",
156
        "genesisTransaction": "0xc38d983d21999abe103b12d23e3afb47df1d81b2f8e5cbcca1c5ff1eabee43e1"
157
      },
158
      {
159
        "name": "USDC...",
160
        "symbol": "USDC",
161
        "contractAddress": "0x061b3a1af7ae27db0200f0ce445f6c7a3f2f8365",
162
        "decimals": "15",
163
        "genesisBlock": "17590182",
164
        "genesisTransaction": "0x1ac7dbc7cd863c664def489359e9b55cd2422080b07b2039fde451657778ba16"
165
      }
166
    ],
167
    "totalPages": 72,
168
    "pageNumber": 1,
169
    "totalItems": 1428
170
  }
171
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "tokens": [
6
      {
7
        "name": "RUSDC",
8
        "symbol": "USDC",
9
        "contractAddress": "0x732ed72509c3ac9ed1af61510c43dc454e6db75c",
10
        "decimals": "6",
11
        "genesisBlock": "19680970",
12
        "genesisTransaction": "0x8506f1216c008f1478a5fa984944a227a44bcd829d526bd2acf9dff49fc9789a"
13
      },
14
      {
15
        "name": "USD Coin (PoS)",
16
        "symbol": "USDC",
17
        "contractAddress": "0x566957ef80f9fd5526cd2bef8be67035c0b81130",
18
        "decimals": "6",
19
        "genesisBlock": null,
20
        "genesisTransaction": null
21
      },
22
      {
23
        "name": "USD Coin (Arb1)",
24
        "symbol": "USDC",
25
        "contractAddress": "0x5c14172d3876200ad4063a33aee47a281020d4b3",
26
        "decimals": "6",
27
        "genesisBlock": null,
28
        "genesisTransaction": null
29
      },
30
      {
31
        "name": "USD Coin",
32
        "symbol": "USDC",
33
        "contractAddress": "0x969c5e0cd6658e1c4a273120481d8817b509a9ae",
34
        "decimals": "6",
35
        "genesisBlock": "17933593",
36
        "genesisTransaction": "0xf84c194d02d1828ce6fc8d2552d9454739d37101af502890eb525eb8807918ef"
37
      },
38
      {
39
        "name": "USD Coin",
40
        "symbol": "USDC",
41
        "contractAddress": "0x7b90b3eaa113fa733869bfa401b86e04cea7eb48",
42
        "decimals": "6",
43
        "genesisBlock": "17273354",
44
        "genesisTransaction": "0x4e50728790047ad5ef6d70080a7a74d5659a9f4b84ea08456cdbf077ffc760c3"
45
      },
46
      {
47
        "name": "USD CRYPTO",
48
        "symbol": "USDC",
49
        "contractAddress": "0x7dd41ab7298181581a05d7c46a199f6ba77aac96",
50
        "decimals": "6",
51
        "genesisBlock": "7041374",
52
        "genesisTransaction": "0x7a0a5ab7740f26b5354fe6d0ea933a4e4393103edaf15fb5d0db11e0e139b95f"
53
      },
54
      {
55
        "name": "USD CLASSIC",
56
        "symbol": "USDC",
57
        "contractAddress": "0xc93a59888e7e6f2849ba94acf767266299c4c415",
58
        "decimals": "8",
59
        "genesisBlock": "6886723",
60
        "genesisTransaction": "0x3889aa64997d15841a6ef309469afa0e871a72aed5599db290946fa505cf11b2"
61
      },
62
      {
63
        "name": null,
64
        "symbol": null,
65
        "contractAddress": "0x59ef697894da6f943ce8d534b98f89cdbfbc763d",
66
        "decimals": null,
67
        "genesisBlock": "7141781",
68
        "genesisTransaction": "0xeb2f3c01438c2c357e7b3815829b016d66d4b58a004e0ce1ea9915772d12c230"
69
      },
70
      {
71
        "name": "Usdcoins",
72
        "symbol": "USDC",
73
        "contractAddress": "0x1f8abd8e5fb90c7c4076fca58fe335ba55da5945",
74
        "decimals": "18",
75
        "genesisBlock": "5367027",
76
        "genesisTransaction": "0xdd28b5b301413560b6710fa4d41daa7c39c5ad87dc2d824fb56863b83bdd0758"
77
      },
78
      {
79
        "name": "USDC",
80
        "symbol": "USDC",
81
        "contractAddress": "0xb9e31a22e3a1c743c6720f3b723923e91f3c0f8b",
82
        "decimals": "18",
83
        "genesisBlock": "5690329",
84
        "genesisTransaction": "0xd63128b64436182847e7d36ece3f1fb13d5b14ef5dc9f77563be3f674552097c"
85
      },
86
      {
87
        "name": "USD Coin ",
88
        "symbol": "USDC",
89
        "contractAddress": "0x763ea572940b6c30b83aa2c52b62981b63f51748",
90
        "decimals": "4",
91
        "genesisBlock": "6188338",
92
        "genesisTransaction": "0x9841631d695af74454f79e366a02511c9f331f8bcc40c2a7744fa8b325a79b24"
93
      },
94
      {
95
        "name": "USD Coin (USDC)",
96
        "symbol": "USDC",
97
        "contractAddress": "0x008b01bd2fe6cebe1990abde4584c8d98584683f",
98
        "decimals": "6",
99
        "genesisBlock": "17407225",
100
        "genesisTransaction": "0x11511b77b3d3b3be69e1ff9bcb316bfd9a3183ef44578151e23b966485c4e8cb"
101
      },
102
      {
103
        "name": "USDC",
104
        "symbol": "USDC",
105
        "contractAddress": "0xf53f5ca534d30674aa1fa5b1b221c6bf777ffc5c",
106
        "decimals": "6",
107
        "genesisBlock": "18963017",
108
        "genesisTransaction": "0x18537fcd9b6716a736d8455f8e2d3604839c88d11aeb88c5c672ef4c35a4918b"
109
      },
110
      {
111
        "name": "USD Coin (USDC)",
112
        "symbol": "USDC",
113
        "contractAddress": "0x03d2bad5ed52975fa68337d65cace7e2045a4b8f",
114
        "decimals": "15",
115
        "genesisBlock": "17559027",
116
        "genesisTransaction": "0x74e7be031b29897e1bb93e7832a9d0845f1fcd301ab0a4ab8d071a5b23bdb897"
117
      },
118
      {
119
        "name": "USD...C",
120
        "symbol": "USDC",
121
        "contractAddress": "0x04b4c8bac137789ee37a4788026e5fa5094ddd86",
122
        "decimals": "15",
123
        "genesisBlock": "17591068",
124
        "genesisTransaction": "0x286e07b299c931d940c14f43e1e874bc7ded110170aa1c1c40728ffec2abd6a7"
125
      },
126
      {
127
        "name": "USDCoin",
128
        "symbol": "USDC",
129
        "contractAddress": "0x00df26b7412981f31eb043350e939ec0751bd786",
130
        "decimals": "15",
131
        "genesisBlock": "17521370",
132
        "genesisTransaction": "0x8619f976692ac229b525b9639d1e1942bde6fbd94a3558741dfa92277e469994"
133
      },
134
      {
135
        "name": "USD Coin",
136
        "symbol": "USDC",
137
        "contractAddress": "0x0634fb92ebf80d27e8bf167f3babf2590d9e2fab",
138
        "decimals": "6",
139
        "genesisBlock": "18032272",
140
        "genesisTransaction": "0x598afcbfd544406d038e6885a8b405d311733b4bcb8fa820b20f799281f66d4c"
141
      },
142
      {
143
        "name": "USDC",
144
        "symbol": "USDC",
145
        "contractAddress": "0x81559f30086badc59b8403e5256f8ea8c5522f40",
146
        "decimals": "6",
147
        "genesisBlock": "19918390",
148
        "genesisTransaction": "0x9bfbe92444acd84ee9b4452e6c40ff0fd84fb5fba8c03837d2d7b1bb81272e9f"
149
      },
150
      {
151
        "name": "USDC...",
152
        "symbol": "USDC",
153
        "contractAddress": "0x01f2cc993b74d2406385444d8e9b4cb7f842a0a3",
154
        "decimals": "15",
155
        "genesisBlock": "17393891",
156
        "genesisTransaction": "0xc38d983d21999abe103b12d23e3afb47df1d81b2f8e5cbcca1c5ff1eabee43e1"
157
      },
158
      {
159
        "name": "USDC...",
160
        "symbol": "USDC",
161
        "contractAddress": "0x061b3a1af7ae27db0200f0ce445f6c7a3f2f8365",
162
        "decimals": "15",
163
        "genesisBlock": "17590182",
164
        "genesisTransaction": "0x1ac7dbc7cd863c664def489359e9b55cd2422080b07b2039fde451657778ba16"
165
      }
166
    ],
167
    "totalPages": 72,
168
    "pageNumber": 1,
169
    "totalItems": 1428
170
  }
171
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free