🆕 Создание проверки транзакции
POST /api/v1/tx-checks
Принимает хеш, синхронно подтверждает транзакцию в сети и ставит скоринг сторон в очередь. В ответе — карточка проверки со статусом 0; результат забирается опросом карточки проверки.
Body parameter
{
"hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
"network": "trx"
}
🛠️ Параметры
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| » hash | body | string | true | Хеш транзакции, до 120 символов. Пробелы по краям обрезаются |
| » network | body | string | false | Подсказка сети в нижнем регистре: trx, btc, eth, bsc, polygon, avax, arbitrum, optimism, base, zksync, ton, toncoin, solana, merlin, iotex, ltc, doge, bch, hsk, sui |
network — именно подсказка, а не фильтр: она учитывается, только если сеть оказалась среди подтвердивших хеш. Если не передавать её вовсе, сеть определится сама — см. форматы хеша.
💳 Списание
Сначала подтверждается существование транзакции, и только потом снимается стоимость проверки — за ненайденный хеш деньги не берутся. Цена — поле tx_check_price вашего тарифа, по умолчанию 1.
Пример запроса
curl -X POST 'https://amlkyc.tech/api/v1/tx-checks' \
-H 'Authorization: Bearer <API_TOKEN>' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{"hash":"e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598"}'
Example responses
201 Response
{
"success": true,
"message": "Tx check created.",
"data": {
"id": 128,
"uuid": "0f2d3a51-6f1a-4a2f-9f2f-2a5a0c9d7b41",
"hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
"network": "trx",
"status": 0,
"status_label": "new",
"score": null,
"summary": null,
"results": null,
"error": null,
"created_at": "2026-09-29T09:12:44.000000Z",
"updated_at": "2026-09-29T09:12:44.000000Z"
}
}
Сохраните id — по нему забирается результат и ведётся история проверок этого хеша.
200 Response — проверка этого хеша уже выполняется (списания нет)
{
"success": true,
"message": "Tx check is already running.",
"data": {
"id": 128,
"uuid": "0f2d3a51-6f1a-4a2f-9f2f-2a5a0c9d7b41",
"hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
"network": "trx",
"status": 1,
"status_label": "processing",
"score": null,
"summary": null,
"results": null,
"error": null,
"created_at": "2026-09-29T09:12:44.000000Z",
"updated_at": "2026-09-29T09:12:47.000000Z"
}
}
422 Response — транзакция не найдена
{
"success": false,
"message": "Transaction not found in supported networks.",
"errors": {
"hash": [
"Transaction not found in supported networks."
]
}
}
402 Response
{
"success": false,
"message": "Insufficient balance."
}
🔁 Ответы
| Status | Meaning | Description |
|---|---|---|
| 201 | Created | Проверка создана, скоринг поставлен в очередь, стоимость списана |
| 200 | OK | Дубль: проверка этого хеша уже выполняется, повторного списания нет |
| 401 | Unauthorized | Токен отсутствует или недействителен |
| 402 | Payment Required | Недостаточно баланса, проверка не создана |
| 403 | Forbidden | Проверка транзакций не подключена аккаунту |
| 409 | Conflict | Параллельный запрос с тем же хешем ещё выполняется — повторите через пару секунд |
| 422 | Unprocessable Entity | Значение не похоже на хеш транзакции либо транзакция не найдена в поддерживаемых сетях |
| 503 | Service Unavailable | Источники подтверждения временно недоступны — списания нет, повторите позже |