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:

contract

string

REQUIRED

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

Returns

object

object

The custom response object, or null if no token details found:

name

string

The name of this token

symbol

string

The symbol for 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_getTokenMetadataByContractAddress",
6
  "params": [
7
    {
8
      "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
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_getTokenMetadataByContractAddress",
6
  "params": [
7
    {
8
      "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
9
    }
10
  ],
11
  "id": 1
12
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getTokenMetadataByContractAddress',
4
    params: [{"contract":"0x4d224452801ACEd8B2F0aebE155379bb5D594381"}],
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_getTokenMetadataByContractAddress',
4
    params: [{"contract":"0x4d224452801ACEd8B2F0aebE155379bb5D594381"}],
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_getTokenMetadataByContractAddress",
9
  "params": [
10
    {
11
      "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
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_getTokenMetadataByContractAddress",
9
  "params": [
10
    {
11
      "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
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_getTokenMetadataByContractAddress",
11
  params: [{"contract":"0x4d224452801ACEd8B2F0aebE155379bb5D594381"}]
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_getTokenMetadataByContractAddress",
11
  params: [{"contract":"0x4d224452801ACEd8B2F0aebE155379bb5D594381"}]
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
    "name": "ApeCoin",
6
    "symbol": "APE",
7
    "contractAddress": "0x4d224452801aced8b2f0aebe155379bb5d594381",
8
    "decimals": "18",
9
    "genesisBlock": "14204533",
10
    "genesisTransaction": "0x2761f74e2f45d981a9d7553cbbcfbcc862cae416eb37a820300d4c19516d6fca"
11
  }
12
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "name": "ApeCoin",
6
    "symbol": "APE",
7
    "contractAddress": "0x4d224452801aced8b2f0aebe155379bb5d594381",
8
    "decimals": "18",
9
    "genesisBlock": "14204533",
10
    "genesisTransaction": "0x2761f74e2f45d981a9d7553cbbcfbcc862cae416eb37a820300d4c19516d6fca"
11
  }
12
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free