🆕 Adding a new quick check

PUT /api/fast-check

Queues an address for checking and immediately returns the check record with status 0. The result is fetched with a separate request — see Check lifecycle and statuses.

Body parameter

address: TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA
currency: usdt
network: trx

🛠️ Parameters

Case does not matter: currency and network are lowercased, spaces are stripped from the address, ETH addresses are normalised to lowercase.

♻️ Calling it again for the same address

The method is idempotent for the user + address + currency + network tuple:

• if you already have a check for that address, the same record is returned: the same id and uuid, status reset to 0, and the job queued again;
• a new record is created only when the address, the currency or the network differs.

You can store the id on your side and keep using it: PUT /api/fast-check for the same address and GET /api/fast-check/{id}/run do exactly the same thing — re-run the check and charge for it.

💳 Pricing

Every call charges the price of one quick check (the price field in the response; 1 by default, or the price of your tariff plan). If the balance is not sufficient, the check is neither created nor queued and 402 is returned.

Example request

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 — repeated check of a known address (data from the previous run)

{
  "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
}

For an address checked for the first time, risk, analysis, info and labels come back empty ([]) and are filled once status becomes 2.

402 Response

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

🔁 Responses

📋 Response Schema

Status Code 200