API для проверки кошельков: Ончейн-риски за $0.02 (BYOK) (RU)

Проверка KYC показывает, что владелец кошелька — реальный человек. Но она ничего не говорит о том, где были монеты в этом кошельке. В ончейне кошелек, который выглядит обычным, может находиться в одном шаге от санкционированного адреса, в двух шагах от даркнет-рынка или только что выйти из миксера. Проверка кошелька — Know Your Transaction (KYT) — это слой, который считывает эту историю, прежде чем вы позволите переместить средства.

API для проверки кошельков от Didit оценивает любой адрес криптокошелька или хэш транзакции на основе ончейн-аналитики рисков. Вы отправляете адрес, а в ответ получаете оценку риска от 0 до 100, категорию LOW/MEDIUM/HIGH/CRITICAL и детализацию категорий риска, которым подвержены средства — санкции, миксеры, даркнет-рынки, программы-вымогатели, украденные средства и многое другое. Это стоит $0.02 за проверку с использованием собственного ключа (BYOK), что примерно в 10 раз дешевле, чем прямая покупка подписки на блокчейн-аналитику.

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

Ключевые выводы

• Один вызов, ончейн-риск. Отправьте адрес кошелька (до перевода) или хэш транзакции (после перевода) и получите вердикт о риске.
• Оценка риска от 0 до 100, разделенная на четыре категории — LOW / MEDIUM / HIGH / CRITICAL — так что политика представляет собой единый порог, а не исследовательский проект.
• 14+ категорий источников средств — SANCTIONED, TERRORIST_FINANCING, RANSOMWARE, DARKNET_MARKET, MIXER, STOLEN_FUNDS, SCAM и другие — каждая показана по типу подверженности.
• Таблица подверженности + сетевой граф — прямая и косвенная (многошаговая) подверженность, чтобы вы видели не только контрагента, но и откуда поступили его средства.
• BYOK по $0.02 за проверку. Используйте свой ключ Crystal или Merkle Science; Chainalysis и Elliptic скоро появятся. Также доступно управляемое ценообразование.
• Встроенный в мониторинг транзакций — криптотранзакции могут автоматически запускать проверку кошельков без дополнительных настроек.

Что делает проверка кошельков

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

API для проверки кошельков Didit основан на этих данных. Передайте ему адрес кошелька, и он проанализирует подверженность адреса: какая часть входящей и исходящей стоимости связана с рискованными сущностями, напрямую или через промежуточные шаги. Он возвращает единую оценку риска, категорию, в которую попадает эта оценка, и категории, определяющие риск — так что политика соответствия может быть выражена как «блокировать CRITICAL, проверять HIGH, пропускать остальные».

Почему это важно

Для любого бизнеса, связанного с криптовалютой — биржи, фиатного шлюза, кастодиана, кошелька, VASP — принятие средств означает принятие их истории. Санкционная подверженность является самым острым моментом: перемещение стоимости на кошелек из санкционного списка или с него является нарушением независимо от намерений. Но практический риск шире. Средства, отмытые через миксер, доходы от платежа вымогателям или монеты, украденные в результате эксплойта, все это проявляется как ончейн-подверженность задолго до того, как появится где-либо еще.

Классическая проблема — стоимость. Платформы блокчейн-аналитики продаются как корпоративные подписки с пяти- и шестизначными ежегодными минимумами — реальный барьер для команды, которой просто нужно проверять кошельки в момент пополнения. Didit устраняет этот барьер с помощью BYOK: вы используете свой ключ провайдера, платите $0.02 за проверку через унифицированный API Didit и полностью пропускаете лицензии на рабочие места.

Технические детали

Проверка кошельков выполняется внутри системы мониторинга транзакций в унифицированном API /v3/. Когда вы отправляете криптотранзакцию, движок может автоматически проверять контрагента; вы также можете явно проверить, установив currency_kind: "crypto" с направлением.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_5b21fa",
    "category": "finance",
    "amount": 12500,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x9f1c...e3a2",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_7781", "role": "RECEIVER" }
  }'

Ответ содержит вердикт проверки — числовую оценку, категорию и детализацию подверженности:

{
  "transaction_id": "txn_5b21fa",
  "status": "IN_REVIEW",
  "wallet_screening": {
    "risk_score": 78,
    "risk_band": "HIGH",
    "provider": "crystal",
    "exposure": [
      { "category": "MIXER", "type": "INDIRECT", "hops": 2, "share": 0.34 },
      { "category": "DARKNET_MARKET", "type": "INDIRECT", "hops": 3, "share": 0.11 }
    ]
  }
}

Оценка риска и категории. Каждая проверка возвращает оценку от 0 до 100, разделенную на четыре категории:

