Skip to main content
POST
/
v1
/
public
/
aml
/
checks
Запустить AML-скрин адреса или транзакции
curl --request POST \
  --url https://api.example.com/v1/public/aml/checks \
  --header 'Content-Type: application/json' \
  --header 'X-Signature: <api-key>' \
  --data '
{
  "network": "TRON",
  "address": "TXYZ...abcd",
  "assetCode": "USDT_TRC20",
  "txHash": "0xabc…"
}
'
{
  "uuid": "0f1c…",
  "status": "success",
  "network": "TRON",
  "assetCode": "USDT_TRC20",
  "address": "TXYZ...abcd",
  "txHash": null,
  "checkMethod": "address",
  "riskScore": "12.50",
  "riskLevel": "low",
  "topSignal": "exchange",
  "signals": {
    "exchange": 0.8,
    "gambling": 0.1
  },
  "reportUrl": "<string>",
  "shareUrl": "<string>",
  "reason": "<string>",
  "createdAt": "2026-06-18T12:00:00.000Z",
  "completedAt": "2026-06-18T12:00:03.000Z"
}

Authorizations

​
X-Signature
string
header
required

HMAC-SHA256-Hex(timestamp + "." + raw_body, api_secret)

Body

application/json
​
network
enum<string>
required

Сеть адреса/транзакции.

Available options:
TRON,
TON,
ETHEREUM,
BSC,
POLYGON,
BITCOIN,
LITECOIN,
XRP,
SOLANA
Example:

"TRON"

​
address
string
required

Адрес для скрина (обязателен для method=address/both).

Example:

"TXYZ...abcd"

​
assetCode
string

Код актива (как в /v1/public/aml/currencies или /v1/public/assets). Если не указан — берётся нативная валюта сети. Влияет на token-скрин (контракт токена).

Example:

"USDT_TRC20"

​
txHash
string

Хэш транзакции (для method=transaction/both).

Example:

"0xabc…"

​
checkMethod
enum<string>

Метод: address (по умолчанию), transaction или both. По умолчанию — transaction если задан txHash, иначе address.

Available options:
address,
transaction,
both

Response

201 - application/json

Проверка создана (pending или готовый результат).

​
uuid
string<uuid>
required

ID проверки. Опрашивайте GET /v1/public/aml/checks/{uuid}.

Example:

"0f1c…"

​
status
enum<string>
required

Жизненный цикл проверки: pending → success | failed | error | skipped.

Available options:
pending,
success,
failed,
error,
skipped
Example:

"success"

​
network
enum<string>
required
Available options:
TRON,
TON,
ETHEREUM,
BSC,
POLYGON,
BITCOIN,
LITECOIN,
XRP,
SOLANA
Example:

"TRON"

​
assetCode
string
required
Example:

"USDT_TRC20"

​
address
string
required
Example:

"TXYZ...abcd"

​
txHash
string | null
required
Example:

null

​
checkMethod
enum<string>
required
Available options:
address,
transaction,
both
Example:

"address"

​
riskScore
string | null
required

Риск-скор 0–100 (string). null если не success.

Example:

"12.50"

​
riskLevel
enum<string> | null
required

low<50, medium 50–79, high ≥80, severe — санкции/терроризм/кража и т.п.

Available options:
low,
medium,
high,
severe
Example:

"low"

​
topSignal
string | null
required

Топ-сигнал риска (категория).

Example:

"exchange"

​
signals
object
required

Карта сигналов риска → вес (0–1).

Example:
{ "exchange": 0.8, "gambling": 0.1 }
​
reportUrl
string | null
required

Ссылка на отчёт провайдера (если есть).

​
shareUrl
string | null
required

Публичная share-ссылка отчёта (если есть).

​
reason
string | null
required

Причина для skipped/error/failed (валюта не поддерживается, сбой провайдера и т.п.).

​
createdAt
string<date-time>
required
Example:

"2026-06-18T12:00:00.000Z"

​
completedAt
object
required
Example:

"2026-06-18T12:00:03.000Z"