1 of 9

v2 (удалён)

Старая версия API

Это старая версия нашего API.

Мы прекратили поддержку API с 1 июля 2024 года. Пожалуйста, обратитесь к последней версии.

Не стесняйтесь обращаться к нам (ms_support@blocksec.com), если у вас есть какие-либо вопросы по поводу этой миграции.

Начало работы

Добро пожаловать в документацию API MetaSleuth!

Откройте потенциал нашего мощного API, поддерживаемого базой данных адресных меток BlockSec и алгоритмом оценки рисков.

API адресных меток: Получите доступ к детализированной информации и меткам для on-chain адресов. Опишите идентичности и активности конкретных адресов, что поможет вам легче понять блокчейн.
API оценки уровня соответствия: Оцените уровни рисков и индикаторы для адресов, что позволит вам более эффективно оценивать требования к соответствию. Обнаруживайте и предотвращайте взаимодействие с незаконными средствами, соблюдайте нормативные требования.

Аутентификация

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

Как получить API ключ?

Чтобы сгенерировать API ключ, начните с регистрации учетной записи MetaSleuth. После регистрации зайдите в панель API в разделе Настройки, где вы можете легко сгенерировать ваш API ключ.

Как использовать API ключ

Для каждого запроса к API убедитесь, что включили заголовок "API-KEY" в HTTP заголовки запроса и указали ваш API ключ в качестве значения.

Лимиты скорости

Чтобы предотвратить перегрузку API и обеспечить оптимальную скорость обработки и время отклика, мы внедрили ограничения доступа на вызовы API.

Address Labe API: Ограничено 5 вызовами в секунду.
Compliance Score API: Ограничено 5 вызовами в секунду.

Для получения информации о дневных лимитах запросов в зависимости от различных тарифных планов, пожалуйста, ознакомьтесь с нашими Тарифными планами API.

Поддерживаемые цепи

Пожалуйста, используйте предоставленные имена цепочек (без учета регистра) при отправке запросов

Цепочка

Chain ID

Имя цепочки

Bitcoin

btc

Ethereum

eth

BNB Smart Chain

bsc

TRON

tron

Fantom

250

fantom

Arbitrum One

42161

arbitrum

Avalanche C-Chain

43114

avalanche

Optimism

optimism

Polygon

137

polygon

Cronos

cronos

Base

8453

base

Linea

59144

linea

Moonbeam

1284

moonbeam

Moonriver

1285

moonriver

Polygon zkEVM

1101

polygon zkevm

Celo

42220

celo

CLV

1024

clv

Gnosis

100

gnosis

Bittorrent

199

bittorrent

Boba

288

boba

Wemix3.0

1111

wemix

zkSync Era

324

zksync era

Aurora

1313161554

aurora

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

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

Имя

Тип

Описание

Заголовки

Имя

Тип

Описание

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

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

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

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

Поле

Тип

Описание

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

Приложение

Приложение 1: Глоссарий

Сущность

Контроллер указанного адреса. Для адреса EOA сущностью обычно является идентичность, которая контролирует закрытый ключ. В то время как для контракта сущностью обычно является развёртыватель или владелец с высокими привилегиями.

Вторичная Сущность

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

Тег Имени

Используется как уникальный идентификатор для адреса.

Свойство Адреса

Используется для указания характеристик, связанных с адресом, таких как 'HOT WALLET' или 'BLOCKED BY USDT'.

Свойство Сущности

Используется для характеристики атрибутов, проявляемых сущностью, таких как 'NO KYC' или 'OFAC SANCTIONED'.

Оценка Доверия

Диапазон оценки от 1 до 10. По умолчанию возвращаются только метки с оценкой доверия выше 5.

Риск Оценки

Диапазон оценки от 1 до 5. Адреса с рейтингом 4 или выше считаются имеющими значительный риск несоответствия.

Приложение 2: Категории Факторов Риска

Метка адреса

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

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

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

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