Metadata CSV

The Metadata CSV is an Enterprise solution designed for projects looking to enhance their applications with curated name tags, labels, and additional information. Please contact us if you are interested to learn more.

*The Metadata CSV endpoints are not included in the API Pro Plus plan

This endpoint is throttled to 2 calls/second & 100 calls/day regardless of API Pro tier.

Get Label Masterlist

Returns the masterlist of available label groupings.

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

Try this endpoint in your browser 🔗

Response

Query Response

Field	Description
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.

Sample

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

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

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

Sample Response

Sample CSV File

Export CSV for OFAC Sanctioned Related Labels

Retuns addresses sanctioned by the U.S. Department of the Treasury's Office of Foreign Assets Control's Specially Designated Nationals list.

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

Try this endpoint in your browser🔗

Response

Sample CSV File

Export All Addresses with Tags and Labels

Exports a complete csv list of ALL address name tags and/or labels

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

Try this endpoint in your browser 🔗

Response

Sample CSV File

Get Latest CSV Batch Number

Get the latest running number for CSV Export.

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

Try this endpoint in your browser 🔗

Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "nametag": "nametag",
      "batch": "9715",
      "lastUpdatedTimestamp": 1686535680
    },
    {
      "nametag": "Ens nametag",
      "batch": "9593",
      "lastUpdatedTimestamp": 1686546540
    }
  ]
}