Address Metadata

The Address Metadata endpoint is now available in the API Pro Plus plan. You can subscribe to it at https://etherscan.io/apis.

📝Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

Get Address Tag for a Single Address

Returns a single address name tag and metadata.

https://api-metadata.etherscan.io/v1/api.ashx?
   module=nametag
   &action=getaddresstag
   &address=0xc36442b4a4522e871399cd717abdd847ab11fe88
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Parameter	Description
address	the string representing the address to check for its metadata.

Response

Query Response

Field	Description
address	the string representing the address to check for its metadata.
nametag	the Public Name Tag assigned to the address.
internal_nametag	the name tag representing the address for internal use.
url	the URL associated with the address.
shortdescription	the description of the label.
notes_1	the public note of the address on Etherscan.
notes_2	the public note of the address on Etherscan.
labels	the label name representing the 'category' for clustering addresses.
labels_slug	the URL slug for the label. can be used for Etherscan's Label Word Cloud.
Reputation	the reputation score of the address. (Reference)
other_attributes	other available attributes for this address. (Reference)
last updated timestamp	the Unix timestamp for the last updated time of the label.

Sample

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "address": "0xc36442b4a4522e871399cd717abdd847ab11fe88",
      "nametag": "Uniswap V3: Positions NFT",
      "internal_nametag": "",
      "url": "https://app.uniswap.org/#/pool",
      "shortdescription": "",
      "notes_1": "",
      "notes_2": "",
      "labels": [
        "DEX",
        "Token Contract",
        "NFT",
        "Uniswap"
      ],
      "labels_slug": [
        "dex",
        "token-contract",
        "nft",
        "uniswap"
      ],
      "reputation": 0,
      "other_attributes": [
        "TT:nft",
        "CN:NonfungiblePositionManager",
        "SC:sourcecodeverified"
      ],
      "lastupdatedtimestamp": 1629957579
    }
  ]
}

Sample with ENS

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "nametag": "",
      "internal_nametag": "",
      "url": "",
      "shortdescription": "",
      "notes_1": "",
      "notes_2": "",
      "labels": [
        "Gitcoin Grantee"
      ],
      "labels_slug": [
        "gitcoin-grantee"
      ],
      "reputation": 0,
      "other_attributes": [
        "ENS:vitalik.eth"
      ],
      "lastupdatedtimestamp": 1615897108
    }
  ]
}

Sample with Phishing Address

{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "address": "0x685e7db34eae3320fe1673b1507c12b6a6a19324",
            "nametag": "Fake_Phishing7288",
            "internal_nametag": "",
            "url": "",
            "shortdescription": "",
            "notes_1": "Warning! The phishing website asks users to transfer ETH to this address directly. Reported by BlockSec.",
            "notes_2": "",
            "labels": [
                "Phish / Hack"
            ],
            "labels_slug": [
                "phish-hack"
            ],
            "reputation": 2,
            "other_attributes": [],
            "lastupdatedtimestamp": 1671688956
        }
    ]
}

Get Address Tag for Multiple Addresses

Returns multiple addresses name tag and metadata.

​​ ​ This API endpoint returns a maximum of 100 addresses only.

https://api-metadata.etherscan.io/v1/api.ashx?
   module=nametag
   &action=getaddresstag
   &address=0xffc97d72e13e01096502cb8eb52dee56f74dad7b,0x9f26ae5cd245bfeeb5926d61497550f79d9c6c1c
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the strings representing the addresses to check for its metadata, separated by , . up to 100 addresses per call.

Response

Query Response

Field	Description
address	the string representing the address to check for its metadata.
nametag	the Public Name Tag assigned to the address.
internal_nametag	the name tag representing the address for internal use.
url	the URL associated with the address.
shortdescription	the description of the label.
notes_1	the public note of the address on Etherscan.
notes_2	the public note of the address on Etherscan.
labels	the label name representing the 'category' for clustering addresses.
labels_slug	the URL slug for the label. can be used for Etherscan's Label Word Cloud.
Reputation	the reputation score of the address. (Reference)
other_attributes	other available attributes for this address. (Reference)
last updated timestamp	the Unix timestamp for the last updated time of the label.

Sample Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "address": "0xffc97d72e13e01096502cb8eb52dee56f74dad7b",
      "nametag": "Aave: aAAVE Token V2",
      "internal_nametag": "",
      "url": "https://aave.com/atokens",
      "shortdescription": "Aave is an Open Source and Non-Custodial protocol to earn interest on deposits & borrow assets. It also features access to highly innovative flash loans, which let developers borrow instantly and easily; no collateral needed. With 16 different assets, 5 of which are stablecoins.",
      "notes_1": "",
      "notes_2": "",
      "labels": [
        "Token Contract",
        "DeFi",
        "Aave",
        "Aave V2"
      ],
      "labels_slug": [
        "token-contract",
        "defi",
        "aave",
        "aave-v2"
      ],
      "reputation": 0,
      "other_attributes": [
        "TT:erc-20",
        "CN:InitializableImmutableAdminUpgradeabilityProxy",
        "SC:sourcecodeverified"
      ],
      "lastupdatedtimestamp": 1608112373
    },
    {
      "address": "0x9f26ae5cd245bfeeb5926d61497550f79d9c6c1c",
      "nametag": "Akropolis Hacker 1",
      "internal_nametag": "",
      "url": "",
      "shortdescription": "",
      "notes_1": "Warning! There are reports that this address was used in Akropolis Hack. Please exercise caution when interacting with this address.",
      "notes_2": "",
      "labels": [
        "Phish / Hack",
        "Heist"
      ],
      "labels_slug": [
        "phish-hack",
        "heist"
      ],
      "reputation": 2,
      "other_attributes": [],
      "lastupdatedtimestamp": 1664251877
    }
  ]
}