# API меток адресов

API адресных меток позволяет пользователям извлекать адресные метки и всесторонне понимать адрес с разных точек зрения. [В настоящее время оно поддерживает более 25](#supported-networks) различных блокчейнов, включая Solana, Bitcoin, Tron, Ethereum, BSC и другие цепи, совместимые с EVM.

## Адресная метка

При использовании нашего API для поиска адреса **мы вернем три типа меток для описания адреса**.

### Сущность

Мы используем ***Сущность*** для описания владельца или контроллера адреса. Если это EoA-адрес, это значит сущность, контролирующая этот EoA-адрес (с личным ключом). Для смарт-контракта сущность может относиться к их развертывателям (проекты).

**Адрес может иметь более одной сущности.**

> Назначение сущности адреса необходимо главным образом для установления связи между адресом криптовалюты и известной организацией или личностью. Однако существуют случаи, когда адрес может быть связан с несколькими сущностями. В таких случаях мы присваиваем **Основную сущность и дополнительные сущности.**
>
> Например, рассмотреть депозитный адрес Alameda на Binance. Мы можем заявить, что Binance контролирует личный ключ этого адреса или что Alameda использует его. В таких ситуациях **мы обозначаем Binance как основную сущность для этого адреса, в то время как Alameda считаем второстепенной или дополнительной сущностью**.

#### Категория Сущности

Большинство сущностей — это организации или сервисы, тогда как лишь немногие представляют индивидуальных лиц. Большинство сущностей классифицируются на следующие категории, которые могут помочь вам понять их природу.

<table><thead><tr><th width="172">Категория</th><th width="92">Код</th><th>Описание</th></tr></thead><tbody><tr><td>УПРАВЛЕНИЕ АКТИВАМИ</td><td>3001</td><td>Финансовые институты, специализирующиеся на управлении и инвестировании активов от имени клиентов.</td></tr><tr><td>МОСТ</td><td>3002</td><td>Протоколы, облегчающие движение активов и данных между различными блокчейнами.</td></tr><tr><td>МАТЕРИАЛЫ О ЖЕСТОКОМ ОБРАЩЕНИИ С ДЕТЬМИ</td><td>3003</td><td>Форумы и веб-сайты, способствующие покупке, продаже и распространению материалов о жестоком обращении с детьми.</td></tr><tr><td>ОБЛАЧНЫЙ МАЙНИНГ</td><td>3004</td><td>Сервисы, позволяющие людям арендовать вычислительную мощность от удаленных дата-центров для майнинга криптовалюты без управления физическим оборудованием.</td></tr><tr><td>DAPP</td><td>3005</td><td>Децентрализованное приложение (dApp) — это приложение, разработанное на децентрализованной сети, интегрирующее смарт-контракт и пользовательский интерфейс. Когда dApp не подходит под конкретные категории, такие как DeFi, он относится к этой общей категории. Однако в будущем он может быть категоризован под новыми категориями.</td></tr><tr><td>ТЕМНЫЙ РЫНОК</td><td>3006</td><td>Нелегальные веб-сайты в даркнете, способствующие покупке и продаже незаконных товаров и услуг, включая наркотики, оружие, фальшивую валюту и украденные данные.</td></tr><tr><td>DEFI</td><td>3007</td><td>DeFi-приложения, которые являются децентрализованными финансовыми приложениями, предоставляют одноранговые финансовые услуги на публичных блокчейнах. Когда DeFi-dApp не попадает в конкретные категории, такие как DEX (децентрализованная биржа), он относится к этой общей категории. Однако в будущем он может быть категоризован под новыми категориями.</td></tr><tr><td>DEX</td><td>3008</td><td>Одноранговые рынки, где транзакции происходят напрямую между трейдерами криптовалюты.</td></tr><tr><td>АГРЕГАТОР DEX</td><td>3009</td><td>Платформа, которая берет ликвидность с различных децентрализованных бирж для обеспечения оптимального исполнения торговых операций с учетом цены и проскальзывания</td></tr><tr><td>ЭЛЕКТРОННАЯ КОММЕРЦИЯ</td><td>3010</td><td>Платформы электронной коммерции, поддерживающие криптовалюты.</td></tr><tr><td>БИРЖА</td><td>3011</td><td>Централизованные платформы, которые позволяют людям покупать, продавать и торговать различными криптовалютами.</td></tr><tr><td>КРАНЫ</td><td>3012</td><td>Приложение или веб-сайт, который распределяет небольшие суммы криптовалюты в качестве награды за выполнение несложных задач.</td></tr><tr><td>АЗАРТНЫЕ ИГРЫ</td><td>3013</td><td>Онлайн-платформы, позволяющие пользователям играть на криптовалюты.</td></tr><tr><td>ИНФРАСТРУКТУРА</td><td>3014</td><td>Базовые службы или программы, развернутые на блокчейне, такие как служба ENS (служба имен Ethereum) и программы системы Solana.</td></tr><tr><td>МАРКЕТПЛЕЙС NFT</td><td>3015</td><td>Платформы, способствующие покупке, продаже и созданию неинициируемых токенов (NFT).</td></tr><tr><td>МАЙНИНГ ПУЛ</td><td>3016</td><td>Майнинг пул - это когда отдельные криптомайнеры объединяются и объединяют свои ресурсы, чтобы улучшить свои шансы на получение награды за блок.</td></tr><tr><td>МИКСЕР</td><td>3017</td><td>Сервис, который смешивает криптовалюту большого количества пользователей, чтобы замаскировать происхождение и владельцев средств.</td></tr><tr><td>ПЛАТЕЖНЫЙ ПРОЦЕССОР</td><td>3018</td><td>Сервис, который обрабатывает платежи в цифровых валютах и позволяет торговцам принимать платежи в криптовалюте.</td></tr><tr><td>ВЫМОГАТЕЛЬСКОЕ ПО</td><td>3019</td><td>Преступные группировки, занимающиеся вымогательством с помощью программ-вымогателей.</td></tr><tr><td>КОШЕЛЕК</td><td>3020</td><td>Программы или устройства, которые позволяют пользователям хранить и использовать криптовалюту.</td></tr></tbody></table>

### Атрибут

Мы используем ***Атрибут*** для описания поведения или действия, связанного с конкретным адресом или сущностью. Все атрибуты перечислены в таблице ниже.

<table><thead><tr><th width="163">Атрибут</th><th width="92">Код</th><th>Описание</th></tr></thead><tbody><tr><td>АТТАКЕР</td><td>4001</td><td>Адреса, участвующие в атакующих событиях, таких как эксплуатация контрактов, взлом личных ключей или шантаж.</td></tr><tr><td>ЗАБЛОКИРОВАНО</td><td>4002</td><td>Адреса, которые были заблокированы критическими контрактами, прежде всего USDT и USDC.</td></tr><tr><td>ХОЛОДНЫЙ КОШЕЛЕК</td><td>4004</td><td>Холодный кошелек относится к виду криптовалютного кошелька, который хранится в оффлайне и не подключен к интернету.</td></tr><tr><td>ДАРКНЕТ БИЗНЕС</td><td>4006</td><td>Адреса, участвующие в темных сетевых бизнесах, охватывающих такие действия, как наркотики, оружие, жестокое обращение и другие незаконные практики.</td></tr><tr><td>ДЕПОЗИТНЫЙ АДРЕС</td><td>4007</td><td>Депозитный адрес здесь относится к адресу, используемому централизованной платформой для получения пользовательских депозитов, и, как правило, каждому пользователю назначается уникальный депозитный адрес.</td></tr><tr><td>ГОРЯЧИЙ КОШЕЛЕК</td><td>4009</td><td>Горячий кошелек - это тип криптовалютного кошелька, который подключен к интернету и активно используется для транзакций и повседневного управления криптовалютами.</td></tr><tr><td>ОТМЫВАНИЕ</td><td>4011</td><td>Адреса и сущности, связанные с этим атрибутом, считаются причастными к отмыванию денежных средств.</td></tr><tr><td>СМЕШИВАНИЕ</td><td>4012</td><td>Этот ярлык присваивается услугам или адресам (в первую очередь контрактам), которые, по мнению, способны замаскировать движения средств.</td></tr><tr><td>БЕЗ KYC</td><td>4013</td><td>VASP (поставщик услуг виртуальных активов), связанный с адресом, не имеет процедуры KYC (Знай своего клиента).</td></tr><tr><td>ВОЗВРАТ СРЕДСТВ</td><td>4014</td><td>Адрес, использованный для выполнения атаки или эксплуатации, с последующим возвратом средств. Этот человек может быть белым хакером или тем, кто достиг соглашения с командой проекта.</td></tr><tr><td>САНКЦИОНИРОВАНО</td><td>4015</td><td>Криптовалютный адрес, связанный с лицами или организациями, подпадающими под санкции.</td></tr><tr><td>МОШЕННИЧЕСТВО</td><td>4016</td><td>Адреса, связанные с индивидуумами или организациями, вовлеченными в мошеннические действия, включая фишинг, ловушки, финансовые пирамиды и многое другое.</td></tr></tbody></table>

### Тег имени

Имя используется для описания криптовалютного адреса с читаемой для человека информацией. Присвоение имен обычно учитывает сущность, связанную с адресом, и его конкретные атрибуты, такие как горячий кошелек Binance 1 или Vitalik 2.

## Поддерживаемые сети

API адресных меток поддерживает 25 различных цепей, которые перечислены в таблице ниже. Мы также предоставляем [API](/ru/blocksec-aml-api/address-label-api/apis.md#get-supported-chains), который позволяет вам получать список всех поддерживаемых цепей, чтобы быть в курсе новых добавленных цепей.

{% hint style="info" %}
При отправке запроса к API, пожалуйста, используйте **ID цепи** для указания желаемой цепи.
{% endhint %}

| Название сети            | Краткое название | ID цепи    |
| ------------------------ | ---------------- | ---------- |
| Solana                   | SOLANA           | -3         |
| Tron                     | TRX              | -2         |
| Основная сеть Bitcoin    | BTC              | -1         |
| Основная сеть Ethereum   | ETH              | 1          |
| Основная сеть Optimism   | OPTIMISM         | 10         |
| Основная сеть Cronos     | CRONOS           | 25         |
| Основная сеть BNB        | BSC              | 56         |
| Gnosis                   | GNOSIS           | 100        |
| Основная сеть Polygon    | POLYGON          | 137        |
| Основная сеть BitTorrent | BITTORRENT       | 199        |
| Fantom                   | FANTOM           | 250        |
| Boba Network             | BOBA             | 288        |
| Основная сеть zkSync Era | ZKSYNC ERA       | 324        |
| CLV Parachain            | CLV              | 1024       |
| Polygon zkEvm            | POLYGON ZKEVM    | 1101       |
| Основная сеть WEMIX3.0   | WEMIX            | 1111       |
| Moonbeam                 | MOONBEAM         | 1284       |
| Moonriver                | MOONRIVER        | 1285       |
| Base                     | BASE             | 8453       |
| Arbitrum One             | ARBITRUM         | 42161      |
| Основная сеть Celo       | CELO             | 42220      |
| Avalanche C-Chain        | AVALANCHE        | 43114      |
| Linea                    | LINEA            | 59144      |
| Основная сеть Blast      | BLAST            | 81457      |
| Основная сеть Aurora     | AURORA           | 1313161554 |

## Подписка

{% hint style="success" %}
Подпишитесь на [наш план](https://metasleuth.io/plans#apis), чтобы использовать этот API в вашем сервисе для помощи в соблюдении требований соответствия и защиты активов пользователей.
{% endhint %}


---

# 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://docs.metasleuth.io/ru/blocksec-aml-api/address-label-api.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.
