Address Metadata

Last updated 1 year ago

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 🔗

Parameter

Description

address

the string representing the address to check for its metadata.

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

Reputation

other_attributes

last updated timestamp

the Unix timestamp for the last updated time of the label.

{
  "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
    }
  ]
}

{
  "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
    }
  ]
}

{
    "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

Query Parameters

Parameter

Description

address

the strings representing the addresses to check for its metadata, separated by , .

up to 100 addresses per call.

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

Reputation

other_attributes

last updated timestamp

the Unix timestamp for the last updated time of the label.

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
    }
  ]
}