Parameters

type

string

REQUIRED

Request type identifier specifying 'tokenDetails' as the info endpoint method to retrieve comprehensive token information and market metrics

tokenId

string

REQUIRED

The token's onchain ID in 34-character hexadecimal format (e.g., 0x6d1e7cde53ba9467b783cb7c530ce054)

Returns

name

string

Full token name as specified in the token contract (e.g., 'Hyperliquid', 'Purple', 'USD Coin'). Human-readable identifier for display in user interfaces.

maxSupply

string

Maximum supply of this token as defined by the contract. Returned as string to preserve precision for very large numbers.

totalSupply

string

Total token supply including all minted tokens across locked, unlocked, circulating, and reserved allocations. Returned as string to preserve precision for large quantities.

circulatingSupply

string

Circulating token supply representing tokens actively available in the market, excluding locked, vested, or reserved tokens. Returned as string for precision.

szDecimals

integer

Number of decimal places for order size precision. Determines the minimum order increment and display precision for quantity fields.

weiDecimals

integer

Number of decimal places for the token's smallest unit (wei) representation, matching the token's on-chain decimal configuration. Used for precise blockchain-level accounting.

midPx

string

Current mid-market price calculated as the average of best bid and best ask from the order book. Returned as string to maintain decimal precision.

markPx

string

Current mark price for the token used for valuation and display purposes. Returned as string to preserve decimal precision.

prevDayPx

string

Mark price exactly 24 hours ago. Compare with current markPx to calculate 24-hour price change. Returned as string for precision.

genesis

string | null

Genesis block or event associated with the token, if applicable. Can be null if not defined.

deployer

string | null

Address of the account or contract that deployed the token. Can be null if not defined.

deployGas

string | null

Amount of gas used to deploy the token contract. Can be null if not defined.

deployTime

string | null

Unix timestamp when the token contract was deployed. Can be null if not defined.

seededUsdc

string

Amount of USDC seeded or initially provided for this token, if applicable. Returned as string for precision.

nonCirculatingUserBalances

array

Array of user balances that are not considered circulating supply. Typically empty if none.

futureEmissions

string

Amount of tokens planned for future emissions. Returned as string for precision.

Request

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"tokenDetails","tokenId":"0x6d1e7cde53ba9467b783cb7c530ce054"}'
5

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"tokenDetails","tokenId":"0x6d1e7cde53ba9467b783cb7c530ce054"}'
5

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

4
var raw = JSON.stringify({
5
  "type": "tokenDetails",
6
  "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
7
});
8

9
var requestOptions = {
10
  method: 'POST',
11
  headers: myHeaders,
12
  body: raw,
13
  redirect: 'follow'
14
};
15

16
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

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

4
var raw = JSON.stringify({
5
  "type": "tokenDetails",
6
  "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
7
});
8

9
var requestOptions = {
10
  method: 'POST',
11
  headers: myHeaders,
12
  body: raw,
13
  redirect: 'follow'
14
};
15

16
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "type": "tokenDetails",
8
  "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
9
})
10
headers = {
11
  'Content-Type': 'application/json'
12
}
13

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

16
print(response.text)
17

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "type": "tokenDetails",
8
  "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
9
})
10
headers = {
11
  'Content-Type': 'application/json'
12
}
13

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

16
print(response.text)
17

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

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
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
  "type": "tokenDetails",
14
  "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
15
})
16

17
response = https.request(request)
18
puts response.read_body
19

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

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
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
  "type": "tokenDetails",
14
  "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
15
})
16

17
response = https.request(request)
18
puts response.read_body
19

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free