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

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

Данный запрос может выполняться несколько секунд. Не рекомендуется ставить 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 - критический риск

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

POSThttps://ocp.onchainpay.io/api-gateway/kyt/check-transfer

Header parameters

Body

application/json

tx*string

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

Example: "0x00E2453..."

currency*string

Монета

Example: "USDT"

networksstring

Сеть

Example: "ethereum"

outputAddress*string

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

Example: "0x023434a..."

direction*enum

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

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

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

Example: "sent"

sentreceived

Response

200

Body

application/json

success*boolean

Признак успешности запроса

response*CheckTransferResponse (object)

Тело ответа проверки на риски

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/kyt/check-transfer', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tx": "0x00E2453...",
      "currency": "USDT",
      "outputAddress": "0x023434a...",
      "direction": "sent"
    }),
});
const data = await response.json();

Response

200

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