Check withdrawal risks

The method allows you to check the risks of withdrawal before making it.

This request can be executed for several seconds. It is not recommended to set timeout less than 15 seconds.

Request:

Parameter	Required	Type	Description
currency	Yes	String	Currency
network	Yes	String	Network
address	Yes	String	Recipient address of coins
amount	Yes	String	Withdrawal amount

Request:

Parameter	Required	Type	Description
tx	Yes	String	Transaction hash
currency	Yes	String	Currency
network	Yes	String	Network
outputAddress	Yes	String	Recipient address of coins
direction	Yes	String	The side to check the risks. Takes the value sent or received. The sent value should be passed if a withdrawal transaction was made from your address. Then the risks of the completed transaction from the side of the sender will be checked The received value should be passed if a deposit was made to your address. Then the risks of receiving coins to your address will be checked

Response:

Parameter	Type	Description
level	String	Risk level
categories	String	Array with risk categorization
categories.level	String	Risk level in this category
categories.usdAmount	Number	The amount in USD that is associated with this risk category
categories.category	String or null	Category name
categories.service	String or null	A service that is associated with this risk category
categories.exposure	String	DIRECT - direct connection ("dirty" coins were sent from the attacker's address to the recipient's address directly) INDIRECT - indirect connection (the coins were marked risky, but passed through a chain of addresses)

The level parameter can take the following values:

• white - no risk

• green - low risk

• yellow - medium risk

• red - high risk

• black - severe risk

Check withdrawal risks

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

The body of the request to verify the address for output

currencystringOptional

Coin

Example: USDT

networkstringOptional

Network

Example: ethereum

addressstringOptional

Address-recipient of coins

Example: 0x0feae54...

amountstringOptional

Withdrawal amount

Example: 300

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

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

{
  "currency": "USDT",
  "network": "ethereum",
  "address": "0x0feae54...",
  "amount": "300"
}

200Success

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