> For the complete documentation index, see [llms.txt](https://wardanalytics.gitbook.io/ward-analytics-spellbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wardanalytics.gitbook.io/ward-analytics-spellbook/backend-integrations/address-tagging.md).

# Address Tagging

Group your platform's addresses into tags

## Address Tagging Introduction

You can assign a tag to an address and use the tag for multiple use cases, including:

* **Filtering by tag** in your web app's risk feed
* **Assigning rules** to a specific tag
* **Comparing behaviours** of individual addresses to others with their tag

## :magic\_wand: Spell Index

Inspect the function name to learn more about how to use each spell!

{% hint style="info" %}

* Tag names are **not case-sensitive**
* Addresses can only have **one tag**
  {% endhint %}

## Tag addresses

<mark style="color:green;">`POST`</mark> `/tags/tag`

Tags a group of addresses with a specific tag

#### Headers

| Name                                  | Type   | Description  |
| ------------------------------------- | ------ | ------------ |
| api<mark style="color:red;">\*</mark> | String | Your API key |

#### Request Body

| Name                                        | Type          | Description                |
| ------------------------------------------- | ------------- | -------------------------- |
| tag<mark style="color:red;">\*</mark>       | String        | The name of the user       |
| addresses<mark style="color:red;">\*</mark> | List\[String] | Address hashes of the user |

{% tabs %}
{% tab title="200: OK Wizardry!" %}
{% code title="Example Python Input" lineNumbers="true" %}

```python
requests.post("https://wardanalyticsapi.com/tags/tag",
	headers = {
		"api": "YOUR_API_KEY"
	},
	json = {
		"addresses": [0xAe45a8240147E6179ec7c9f92c5A18F9a97B3fCA],
		"tag": "Deposit Address"
            })
```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request Poorly Cast Spell" %}

{% endtab %}

{% tab title="401: Unauthorized Forbidden Magic" %}

{% endtab %}

{% tab title="429: Too Many Requests Mana Overflow" %}

{% endtab %}
{% endtabs %}

## Untag addresses

<mark style="color:red;">`DELETE`</mark> `/tags/tag`

Untags a group of addresses

#### Headers

| Name                                  | Type   | Description  |
| ------------------------------------- | ------ | ------------ |
| api<mark style="color:red;">\*</mark> | String | Your API key |

#### Request Body

| Name                                        | Type          | Description                |
| ------------------------------------------- | ------------- | -------------------------- |
| addresses<mark style="color:red;">\*</mark> | List\[String] | Address hashes of the user |

{% tabs %}
{% tab title="200: OK Wizardry!" %}
{% code title="Example Python Input" lineNumbers="true" %}

```python
requests.delete("https://wardanalyticsapi.com/tags/tag",
	headers = {
		"api": "YOUR_API_KEY"
	},
	json = {
		"addresses": [0xAe45a8240147E6179ec7c9f92c5A18F9a97B3fCA],
            })
```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request Poorly Cast Spell" %}

{% endtab %}

{% tab title="401: Unauthorized Forbidden Magic" %}

{% endtab %}

{% tab title="429: Too Many Requests Mana Overflow" %}

{% endtab %}
{% endtabs %}