Nametags

This feature is available exclusively through the Pro Plus plan

Get An Address's Nametag

Returns an address's nametag such as "Coinbase 10", as well as associated labels such as "exchange".

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

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=nametag
   &action=getaddresstag
   &address=0xA9D1e08C7793af67e9d92fe308d5697FB81d3E43
   &apikey=YourApiKeyToken

Try this in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the address to check for name tag and labels
chainid	the chain to query labels on, addresses may not be the same across chains

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "address":"0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43",
         "nametag":"Coinbase 10",
         "internal_nametag":"",
         "url":"https://coinbase.com",
         "shortdescription":"",
         "notes_1":"",
         "notes_2":"",
         "labels":[
            "Exchange",
            "Coinbase"
         ],
         "labels_slug":[
            "exchange",
            "coinbase"
         ],
         "reputation":0,
         "other_attributes":[
            
         ],
         "lastupdatedtimestamp":1674628276
      }
   ]
}

Metadata CSV

For enterprise usage of nametags, CSV exports of label categories such as "phish" or "ofac". Reach out for a demo.

This feature is available exclusively through the Pro Plus with CSV add on,

Export CSV for a Specific Label

Returns addresses filtered by a specific label in CSV format.

https://api-metadata.etherscan.io/v1/api.ashx?
   module=nametag
   &action=exportaddresstags
   &label=nft
   &format=csv
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

label	the label name representing the 'category' for clustering addresses.

Response

Sample CSV File

Get Label Masterlist

Returns the categories of labels available.

https://api-metadata.etherscan.io/v1/api.ashx?
   module=nametag
   &action=getlabelmasterlist
   &apikey=YourAPIKeyToken

Try this endpoint in your browser 🔗

Request

Query Response

labelname	the label name representing the 'category' for clustering addresses.
labelslug	the URL slug for the label. can be used for Etherscan's Label Word Cloud.​
shortdescription	the description of the label.
last updated timestamp	the Unix timestamp for the last updated time of the label.
notes	private note for the label.

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "labelname": "0-Gas Sender",
      "labelslug": "0-gas-sender",
      "shortdescription": "Addresses that sent transactions with 0 gas prices.",
      "notes": "",
      "lastupdatedtimestamp": 1673930922
    },
    {
      "labelname": "0x Protocol",
      "labelslug": "0x-protocol",
      "shortdescription": "0x Protocol is an open protocol that enables the peer-to-peer exchange of assets on the Ethereum blockchain.",
      "notes": "",
      "lastupdatedtimestamp": 1670574376
    }
  ]
}