NAV
shell python

Changelog

12-12-2022

08-02-2023

FAQ

Что такое AlfaBit AML?

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

В чём разница между проверкой транзакции и проверкой адреса?

Что означают категории в результатах проверки?

В результате проверки показаны связи проверяемого адреса с категориями в процентном соотношении. На основании всех связей выдается усредненная оценка риска, которая помогает пользователю принимать дальнейшее решение по активам.

Какие криптовалюты анализирует AlfaBit AML?

Bitcoin, Ethereum, USDT, ERC20 Tokens, TRC20 Tokens, Binance Smart Chain, MATIC, OMNI, Dogecoin, Bitcoin Cash, Ripple, Bitcoin SV, Solana, Litecoin, ZCASH, Ether Classic, Cardano

Bitcoin, Ethereum, USDT, ERC20 Tokens, TRC20 Tokens, Binance Smart Chain, MATIC, OMNI, Dogecoin, Bitcoin Cash, Ripple, Bitcoin SV, Solana, Litecoin, ZCASH, Ether Classic, Cardano

Что показывает проверка адреса?

Термины и сокращения

API ключ — используется для предоставления доступа к ресурсам согласно стандарту авторизации HTTP Basic Auth.

API (Application Programming Interface) — это инструмент, который позволяет взаимодействовать программам, сервисам, приложениям.

JSON (JavaScript Object Notation) — текстовый формат обмена данными, основанный на JavaScript RFC 7159.

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

Чтобы начать работу с AlfaBit AML, выполните следующие шаги:

Шаг 1. Получите доступ к личному кабинету

Перейдите в AlfaBit AML Bot, нажмите "Начать"

Шаг 2. Выпустите ключ доступа к API

Ключ доступа к API используется для взаимодействия с API. Ключ можно получить в разделе "Мой Кабинет" по кнопке "API ключ"

Шаг 3. Пополните баланс

Пополнение баланса API ключа происходит из Telegram бота в разделе "Пополнить"

Шаг 4. Начинайте взаимодействие с API

Теперь Вам доступен весь функционал AlfaBit AML API, изучите документацию и начинайте интеграцию.

URL-адрес для вызова API:

https://aml.alfabit.org/api

Все запросы отправляются с заголовком Content-Type: application/json

Интерфейс поддерживает функции для выполнения проверок по адресу кошелька, хэша транзакции, запрос истории проверок, а также генерации pdf-файла с отчётом о проверке.

Принципы работы

Аутентификация запросов

Для аутентификации запроса используется HTTP Basic Auth — отправка API ключа в заголовке HTTP-запроса. Для получения API ключа перейдите в AlfaBit AML Bot, в разделе "Мой Кабинет" выберите "API ключ".

Для авторизации используйте этот код:

import requests

response = requests.request("method", 
                            "api_endpoint_here", 
                            headers={
                              "Authorization: aml_authorization_api_key"
                            })

# With shell, you can just pass the correct header with each request
curl "api_endpoint_here" \
  -H "Authorization: aml_authorization_api_key"

Замените aml_authorization_api_key своим API key.

Authorization: aml_authorization_api_key

AML API

Проверка адреса кошелька

import requests

response = requests.post("https://aml.alfabit.org/api/check/address/",
                         headers={"Authorization": aml_authorization_api_key},
                         json={"coin": "Bitcoin(BTC)",
                               "address": "bc1q860ry4y7vqpmykpzev4kta6d8dpfs226r8gv6c",
                               "callback_url": "https://test.com/test"}
                         )

curl -X POST "https://aml.alfabit.org/api/check/address/" \
     -H "Authorization: aml_authorization_api_key" \
     -d '{"coin": "Bitcoin(BTC)", "address":"bc1q860ry4y7vqpmykpzev4kta6d8dpfs226r8gv6c", "callback_url":"https://test.com/test"}'

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

Ответ после запроса на эндпоинт
  {
    "result": True,
    "message": "Task with report was added to queue",
    "report_id": 1
  }

Отправленный отчет на callback_url

  {
    "id": 1,
    "address": "bc1q860ry4y7vqpmykpzev4kta6d8dpfs226r8gv6c",
    "hash": "None",
    "created_date": "1669444680.1080601",
    "check_response": {
        "detail": "Success",
        "Address": "bc1q860ry4y7vqpmykpzev4kta6d8dpfs226r8gv6c",
        "Blockchain": "BTC",
        "Risk": 12.0,
        "Category": "Darknet Marketplace 7.3%,Illegal Service 0.6%,Payment Processor 0.1%,Sanctions 1.7%,Exchange With Low ML Risk 83.4%,Exchange With Very High ML Risk 4.1%,P2P Exchange With High ML Risk 2.6%",
        "Status": "Active",
        "First": "Jan 09, 2023 09:04 PM",
        "Last": "Jan 10, 2023 05:33 PM",
        "Received": 47.95938782,
        "Sent": 46.91616405,
        "Transactions": 50,
        "Time": "Jan 10, 2023 06:16 PM GMT"
            },
    "requests_left": 100
  }

