Проверка рисков транзакции

Метод позволяет проверить риски совершенной транзакции.

Данный запрос может выполняться несколько секунд. Не рекомендуется ставить timeout меньше 15 секунд.

Запрос:

Параметр	Обязателен	Тип	Описание
tx	Да	Строка	Хеш транзакции
currency	Да	Строка	Монета
network	Да	Строка	Сеть
outputAddress	Да	Строка	Адрес-получатель монет
direction	Да	Строка	Сторона для проверки рисков. Принимает значение sent или received. Значение sent следует передавать, если была совершена транзакция вывода с вашего адреса: тогда будут проверены риски совершенной транзакции со стороны отправителя Значение received следует передавать, если был совершен депозит на ваш адрес: тогда будут проверены риски получения монет на ваш адрес

Ответ:

Параметр	Тип	Описание
level	Строка	Уровень риска
categories	Строка	Массив с разбиением риска по категориям
categories.level	Строка	Уровень риска в этой категории
categories.usdAmount	Число	Сумма в USD, которая связана с этой категорией риска
categories.category	Строка или null	Название категории
categories.service	Строка или null	Сервис, который связан с данной категорией риска
categories.exposure	Строка	DIRECT - прямая связь ("грязные" монеты были отправлены с адреса злоумышленника на адрес получателя напрямую) INDIRECT - косвенная связь (полученные монеты когда-то были помечены рискованными, но прошли через цепочку адресов)

Параметр level может принимать следующие значения:

• white - нет риска

• green - минимальный риск

• yellow - средний риск

• red - высокий риск

• black - критический риск

Проверка рисков транзакции

post

Header parameters

x-api-public-keystringOptional

Публичный API-ключ

x-api-signaturestringOptional

Подпись тела запроса приватным API-ключем

Content-typestringOptional

Тип тела запроса

Example: application/json

Body

Тело запроса для проверки транзакции на риски

txstringRequired

Хеш транзакции

Example: 0x00E2453...

currencystringRequired

Монета

Example: USDT

networksstringOptional

Сеть

Example: ethereum

outputAddressstringRequired

Адрес-получатель монет

Example: 0x023434a...

directionstring · enumRequired

Сторона для проверки рисков. Принимает значение sent или received.

Значение sent следует передавать, если была совершена транзакция вывода с вашего адреса: тогда будут проверены риски совершенной транзакции со стороны отправителя

Значение received следует передавать, если был совершен депозит на ваш адрес: тогда будут проверены риски получения монет на ваш адрес

Example: sentPossible values:

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/kyt/check-transfer HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "tx": "0x00E2453...",
  "currency": "USDT",
  "networks": "ethereum",
  "outputAddress": "0x023434a...",
  "direction": "sent"
}

200Success

{
  "success": true,
  "response": {
    "level": "yellow",
    "categories": [
      {
        "level": "yellow",
        "usdAmount": 1,
        "category": "stolen funds",
        "service": "Reported as stolen funds bc1qlf4vel",
        "exposure": "DIRECT"
      }
    ]
  }
}