> For the complete documentation index, see [llms.txt](https://docs.metasleuth.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metasleuth.io/ru/blocksec-aml-api/address-label-api.md).

# 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 %}
Категория	Код	Описание
УПРАВЛЕНИЕ АКТИВАМИ	3001	Финансовые институты, специализирующиеся на управлении и инвестировании активов от имени клиентов.
МОСТ	3002	Протоколы, облегчающие движение активов и данных между различными блокчейнами.
МАТЕРИАЛЫ О ЖЕСТОКОМ ОБРАЩЕНИИ С ДЕТЬМИ	3003	Форумы и веб-сайты, способствующие покупке, продаже и распространению материалов о жестоком обращении с детьми.
ОБЛАЧНЫЙ МАЙНИНГ	3004	Сервисы, позволяющие людям арендовать вычислительную мощность от удаленных дата-центров для майнинга криптовалюты без управления физическим оборудованием.
DAPP	3005	Децентрализованное приложение (dApp) — это приложение, разработанное на децентрализованной сети, интегрирующее смарт-контракт и пользовательский интерфейс. Когда dApp не подходит под конкретные категории, такие как DeFi, он относится к этой общей категории. Однако в будущем он может быть категоризован под новыми категориями.
ТЕМНЫЙ РЫНОК	3006	Нелегальные веб-сайты в даркнете, способствующие покупке и продаже незаконных товаров и услуг, включая наркотики, оружие, фальшивую валюту и украденные данные.
DEFI	3007	DeFi-приложения, которые являются децентрализованными финансовыми приложениями, предоставляют одноранговые финансовые услуги на публичных блокчейнах. Когда DeFi-dApp не попадает в конкретные категории, такие как DEX (децентрализованная биржа), он относится к этой общей категории. Однако в будущем он может быть категоризован под новыми категориями.
DEX	3008	Одноранговые рынки, где транзакции происходят напрямую между трейдерами криптовалюты.
АГРЕГАТОР DEX	3009	Платформа, которая берет ликвидность с различных децентрализованных бирж для обеспечения оптимального исполнения торговых операций с учетом цены и проскальзывания
ЭЛЕКТРОННАЯ КОММЕРЦИЯ	3010	Платформы электронной коммерции, поддерживающие криптовалюты.
БИРЖА	3011	Централизованные платформы, которые позволяют людям покупать, продавать и торговать различными криптовалютами.
КРАНЫ	3012	Приложение или веб-сайт, который распределяет небольшие суммы криптовалюты в качестве награды за выполнение несложных задач.
АЗАРТНЫЕ ИГРЫ	3013	Онлайн-платформы, позволяющие пользователям играть на криптовалюты.
ИНФРАСТРУКТУРА	3014	Базовые службы или программы, развернутые на блокчейне, такие как служба ENS (служба имен Ethereum) и программы системы Solana.
МАРКЕТПЛЕЙС NFT	3015	Платформы, способствующие покупке, продаже и созданию неинициируемых токенов (NFT).
МАЙНИНГ ПУЛ	3016	Майнинг пул - это когда отдельные криптомайнеры объединяются и объединяют свои ресурсы, чтобы улучшить свои шансы на получение награды за блок.
МИКСЕР	3017	Сервис, который смешивает криптовалюту большого количества пользователей, чтобы замаскировать происхождение и владельцев средств.
ПЛАТЕЖНЫЙ ПРОЦЕССОР	3018	Сервис, который обрабатывает платежи в цифровых валютах и позволяет торговцам принимать платежи в криптовалюте.
ВЫМОГАТЕЛЬСКОЕ ПО	3019	Преступные группировки, занимающиеся вымогательством с помощью программ-вымогателей.
КОШЕЛЕК	3020	Программы или устройства, которые позволяют пользователям хранить и использовать криптовалюту.
Атрибут	Код	Описание
АТТАКЕР	4001	Адреса, участвующие в атакующих событиях, таких как эксплуатация контрактов, взлом личных ключей или шантаж.
ЗАБЛОКИРОВАНО	4002	Адреса, которые были заблокированы критическими контрактами, прежде всего USDT и USDC.
ХОЛОДНЫЙ КОШЕЛЕК	4004	Холодный кошелек относится к виду криптовалютного кошелька, который хранится в оффлайне и не подключен к интернету.
ДАРКНЕТ БИЗНЕС	4006	Адреса, участвующие в темных сетевых бизнесах, охватывающих такие действия, как наркотики, оружие, жестокое обращение и другие незаконные практики.
ДЕПОЗИТНЫЙ АДРЕС	4007	Депозитный адрес здесь относится к адресу, используемому централизованной платформой для получения пользовательских депозитов, и, как правило, каждому пользователю назначается уникальный депозитный адрес.
ГОРЯЧИЙ КОШЕЛЕК	4009	Горячий кошелек - это тип криптовалютного кошелька, который подключен к интернету и активно используется для транзакций и повседневного управления криптовалютами.
ОТМЫВАНИЕ	4011	Адреса и сущности, связанные с этим атрибутом, считаются причастными к отмыванию денежных средств.
СМЕШИВАНИЕ	4012	Этот ярлык присваивается услугам или адресам (в первую очередь контрактам), которые, по мнению, способны замаскировать движения средств.
БЕЗ KYC	4013	VASP (поставщик услуг виртуальных активов), связанный с адресом, не имеет процедуры KYC (Знай своего клиента).
ВОЗВРАТ СРЕДСТВ	4014	Адрес, использованный для выполнения атаки или эксплуатации, с последующим возвратом средств. Этот человек может быть белым хакером или тем, кто достиг соглашения с командой проекта.
САНКЦИОНИРОВАНО	4015	Криптовалютный адрес, связанный с лицами или организациями, подпадающими под санкции.
МОШЕННИЧЕСТВО	4016	Адреса, связанные с индивидуумами или организациями, вовлеченными в мошеннические действия, включая фишинг, ловушки, финансовые пирамиды и многое другое.