Эндпоинт предназначен для AML проверки адреса кошелька

HTTP Request

POST

https://aml.alfabit.org/api/check/address/

Доступные токены для проверки: Bitcoin(BTC), Ethereum(ETH), USDT-ERC20(Tether), ERC20 Tokens, USDT-TRC20(Tether), TRC20 Tokens, USDT-BEP20(Tether), BEP20 Tokens, USDT-POLY20(Tether), Polygon (Matic), USDT-OMNI(Tether), Dogecoin(DOGE), BitcoinCash(BCH), Ripple(XRP), BitcoinSV(BSV), Solana(SOL), Litecoin(LTC), ZCASH(ZEC), EtherClassic(ETC), Cardano(ADA), POLY20 Tokens

Параметры

Параметр Обязательный Описание
coin да Токен проверяемого адреса
address да Адрес кошелька для проверки
callback_url да Путь куда следует прислать отчет о выполненной проверке

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

Доступные токены для проверки кошелька

import requests

response = requests.get("https://aml.alfabit.org/api/check/address/tokens/",
                         headers={"Authorization": aml_authorization_api_key},
                         )

curl "https://aml.alfabit.org/api/check/address/tokens/" \
  -H "Authorization: aml_authorization_api_key"

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


{
  "result": true,
  "type": "address",
  "tokens": ["Bitcoin(BTC)", "USDT-OMNI(Tether)", ...]
}

Эндпоинт предназначен для получения списка токенов поддерживающих проверку адреса

HTTP Request

GET

https://aml.alfabit.org/api/check/address/tokens/

Проверка хэша транзакции

import requests

response = requests.post("https://aml.alfabit.org/api/check/hash/",
                         headers={"Authorization": aml_authorization_api_key},
                         json={"coin": "USDT-TRC20(Tether)",
                               "hash": "4263aea55f72ca48fb34ffc61efcee78f5ac5bb7f354f4946458dd4564952422",
                               "callback_url": "https://test.com/test"}
                         )

curl -X POST "https://aml.alfabit.org/api/check/hash/TRC20/" \
     -d '{"coin": "USDT-TRC20(Tether)", "hash":"4263aea55f72ca48fb34ffc61efcee78f5ac5bb7f354f4946458dd4564952422", "callback_url":"https://test.com/test"}' \
     -H "Authorization: aml_authorization_api_key"

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

Ответ после запроса на эндпоинт
  {
    "result": True,
    "message": "Task with report № 1 was added to queue",
    "report_id": 1
  }

Отправленный отчет на callback_url

  {
    "id": 1,
    "address": "None",
    "hash": "4263aea55f72ca48fb34ffc61efcee78f5ac5bb7f354f4946458dd4564952422",
    "created_date": "1669444680.1080601",
    "check_response": {
        "detail": "Success",
        "Address": "TESQRVzxobH1ewxcJNyYPqsafrzGc4TDdx",
        "Blockchain": "TRC20",
        "Risk": 0,
        "Category": "Exchange With Low ML Risk 100%",
        "Status": "Active",
        "First": "Nov 16, 2022 05:46 PM",
        "Last": "Nov 16, 2022 05:46 PM",
        "Received": 0.20739289,
        "Sent": 0,
        "Transactions": 1,
        "Time": "Nov 26, 2022 12:38 PM",
            },
    "requests_left": 100
  }

Эндпоинт предназначен для AML проверки хэша транзакции

HTTP Request

POST

https://aml.alfabit.org/api/check/hash/

Доступные токены для проверки: Bitcoin(BTC), Ethereum(ETH), USDT-ERC20(Tether), ERC20 Tokens, USDT-TRC20(Tether), TRC20 Tokens, USDT-BEP20(Tether), BEP20 Tokens, USDT-POLY20(Tether), Polygon (Matic), USDT-OMNI(Tether), Dogecoin(DOGE), BitcoinCash(BCH), Ripple(XRP), BitcoinSV(BSV), Solana(SOL), Litecoin(LTC), ZCASH(ZEC), EtherClassic(ETC), Cardano(ADA), POLY20 Tokens

