Метка адреса

Получение меток для одного адреса

Возвращает информацию о метке для целевого адреса

GET https://aml.blocksec.com/api/aml/v2/address

Параметры пути

Имя	Тип	Описание
chain*	String	имя цепи, см. поддерживаемые цепи
address*	String	целевой адрес

Заголовки

Имя	Тип	Описание
API-KEY*	String	Ваш API ключ

Запрос

curl --location 'https://aml.blocksec.com/api/aml/v2/address/eth/0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff' \
--header 'API-KEY: $ApiKey'

Ответ

Пример ответа

{
    "code": 200,
    "data": [
        {
            "address": "0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": false,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "HUOBI",
                        "category": "CEX",
                        "confidence": 8
                    }
                ],
                "property_info": [
                    {
                        "address_property": "DEPOSIT ADDRESS",
                        "confidence": 8
                    },
                    {
                        "address_property": "EXPLOIT",
                        "category": "ATTACKER",
                        "confidence": 9
                    }
                ],
                "name_tag": "Ronin Bridge Exploiter 27",
                "others": [
                    {
                        "label": "RONIN BRIDGE EXPLOIT",
                        "confidence": 9
                    }
                ]
            },
            "risk": 5
        }
    ]
}

• code: Integer. Код ошибки.

  • 200: Ошибок нет.

  • другое: Возникла ошибка.

• msg: String

  • Если code не 200, это поле обозначает подробную информацию об ошибке.

• data: Array

  • Список информации о метках запрашиваемого адреса. См. Параметры данных ответа для деталей.

Получение меток для нескольких адресов

GET https://aml.blocksec.com/api/aml/v2/addresses

Параметры пути

Имя	Тип	Описание
chain*	String	имя цепи, см. поддерживаемые цепи
addresses*	String	Целевые адреса, соединенные в единую строку, используя ', ' как разделитель. Количество адресов в одном запросе не должно превышать 100.

Заголовки

Имя	Тип	Описание
API-KEY*	String	Ваш API ключ

200: ОК

Запрос

Пример запроса

curl --location 'https://aml.blocksec.com/api/aml/v2/addresses/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x0191e884bf8e21e138e161da520f94d4bbc79c1c' \
--header 'API-KEY: $ApiKey'

Ответ

Пример ответа

{
    "code": 200,
    "data": [
        {
            "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": true,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "CENTRE",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "FiatTokenProxy",
                    "token_name": "USD Coin (USDC)"
                },
                "name_tag": "Circle: USDC Token",
                "others": [
                    {
                        "label": "CIRCLE",
                        "confidence": 9
                    },
                    {
                        "label": "STABLECOIN",
                        "confidence": 9
                    },
                    {
                        "label": "TOKEN CONTRACT",
                        "confidence": 9
                    },
                    {
                        "label": "USDC",
                        "confidence": 9
                    }
                ]
            },
            "risk": 2
        },
        {
            "address": "0x8672867cb976c723d600d810b419d439133fca7a",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": true,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "BITTREX",
                        "category": "CEX",
                        "confidence": 9
                    }
                ],
                "property_info": [
                    {
                        "address_property": "DEPOSIT ADDRESS",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "UserWallet"
                }
            },
            "risk": 1
        }
    ]
}

Формат ответа соответствует результату, возвращаемому запросом одного адреса.

• code: Integer. Код ошибки.

  • 200: Ошибок нет.

  • другое: Возникла ошибка.

• msg: String

  • Если code не 200, это поле обозначает подробную информацию об ошибке.

• data: Array

  • Список информации о метках запрашиваемого адреса. См. Параметры данных ответа для деталей.

Параметры данных ответа

Поле	Тип	Описание
address	String	Целевой адрес
is_address_valid	Boolean	Соответствует ли адрес формату адреса целевой блокчейн-сети
chain	String	Целевая блокчейн-сеть
is_contract	Boolean	Является ли целевой адрес контрактом
*labels	Object	Информация о метках, см. Подполя поля меток для подробностей
compatible_chain_labels	Array	Возвращает метки на совместимых цепях, если на целевой цепи нет информации. См. Подполя поля меток для подробностей
risk	Integer	Оценка риска

Для пояснений по подчеркнутым словам обратитесь к Приложению 1: Глоссарий.

Подполя поля меток

Поле	Тип	Описание
chain	String	Цепь, к которой принадлежит адрес. Доступно для compatible_chain_labels
entity_info	Object	Информация о сущности, подполя перечислены ниже
> entity_type	String	‘first’ указывает на Сущность, ‘second’ указывает на Вторичную сущность
> entity	String	Название Сущности
> category	String	Категория Сущности
> entity_property	String	Свойство сущности
> confidence	Integer	Уверенность информации о сущности
property_info	Object	Информация о свойствах, подполя перечислены ниже
> address_property	String	Свойство адреса
> category	String	Категория свойства адреса
> confidence	Integer	Уверенность свойства адреса
contract_info	Object	Информация о контракте, если это адрес контракта, подполя перечислены ниже
> contract_name	String	Имя контракта
> token_name	String	Имя токена, если это контракт токена
name_tag	String	Метка имени
others	Array	Список информации о метках, подполя перечислены ниже
> label	String	Метки, которые не попадают в вышеуказанные поля
> confidence	Integer	Уверенность для каждой метки