Документация API

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

Создайте ключ в разделе «API-ключи» и передавайте его в заголовке x-api-key. Ключ показывается один раз при создании — сохраните его; хранится только его хэш.

Лимит по умолчанию — 600 запросов в минуту на ключ. Каждая проверка списывает 1 кредит; при ошибке провайдера кредит возвращается автоматически.

x-api-key: ab_live_xxxxxxxxxxxxxxxxxxxxxxxx

Поддерживаемые сети

curl "https://amlbridge.io/v1/chains" -H "x-api-key: ab_live_..."

{ "chains": ["BTC","ERC20","TRC20","BEP20","SOL","POL", ...] }   // всего: 24

Создание проверки

Проверка асинхронная — в ответ сразу приходит id со статусом pending, результат готовится в фоне.

Параметры запроса

# Проверка адреса
curl -X POST "https://amlbridge.io/v1/checks" \
  -H "x-api-key: ab_live_..." -H "content-type: application/json" \
  -d '{"kind":"address","chain":"ERC20","address":"0xabc...def"}'

# Проверка транзакции
curl -X POST "https://amlbridge.io/v1/checks" \
  -H "x-api-key: ab_live_..." -H "content-type: application/json" \
  -d '{"kind":"tx","chain":"ERC20","address":"0xreceiver...","txId":"0xdeadbeef..."}'

# С вебхуком
curl -X POST "https://amlbridge.io/v1/checks" \
  -H "x-api-key: ab_live_..." -H "content-type: application/json" \
  -d '{"kind":"address","chain":"BTC","address":"bc1q...","webhookUrl":"https://example.com/hook"}'

# 202 Accepted
{ "id": "5f0c...", "status": "pending", "chain": "ERC20", "address": "0xabc...def" }

Жизненный цикл

Опрашивайте GET /v1/checks/{id}, пока status не станет финальным, либо укажите webhookUrl и получите результат push-уведомлением.

Получение результата

Список /v1/checks поддерживает page, limit, status и target (поиск по адресу/хэшу) и возвращает только проверки этого ключа.

curl "https://amlbridge.io/v1/checks/<id>" -H "x-api-key: ab_live_..."

{
  "id": "5f0c...",
  "kind": "address",
  "chain": "ERC20",
  "address": "0xabc...def",
  "status": "dirty",
  "riskScore": 0.68,
  "signals": { "stolen_coins": 0.47, "risky_exchange": 0.14, "exchange": 0.13 },
  "createdAt": "2026-07-13T11:45:40.000Z",
  "finishedAt": "2026-07-13T11:46:50.000Z"
}

# Список (только проверки этого ключа) и баланс
curl "https://amlbridge.io/v1/checks?page=1&limit=20&status=dirty&target=0xabc" -H "x-api-key: ab_live_..."
curl "https://amlbridge.io/v1/balance" -H "x-api-key: ab_live_..."

Оценка риска (Risk Score)

riskScore (0–1) — вероятность связи адреса с нелегальной активностью. Считается по долям источников средств, взвешенным по их опасности: danger-источники дают наибольший вклад, а «тяжёлые» (mixer, dark market, stolen coins, sanctions и т.п.) поднимают оценку даже при малой доле.

Уровни риска

Вебхуки

При завершении проверки на webhookUrl отправляется POST с JSON результата. Подпись — заголовок X-AmlBridge-Signature (HMAC-SHA256 тела запроса, секрет из настроек). Не-2xx ответ ретраится 8 раз с экспоненциальной паузой.

POST https://example.com/hook
X-AmlBridge-Signature: <hmac-sha256>
content-type: application/json

{ "id": "5f0c...", "status": "dirty", "riskScore": 0.68, "signals": { ... } }