AML API для проверки криптоадресов и транзакций
AMLKYC API позволяет встроить проверку криптокошельков и транзакций в биржу, обменник, криптопроцессинг или внутреннюю комплаенс-систему. Запрос возвращает риск-скор, категории источников средств и признаки связи адреса с санкциями, мошенничеством, миксерами и другими высокорисковыми сервисами.
Что можно автоматизировать через AML API
- проверку адреса перед приёмом или выводом криптовалюты;
- анализ транзакции по хэшу;
- KYT-мониторинг входящих и исходящих переводов;
- формирование отчёта для комплаенс-команды;
- применение собственных порогов риска.
Поддерживаемые сценарии
API подходит для разовой проверки и пакетной обработки. Перед промышленным подключением протестируйте обработку ошибок, лимиты запросов и правила, по которым операция отправляется на ручную проверку. Технические методы, авторизация и примеры ответов приведены в документации.
Порядок вызовов
Быстрая проверка адреса состоит из трёх обращений: адрес ставится в очередь, проверка запускается, результат забирается по тому же идентификатору. Разделение на шаги нужно затем, что анализ идёт не мгновенно: запрос на запуск возвращается сразу, а готовый ответ приходит отдельным вызовом.
| Шаг | Вызов | Что происходит |
|---|---|---|
| Поставить адрес | PUT /api/fast-check | Адрес принимается в работу, в ответе — его код |
| Запустить проверку | GET /api/fast-check/{id}/run | Анализ стартует, ответ приходит сразу |
| Забрать результат | GET /api/fast-check/{id} | Оценка риска и разбор по категориям |
| Посмотреть все | GET /api/fast-check | Список ранее выполненных проверок |
Кроме быстрой проверки в API есть справка по адресу — GET /api/crypto/address — и поиск — GET /api/crypto/search. Для разбора цепочек переводов заводится расследование: PUT /api/investigations.
Что приходит в ответе
Результат проверки содержит числовую оценку риска и её расшифровку. Оценка — поле risk.score в диапазоне от 0 до 100. Расшифровка — список категорий в risk_detail, где у каждой есть метка вроде phishing и доля, с которой она встречается в истории адреса.
Оценка описывает адрес, а не человека. Высокий балл означает, что в истории адреса есть поступления из рискованных категорий, и это повод для дополнительной проверки, а не готовое решение отказать.
Какие сети поддержаны
Перечень активов отдаёт сам API, поэтому сверяться лучше с ним, а не со статьёй: список пополняется. На момент публикации в документации перечислено 42 сочетания актива и сети — по семи сетям.
| Сеть | Активы |
|---|---|
| Bitcoin | BTC |
| Ethereum | ETH, USDT, USDC, WETH, WBTC, DAI, BUSD, UNI, ENS, GRT, UST, BNB |
| TRON | USDT, USDC |
| BNB Smart Chain | BNB, WBNB, USDT, USDC, BUSD, ETH, BTCB, DOGE, SHIB, BCH |
| Polygon | MATIC, WMATIC, USDT, USDC, WETH, WBTC, DAI, AAVE, LINK, UNI, SUSHI, UST |
| Avalanche | AVAX, USDT, USDC |
| TON | Toncoin |
Что нужно до интеграции
- Ключ доступа. Выпускается в личном кабинете, отдельной заявки не требует.
- Решение, что делать с результатом: на каком балле операция уходит на ручной разбор, а на каком отклоняется. Порог задаёт бизнес, API его не назначает.
- Место хранения ответов. Оценка риска относится к адресу и со временем меняется, поэтому дату проверки стоит хранить вместе с самим результатом.
- Поведение при недоступности сервиса. Проверка — внешний вызов, и сценарий «ответ не пришёл» нужен до запуска, а не после первого сбоя.
Частые вопросы
AML API работает с криптоадресами и транзакциями: он оценивает происхождение средств. KYC API работает с личностью клиента и его документами. Это разные вопросы — «откуда деньги» и «кто человек», — и одно не заменяет другое.
Запуск и получение результата разделены на два вызова именно потому, что анализ не мгновенный: запрос на запуск возвращается сразу, а за готовым ответом нужно прийти отдельно по коду проверки.
Это число от 0 до 100 в поле risk.score, рядом с которым приходит разбор по категориям с метками вроде phishing. Оценка описывает историю адреса, а не его владельца, и служит поводом для дополнительной проверки, а не готовым решением.
Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon, Avalanche и TON — в документации перечислено 42 сочетания актива и сети. Актуальный список отдаёт сам API, и сверяться стоит с ним.
Ключ выпускается в личном кабинете. Условия использования API описаны отдельным документом на сайте — с него стоит начать, если API встраивается в продукт с внешними пользователями.
Проверьте первые 5 адресов бесплатно
Зарегистрируйтесь и получите 5 бесплатных AML-проверок. Полный отчёт с оценкой риска и источниками средств — за несколько секунд.
Приложение AMLKYC — проверки под рукой
Проверяйте адреса и транзакции с телефона: Telegram-бот, RuStore и App Store.
Остались вопросы? Напишите нам
Заполните форму — и вам обязательно ответят.