Параметры

Параметр Обязательный Описание
coin да Токен проверяемой транзакции
hash да Хэш транзакции
direction нет Проверяемый адрес sender(отправляющий)/recipient(принимающий), по умолчанию sender
callback_url да Путь куда следует прислать отчет о выполненной проверке

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

Доступные токены для проверки хэша транзакции

import requests

response = requests.get("https://aml.alfabit.org/api/check/hash/tokens/",
                         headers={"Authorization": aml_authorization_api_key},
                         )

curl "https://aml.alfabit.org/api/check/hash/tokens/" \
  -H "Authorization: aml_authorization_api_key"

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


{
  "result": true,
  "type": "hash",
  "tokens": ["Bitcoin(BTC)", "USDT-OMNI(Tether)", ...]
}

Эндпоинт предназначен для получения списка токенов поддерживающих проверку хэша транзакции

HTTP Request

GET

https://aml.alfabit.org/api/check/hash/tokens/

История проверок

import requests

response = requests.get("https://aml.alfabit.org/api/checks/history/?check_type=address&page=1&page_size=10",
                         headers={"Authorization": aml_authorization_api_key}
                         )

curl "https://aml.alfabit.org/api/checks/history/?check_type=address&page=1&page_size=10" \
     -H "Authorization: aml_authorization_api_key"

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

{
  "count": 11,
  "pages": 2,
  "next": 2,
  "previous": null,
  "results": [
    {
      "id": 1,
      "hash": null,
      "check_response": {
        "detail": "Success",
        "Address": "bc1q860ry4y7vqpmykpzev4kta6d8dpfs226r8gv6c",
        "Blockchain": "BTC",
        "Risk": 12.0,
        "Category": "Darknet Marketplace 7.3%,Illegal Service 0.6%,Payment Processor 0.1%,Sanctions 1.7%,Exchange With Low ML Risk 83.4%,Exchange With Very High ML Risk 4.1%,P2P Exchange With High ML Risk 2.6%",
        "Status": "Active",
        "First": "Jan 09, 2023 09:04 PM",
        "Last": "Jan 10, 2023 05:33 PM",
        "Received": 47.95938782,
        "Sent": 46.91616405,
        "Transactions": 50,
        "Time": "Jan 10, 2023 06:16 PM GMT"
      },
      "callback_url": "https://webhook.site/my-aml-check",
      "address": "bc1q860ry4y7vqpmykpzev4kta6d8dpfs226r8gv6c",
      "created_date": "1673374596.62137",
      "api_user_id": 1,
      "status": "Sent"
    },
    ...
  ]
}

Эндпоинт предназначен для получения истории проверок

HTTP Request

GET

https://aml.alfabit.org/api/checks/history/?check_type=address&page=1&page_size=10

Параметры

Параметр Обязательный Описание
check_type нет Тип проверки address/hash
page нет Номер страницы
page_size нет Кол-во элементов на странице

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

Поиск в истории проверок по адресу/хэшу

import requests

response = requests.get("https://aml.alfabit.org/api/checks/search/{search_query}/",
                         headers={"Authorization": aml_authorization_api_key}
                       )

curl "https://aml.alfabit.org/api/checks/search/{search_query}/" \
  -H "Authorization: aml_authorization_api_key"

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

[
    {
        "id": 1963,
        "address": "bc1qkk8dg2m2rftqv9fuptct6py0fws89l747rm0lj",
        "hash": "None",
        "created_date": "1669444680.1080601",
        "check_response": {
                          "detail": "Success",
                          "Address": "bc1qkk8dg2m2rftqv9fuptct6py0fws89l747rm0lj",
                          "Blockchain": "BTC",
                          "Risk": 8.32,
                          "Category": "Darknet Marketplace 0.8%,Exchange With High ML Risk 1.2%,Exchange With Low ML Risk 86.52%,Exchange With Moderate ML Risk 0.8%,Exchange With Very High ML Risk 1.6%,Gambling 6.22%,Mixing Service 0.1%,P2P Exchange With High ML Risk 1.3%,P2P Exchange With Low ML Risk 0.1%,Sanctions 1.0%,Online Wallet 0.1%",
                          "Status": "Active",
                          "First": "Nov 25, 2022 04:49 PM",
                          "Last": "Nov 25, 2022 10:19 PM",
                          "Received": 0.04004438,
                          "Sent": 0.02138349,
                          "Transactions": 2,
                          "Time": "Nov 26, 2022 12:38 PM",
    },
        "callback_url": "https://webhook.site/my-aml-check",
        "status": "Sent",
        "api_user_id": 1
    },
  ...
]

