1 of 3

API endpoints

Обзор конечных точек API MetaSleuth.

Метка адреса

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

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

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 ключ

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

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

Уверенность для каждой метки

Оценка соответствия

Получить информацию о риске соответствия для одного адреса

GET https://aml.blocksec.com/api/risk/v1/address

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

Имя

Тип

Описание

chain *

String

address*

String

Целевой адрес

Заголовки

Имя

Тип

Описание

API-KEY*

String

Ваш API-ключ

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

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

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

{
	"code": 200,
	"msg": "OK",
	"data": {
    	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
    	"chain": "ETH",
    	"is_address_valid": true,
    	"entity_info": {
        	"entity": "TORNADO.CASH",
        	"name_tag": "Tornado.Cash: 0.1 ETH",
        	"contract_name": "TornadoCash_Eth_01"
    	},
    	"risk_indicators": [
        	{
            	"risk_type": "Ownership",
            	"risk_label": "OFAC SANCTIONED",
            	"risk_category": "SANCTIONED"
        	},
        	{
            	"risk_type": "Ownership",
            	"risk_label": "TORNADO.CASH",
            	"risk_category": "MIXER"
        	}
    	],
    	"risk_level": 5
	}
}

code: Integer. Код ошибки.
- 200: Ошибок нет.
- other: Произошла ошибка.
msg: String
- Если code не 200, это поле обозначает подробную информацию об ошибке.
data: Object
- Подробная информация о риске целевого адреса, подробнее в разделе 'Параметр данных ответа'.

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

Поле

Тип

Описание

address

String

Целевой адрес

chain

String

Целевая цепь

is_address_valid

Boolean

Соответствует ли адрес формату адреса целевой блокчейн

entity_info

Object

Информация об адресной сущности, перечисление подполей ниже

> entity

String

Имя Сущности

> name_tag

String

Тег Имени

> contract_name

String

Имя контракта

> token_name

String

Имя токена, если это контракт токена

risk_indicators

Array

risk_level

Integer

Оценка риска

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

Подполя поля risk_indicators

Поле

Тип

Описание

risk_type

string

Типы рисков, включая Ownership (риск сущности) и Counterparty (прямое взаимодействие с рискованным адресом)

risk_label

string

Метка риска

risk_category

string

Категория метки риска

risk_source

object

Когда risk_type — 'Counterparty', следующие подполя предоставляют информацию об источнике риска.

> chain

string

Цепь, в которой находится источник риска.

> address

string

Адрес источника риска

> entity

string

Имя Сущности источника риска

Оценка соответствия

Получить информацию о риске соответствия для одного адреса

GET https://aml.blocksec.com/api/risk/v1/address

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

Имя

Тип

Описание

chain *

String

имя цепи, см.

address*

String

Целевой адрес

Заголовки

Имя

Тип

Описание

API-KEY*

String

Ваш API-ключ

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

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

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

{
	"code": 200,
	"msg": "OK",
	"data": {
    	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
    	"chain": "ETH",
    	"is_address_valid": true,
    	"entity_info": {
        	"entity": "TORNADO.CASH",
        	"name_tag": "Tornado.Cash: 0.1 ETH",
        	"contract_name": "TornadoCash_Eth_01"
    	},
    	"risk_indicators": [
        	{
            	"risk_type": "Ownership",
            	"risk_label": "OFAC SANCTIONED",
            	"risk_category": "SANCTIONED"
        	},
        	{
            	"risk_type": "Ownership",
            	"risk_label": "TORNADO.CASH",
            	"risk_category": "MIXER"
        	}
    	],
    	"risk_level": 5
	}
}

code: Integer. Код ошибки.
- 200: Ошибок нет.
- other: Произошла ошибка.
msg: String
- Если code не 200, это поле обозначает подробную информацию об ошибке.
data: Object
- Подробная информация о риске целевого адреса, подробнее в разделе 'Параметр данных ответа'.

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

Поле

Тип

Описание

address

String

Целевой адрес

chain

String

Целевая цепь

is_address_valid

Boolean

Соответствует ли адрес формату адреса целевой блокчейн

entity_info

Object

Информация об адресной сущности, перечисление подполей ниже

> entity

String

Имя Сущности

> name_tag

String

Тег Имени

> contract_name

String

Имя контракта

> token_name

String

Имя токена, если это контракт токена

risk_indicators

Array

Список элементов риска, подробности формата в таблице '' ниже

risk_level

Integer

Оценка риска

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

Подполя поля risk_indicators

Поле

Тип

Описание

risk_type

string

Типы рисков, включая Ownership (риск сущности) и Counterparty (прямое взаимодействие с рискованным адресом)

risk_label

string

Метка риска

risk_category

string

Категория метки риска

risk_source

object

Когда risk_type — 'Counterparty', следующие подполя предоставляют информацию об источнике риска.

> chain

string

Цепь, в которой находится источник риска.

> address

string

Адрес источника риска

> entity

string

Имя Сущности источника риска

Метка адреса

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

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

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

Заголовки

Имя

Тип

Описание

API-KEY*

String

Ваш API ключ

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

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

Уверенность для каждой метки