Категория	Оценка	Типичная политика
LOW	0–24	Пропустить
MEDIUM	25–49	Пропустить с логированием / мягким обзором
HIGH	50–79	Задержать для анализа аналитиком
CRITICAL	80–100	Отклонить / заморозить

Категории источников средств. Подверженность приписывается конкретным категориям — SANCTIONED, TERRORIST_FINANCING, CHILD_EXPLOITATION, RANSOMWARE, STOLEN_FUNDS, DARKNET_MARKET, MIXER, SCAM, HIGH_RISK_EXCHANGE, HIGH_RISK_JURISDICTION, GAMBLING_UNLICENSED, P2P_EXCHANGE, EXCHANGE и UNNAMED_SERVICE — так что вы видите причину оценки, а не просто число.

Тип подверженности и сетевой граф. Каждая категория сообщается как прямая (кошелек совершал транзакции с рискованной сущностью) или косвенная (стоимость достигла ее через промежуточные шаги), с указанием количества шагов. Сетевой граф отслеживает путь, чтобы аналитик мог видеть, как средства связаны.

Цена. $0.02 за проверку с BYOK (Crystal или Merkle Science). Управляемое ценообразование — когда Didit предоставляет данные — составляет $0.18 за проверку с Crystal и $0.15 с Merkle Science.

Проверка до и после перевода

Проверка кошельков работает в двух точках потока. Проверка до перевода принимает адрес кошелька и оценивает его риск до того, как вы примете депозит или выпустите вывод — решение принимается до перемещения стоимости. Проверка после перевода принимает хэш транзакции (передается как payment_reference_id) и оценивает совершенную транзакцию постфактум, для ведения учета и постоянного обзора. Большинство команд используют оба: до перевода для контроля потока, после перевода для ведения аудиторского следа.

Варианты использования

• Криптовалютные биржи — проверяйте каждый адрес пополнения при вводе и каждый адрес вывода при выводе; автоматически отклоняйте CRITICAL, направляйте HIGH аналитику.
• Фиатные шлюзы — контролируйте конвертации фиат-крипто и крипто-фиат на основе подверженности кошелька контрагента до расчета.
• Кастодианы — проверяйте кошельки при поступлении и повторно проверяйте при движении, используя сетевой граф в качестве доказательства для любого замороженного актива.
• Кошельки — защищайте пользователей, предупреждая или блокируя переводы на адреса с высокой подверженностью санкциям или мошенничеству.
• VASP — комбинируйте проверку кошельков с обменом данными FATF Travel Rule, чтобы риск контрагента и источника оценивались совместно.

Как интегрироваться с Didit

1. Установите провайдера и настройки по умолчанию. В Business Console в разделе Transactions → Settings выберите Crystal или Merkle Science, добавьте свой ключ BYOK и установите, будут ли криптотранзакции проверяться по умолчанию.
2. Отправляйте криптотранзакции. POST /v3/transactions/ с currency_kind: "crypto" и направлением. Используйте include_crypto_screening для переопределения значения по умолчанию для каждого вызова.
3. Прочитайте вердикт. Действуйте на основе risk_band и детализации подверженности — пропускайте LOW/MEDIUM, задерживайте HIGH, отклоняйте CRITICAL.
4. Работайте с оповещениями в Console. Проверка с высоким риском открывает оповещение с прикрепленным сетевым графом, готовым для расследования и подачи SAR.

Поскольку все находится в унифицированном API /v3/, проверка кошельков, мониторинг транзакций, KYC и AML объединяются в единую платформу для идентификации и борьбы с мошенничеством — помеченный кошелек может автоматически приостановить транзакцию и запустить шаг по устранению.

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

Сколько стоит проверка кошелька?

$0.02 за проверку с подключением собственного ключа (Crystal или Merkle Science) — примерно в 10 раз дешевле, чем прямая покупка подписки на блокчейн-аналитику. Управляемое ценообразование составляет $0.18 (Crystal) или $0.15 (Merkle Science) за проверку.

Какие провайдеры блокчейн-аналитики поддерживаются?

Crystal и Merkle Science сегодня, через BYOK или управляемый сервис. Chainalysis и Elliptic скоро появятся, также по $0.02 BYOK.

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

Оценка — это число от 0 до 100; категория (LOW/MEDIUM/HIGH/CRITICAL) — это группа, в которую оно попадает, так что вы можете писать политику на основе метки, вместо того чтобы самостоятельно настраивать числовые пороги.

Могу ли я проверить кошелек, не отправляя деньги?

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

Охватывает ли это косвенную подверженность, а не только прямого контрагента?

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

Готовы начать?

Прочитайте обзор проверки кошельков в документации, посмотрите, как это вписывается в платформу на странице продукта проверки кошельков, и проверьте прозрачные цены за вызов на странице цен. Когда будете готовы, начните бесплатно — 500 бесплатных проверок KYC каждый месяц и проверка кошельков по $0.02 за проверку с BYOK.