Эндпоинт предназначен для поиска в истории проверок по адресу/хэшу

HTTP Request

GET

https://aml.alfabit.org/api/checks/{search_query}/

Path Параметры

Параметр Обязательный Описание
search_query да Адрес/хэш

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

Баланс проверок

import requests

response = requests.get("https://aml.alfabit.org/api/balance/",
                        headers={"Authorization": aml_authorization_api_key}
                        )

curl "https://aml.alfabit.org/api/balance/" \
  -H "Authorization: aml_authorization_api_key"

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

{
    "user_id": 2,
    "available_count_checks": 100
}

Эндпоинт предназначен для получения баланса проверок на API ключе

HTTP Request

GET

https://aml.alfabit.org/api/balance/

Получение pdf-отчёта

import requests

response = requests.get("https://aml.alfabit.org/api/pdf-file/",
                         headers={"Authorization": aml_authorization_api_key},
                         json={"check_id": 1}
                         )

curl "https://aml.alfabit.org/api/pdf-file/" \
  -H "Authorization: aml_authorization_api_key" \
  -d '{"check_id": 1}'

Приведенная выше команда возвращает JSON, структурированный следующим образом:

  {
    "url_pdf": "url"
  }

Эндпоинт предназначен для получения pdf-отчёта проверки

HTTP Request

GET

https://aml.alfabit.org/api/pdf-file/

Параметры

Параметр Обязательный Описание
check_id да id проверки

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

Параметр Тип данных Описание
id int id проверки
created_date str дата запроса проверки
check_response dict aml отчёт
detail str статус проведенной проверки
Address str адрес кошелька или адрес входа в хэше транзакции
Blockchain str блокчейн
Risk float общая оценка риска
Category str категории риска
Status str статус адреса Active/Inactive
First str дата первой транзакции
Last str дата последней транзакции
Received float принято на кошелек
Sent float отправлено с кошелька
Transactions int кол-во транзакций
Time str время проверки
status str статус проверки
api_user_id int id апи пользователя

Категории

AlfaBit AML API может оценивать риски по следующим категориям:

Минимальный риск 0 – 25%

Категория Описание
Exchange With Low ML Risk биржи, которые требуют идентификации KYC/AML для всех операций, которые проходят через них;
Religious associations это монеты, которые были использованы религиозными объединениями;
Miner это монеты, которые были добыты майнерами и еще не попали на рынок;
P2P Exchange With Low ML Risk P2P-биржи, которые требуют идентификации KYC/AML для всех депозитов и снятия средств;
OTC Exchange With Low ML Risk обменники, которые требуют идентификации KYC/AML для всех депозитов и снятия средств, включая OTC;

Средний риск 25 – 50%

Категория Описание
ATM это монеты, которые были получены через криптовалютный банкомат;
Exchange With Moderate ML Risk биржи, которые дают разрешение ежедневно выводить не более 2000 долларов в криптовалюте без KYC/AML. (Для вывода фиатных средств требуется KYC/AML);
OTC Exchange With Moderate ML Risk обменники, которые требуют идентификации KYC/AML для всех депозитов и снятия средств, включая OTC;
P2P Exchange With Moderate ML Risk P2P-биржи, которые требуют идентификации KYC/AML для всех депозитов и снятия средств;
Payment Processor это монеты, которые проходили через платёжные системы;
Online Wallet это монеты, которые находятся в верифицированных кошельках;
Bridge это монеты, которые проходили через криптовалютный мост (вроде renBTC, WBTC и прочие);
DEX (excluding Bridges) это монеты, которые проходили через адреса различных DEX;
Media это монеты, которые проходили через средства массовой информации и авторитетных блогеров;
Online Marketplace это монеты, которые проходили через онлайн магазины;
State bodies это монеты, которые проходили через официальные адреса государственных органов различных государств;
Other иные категории, которые могут иметь средний риск;

Высокий риск 50-100%

