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

object

object

REQUIRED

A custom object with the following fields:

symbol

string

REQUIRED

The ERC-20 token symbol you'd like to get details for

page

integer

The page number you would like returned. Page numbers start at 1 and end at totalPages. If omitted, defaults to the first page (page 1). If the page number requested is higher than totalPages, an empty tokens array will be returned. If the page number requested is less than 1, an invalid params response will be returned

perPage

integer

The maximum amount of tokens to return on each page. You can request up to 100 items per page. If omitted, defaults to 40 items per page

Returns

pageNumber

integer

The page number of results that was returned with this response

totalPages

integer

The total number of results pages available

totalItems

integer

The total number of tokens matching the supplied symbol

tokens

array

An array of objects representing tokens matching the supplied symbol

name

string

The name of this token

symbol

string

The symbol of this token

contractAddress

string

The contract address of this token

decimals

string

The number of decimals this token utilizes

genesisBlock

string

The block number in which this contract was deployed

genesisTransaction

string

The hash of the transaction in which this contract was deployed

Request

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

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getTokenMetadataBySymbol',
4
    params: [{"symbol":"USDC"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getTokenMetadataBySymbol',
4
    params: [{"symbol":"USDC"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

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

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

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

22
print(response.text)

1
import requests
2
import json
3

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

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

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

22
print(response.text)

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

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

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

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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

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

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

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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