# Tagging Meta Data

Coin Metrics Tagging Data is a powerful tool that provides users with a unique lens on blockchain data. It allows you to access blockchain addresses labeled with their real-world entity names or functions. By associating blockchain-level accounts/addresses with meaningful labels, you can gain a deeper understanding of the cryptocurrency world. The applications for this data can better explain activity around hot spots like smart contracts, exchanges, miners and many more.

## [Tag Catalog](https://docs.coinmetrics.io/api/v4/#tag/Blockchain-Metadata/operation/getBlockchainMetadataTags)

For accessing our Dictionary of tags you can leverage our Tag Catalog API Call. This returns a list of the tag options that can then be used ti query in the `tags` parameter of our `/tagged-entities` response. For detailed definitions or methodologies relating to specific tags. Please reach out to our team. \\

Example: `api.coinmetrics.io/v4/blockchain-metadata/tags?&api_key={api_key}`

## [Entity and Tag Search](https://docs.coinmetrics.io/api/v4/#tag/Blockchain-Metadata/operation/getBlockchainMetadataEntities)

When utilizing the Tagging Data there are two query methods. The first is by searching for an Entity. Entities are addresses, accounts or contracts.

Example: `api.coinmetrics.io/v4/blockchain-metadata/tagged-entities?entities={entity_list}&pretty=true&api_key={api_key}`

The second query method is for retrieving all entities defined under a defined tag. In the first release you are able to query for a single address.

Example: `api.coinmetrics.io/v4/blockchain-metadata/tagged-entities?tags={tag_list}&pretty=true&api_key={api_key}`

### Example Result

```
// Result of Entity Search for Address "000000000006ec9792c0a516cbeb3b791e862949"
{
"data" : [ {
    "entity" : "000000000006ec9792c0a516cbeb3b791e862949",
    "tag" : "ADDRESS_IS_CONTRACT",
    "location" : "eth",
    "type" : "ADDRESS",
    "tagger_type" : "COINMETRICS",
    "tagger_method" : "DETERMINISTIC",
    "start_time" : "2021-01-26T22:14:08.000000000Z",
    "start_block_height" : "11734034",
    "start_block_hash" : "81c9410e149bfab4877faf08b01c3f1656d24bada66b1337f4802cc5304947af"
  }, {
    "entity" : "000000000006ec9792c0a516cbeb3b791e862949",
    "tag" : "ADDRESS_IS_SWAPPER",
    "location" : "uni_v2_eth",
    "type" : "ADDRESS",
    "tagger_type" : "COINMETRICS",
    "tagger_method" : "DETERMINISTIC",
    "start_time" : "2021-01-27T02:46:17.000000000Z",
    "start_block_height" : "11735233",
    "start_block_hash" : "10a39f4cdf992bfed5c62296804bf65a6e5f1eb18b32626235133a2cbab57959"
    }...
```

## Tagging Dictionary

For Descriptions on our tagging defintions and sourcing information please see the document below.

{% file src="/files/XnYvc0fKKIBDXNegv4La" %}

## Coin Metrics OPEN Values

It's essential to emphasize that the Coin Metrics Tagging Data operates in accordance with our Coin Metrics OPEN Values. The information provided by the API is gathered in a neutral and unbiased manner hoping to elucidate further understanding of blockchain activity and data.

## Release History

* **Beta Release on November 14, 2023**: Release of initial tagging data set and API


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook-docs.coinmetrics.io/network-data/tagging-meta-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.