Категория Описание
Darknet Marketplace это монеты, которые использовались для оплаты на даркнет площадках;
Darknet Service это монеты, которые использовались для оплаты в даркнет сервисах;
Exchange биржи, вовлеченные в аферы с выходом, незаконное поведение, или у которых средства были конфискованы государством;
Gambling это монеты, которые относятся к нелицензированным онлайн-казино;
Illegal Service это монеты, которые были использованы на рынке незаконной деятельности;
Mixing Service это монеты, которые были проведены через миксер, чтобы усложнить или сделать невозможным отслеживание, Миксеры чаще всего применяются для отмывания средств;
Ransom это монеты, которые были добыты через вымогательство или шантаж;
Scam это монеты, которые были получены обманным путем;
Stolen Coins это похищенные монеты;
Drugs это монеты, которые использовались для оплаты наркотиков;
Child Abuse это монеты, которые использовались для оплаты запрещённых материалов с участием несовершеннолетних;
Stolen Credit Cards это похищенные кардерами монеты в результате противоправных действий;
Blackmail это монеты, полученные путём рассылки писем с требованием выкупа, под видом взлома ПК или угрозой распространения порочащих сведений;
Personal data это монеты, полученные путём продажи персональных данных граждан какой-либо страны;
Stolen DataBase это монеты, полученные путём продажи баз данных;
Smuggling drugs это монеты, участвовавшие в контрабанде наркотиков;
Smuggling precursors это монеты, участвовавшие в контрабанде прекурсоров;
Smuggling people это монеты, участвовавшие в контрабанде людьми;
Smuggling weapons это монеты, участвовавшие в контрабанде оружия;
Smuggling это монеты, участвовавшие в контрабанде остальных нелегальных товаров;
Illegal migration это монеты, участвовавшие организации незаконной миграции;
Human trafficking это монеты, участвовавшие в торговле людьми;
Fake documents это монеты, участвовавшие в процессе изготовления поддельных документов;
Fake document rendering это монеты, участвовавшие в процессе отрисовки поддельных документов;
Illegal weapons это монеты, участвовавшие в продаже оружия;
Laundering of money это монеты, участвовавшие в отмывании доходов, полученных незаконным путём;
Fraudulent Exchange это монеты, проходящие через фейковые криптовалютные биржи, разновидность SCAM;
Malware (excluding Ransom) это монеты, разработчиков и продавцов вредоносного ПО;
DDOS service это монеты, участвовавшие в оплате или предоставлении услуг DDOS;
Phishing service это монеты, участвовавшие в оплате или предоставлении услуг фишинга;
Cracked software это монеты, полученные в результате продажи ПО и информационных сервисов с нарушением прав правообладателя (VPN ключи от лицензий, взлом ПО с целью его использования без лицензии);
Scam ICO это монеты, полученные в поддельном ICO;
Illegal financial transactions это монеты, участвовавшие в незаконных финансовых операциях;
Sanctions Иран, Северная Корея, Крым, Венесуэла, Куба и сервисы из этих стран или территорий;
Terrorism это монеты, с помощью которых спонсировали террористическую деятельность;
Сorruption это монеты, с помощью которых производили коррупционную деятельность;
Exchange With Very High ML Risk биржи, которые не требуют идентификации KYC/AML для всех операций, которые проходят через них, очень высокий риск отмывая денег;
P2P Exchange With Very High ML Risk P2P-биржи, которые не требуют идентификации KYC/AML для всех операций, которые проходят через них, очень высокий риск отмывая денег;
OTC Exchange With Very High ML Risk обменники, которые не требуют идентификации KYC/AML для всех операций, которые проходят через них, очень высокий риск отмывая денег;
Hight Risk country серый список FATF и сервисы из этих стран;
Precursors это монеты, использовавшиеся отдельными сферами деятельности в сфере продажи прекурсоров (товаров и веществ, применяемых при создании наркотиков);
China precursors manufacturing это монеты, использовавшиеся производителями прекурсоров из Китая;
Exchange With High ML Risk биржи, которые не требуют идентификации KYC/AML для всех операций, которые проходят через них, высокий риск отмывая денег;
PEP это монеты, использовавшиеся политически значимым лицом;
P2P Exchange With High ML Risk P2P-биржи, которые не требуют идентификации KYC/AML для всех операций, которые проходят через них, высокий риск отмывая денег;
OTC Exchange With High ML Risk обменники, которые не требуют идентификации KYC/AML для всех операций, которые проходят через них, высокий риск отмывая денег;
Paramilitary organization официальные аккаунты военизированных организаций и их участников, реквизиты для донатов;

Ошибки

AlfaBit AML API использует следующие коды ошибок:

Код ошибки Описание
400 Bad Request -- Ваш запрос некорректен
401 Unauthorized -- Ваш API ключ недействителен
403 Forbidden -- Отсутствует доступ для данного эндпоинта
404 Not Found -- Несуществующий запрос
405 Method Not Allowed -- Неверный метод для эндпоинта
429 Too Many Requests -- Слишком много запросов
500 Internal Server Error -- Проблема на стороне сервера. Попробуйте позже
503 Service Unavailable -- Сервер на техническом обслуживании. Попробуйте позже
shell python