Skip to main content
GET
/
tokens
/
{address_hash}
Get token details
curl --request GET \
  --url 'https://api.blockscout.com/{chain_id}/api/v2/tokens/{address_hash}?apikey='
{
  "address": "0x1234567890123456789012345678901234567890",
  "type": "ERC-20",
  "name": "<string>",
  "symbol": "<string>",
  "decimals": "<string>",
  "total_supply": "1000000000000000000",
  "exchange_rate": "<string>",
  "holders": "<string>",
  "icon_url": "<string>"
}

Authorizations

​
apikey
string
query
required

API key passed as query parameter (format proapi_xxxxxxxx)

Path Parameters

​
address_hash
string
required

Token contract address Address hash with 0x prefix

Example:

"0x1234567890123456789012345678901234567890"

Query Parameters

​
apikey
string

API key for rate limiting or for sensitive endpoints

Example:

"proapi_xxxxxxxx"

​
key
string

Secret key for getting access to restricted resources

Response

Token details retrieved successfully

Token details

​
address
string
required

Address hash with 0x prefix

Example:

"0x1234567890123456789012345678901234567890"

​
type
enum<string>
required

Token standard type:

  • ERC-20 - Fungible tokens
  • ERC-721 - Non-fungible tokens (NFTs)
  • ERC-1155 - Multi-token standard
  • ERC-404 - Hybrid fungible/non-fungible tokens
Available options:
ERC-20,
ERC-721,
ERC-1155,
ERC-404
​
name
string | null

Token name

​
symbol
string | null

Token symbol

​
decimals
string | null

Number of decimal places

​
total_supply
string | null

Nullable integer value as string

Example:

"1000000000000000000"

​
exchange_rate
string | null

Exchange rate to USD

​
holders
string | null

Number of token holders

​
icon_url
string | null

URL to token icon