🆕 Добавление новой быстрой проверки

PUT /api/fast-check

Ставит адрес в очередь на проверку и сразу возвращает карточку проверки со статусом 0. Результат забирается отдельным запросом — см. Жизненный цикл проверки и статусы.

Body parameter

address: TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA
currency: usdt
network: trx

🛠️ Параметры

Регистр не важен: currency и network приводятся к нижнему регистру, пробелы из адреса удаляются, адреса ETH нормализуются в нижний регистр.

♻️ Повторный вызов для того же адреса

Метод идемпотентен по тройке пользователь + адрес + валюта + сеть:

• если проверка такого адреса у вас уже есть — возвращается та же запись: прежние id и uuid, статус сбрасывается в 0, задача снова ставится в очередь;
• новая запись создаётся только если отличается адрес, валюта или сеть.

id можно сохранить у себя и дальше пользоваться им: PUT /api/fast-check для того же адреса и GET /api/fast-check/{id}/run делают одно и то же — перезапускают проверку и списывают стоимость.

💳 Тарификация

Каждый вызов списывает стоимость одной быстрой проверки (поле price в ответе; по умолчанию — 1, либо цена вашего тарифного плана). Если баланса не хватает, проверка не создаётся и не ставится в очередь — возвращается 402.

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

curl -X PUT 'https://amlkyc.tech/api/fast-check' \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Accept: application/json' \
  -d 'address=TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA' \
  -d 'currency=usdt' \
  -d 'network=trx'

Example responses

200 Response — повторная проверка уже известного адреса (данные от предыдущего прогона)

{
  "id": 1234,
  "user_id": 42,
  "crypto_address_id": 777,
  "uuid": "a3edde0e-7939-40a4-ba74-ec097802a5fb",
  "risk": {
    "score": 100,
    "risk_detail": [
      {
        "label": "phishing",
        "type": "phishing",
        "volume": 0,
        "address": "TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA",
        "percent": 100,
        "risk": null
      }
    ],
    "providers": {
      "f": 100
    }
  },
  "analysis": {},
  "info": {
    "balance": "0",
    "tx_count": "3",
    "first_tx_time": "23.07.2025 12:38",
    "last_tx_time": "23.07.2025 13:26"
  },
  "labels": [],
  "status": 0,
  "new": false,
  "tracking": false,
  "created_at": "2026-09-11T10:14:45.000000Z",
  "updated_at": "2026-09-11T10:14:45.000000Z",
  "price": 1,
  "balance": 743.57828338
}

Для адреса, который проверяется впервые, поля risk, analysis, info и labels приходят пустыми ([]) — они заполнятся после того, как status станет 2.

402 Response

{
  "status": false,
  "message": "Недостаточно баланса"
}

🔁 Ответы

📋 Response Schema

Status Code 200