Get Risk Score

Get Risk Score #

https://openapi.zk.me/kyt/v1/risk/score
   ?coin=ETH
   &address={address}
   &txid={txn hash}
   &api_key=YourApiKey

Parameters: #

Name Type Description
coin string The coin to check for risk score, all optional values can be found here
address string The address to check for risk score, one of address and txid must be passed.
txid string The address to check for risk score, one of address and txid must be passed. If you are unsure of its value, please ignore it directly and do not pass any non-existent or fictional values.
api_key string Your API key

Sample response: #

{
  "code": 200,
  "message": "success",
  "data": {
    "score": 3,
    "hacking_event": "",
    "detail_list": [
      "Interact With Malicious Address",
      "Interact With High-risk Tag Address",
      "Interact With Medium-risk Tag Addresses"
    ],
    "risk_level": "Low",
    "risk_detail": [
      {
        "label": "Tornado.Cash: Router",
        "type": "high_risk",
        "volume": 1338984,
        "address": "0xd90e2f925da726b50c4ed8d0fb90ad053324f31b",
        "percent": 0.453
      },
      {
        "label": "Tornado.Cash: L1 Helper",
        "type": "high_risk",
        "volume": 1859.7,
        "address": "0xca0840578f57fe71599d29375e16783424023357",
        "percent": 0.001
      },
      {
        "label": "Tornado.Cash: Proxy",
        "type": "high_risk",
        "volume": 1487760,
        "address": "0x722122df12d4e14e13ac3b6895a86e84145b6967",
        "percent": 0.503
      },
      {
        "label": "Tornado.Cash: 10 ETH",
        "type": "high_risk",
        "volume": 167204.511,
        "address": "0x910cbd523d972eb0a6f4cae4618ad62622b39dbf",
        "percent": 0.057
      },
      {
        "label": "HitBTC",
        "type": "medium_risk",
        "volume": 76090.41,
        "address": "0x9c67e141c0472115aa1b98bd0088418be68fd249",
        "percent": 0.026
      }
    ]
  }
}

Fields: #

Name Type Description
score int Risk Score for the query address, range: 3 ~ 100
hacking_event string Related security event/incident name for the query address
detail_list string[] Risk description for the query address
risk_level string Risk level, Low / Moderate / High / Severe
risk_detail object[] Data for the risk score calculation process

Risk Descriptions For detail_list #

Risk Item Risk Item
Malicious Address Address directly involved in malicious events, Example: DeFi protocol exploiters, centralized exchange hackers, sanctioned addresses, etc.
Suspected Malicious Address Address associated with malicious events
High-risk Tag Address High-risk entity address, Example: Mixers, some nested exchanges, etc.
Medium-risk Tag Address High-risk entity address, Example: Mixers, some nested exchanges, etc.
Mixer Mixer entity address, Example: Tornado Cash, etc.
Risk Exchange Exchanges that do not require KYC
Gambling Gambling entity address
Involved Theft Activity Address involved in theft events
Involved Ransom Activity Address involved in ransom events
Involved Phishing Activity Address involved in phishing events
Interact With Malicious Address Interactions with malicious address
Interact With Suspected Malicious Address Interactions with suspected malicious address
Interact With High-risk Tag Address Interactions with high-risk address
Interact With Medium-risk Tag Addresses Interactions with medium-risk address

Risk Level Guide #

Risk Level Risk Score Suggested Operations
Severe 91 ~ 100 Prohit withdrawals & trade, and report address immediately
High 71 ~ 90 Maintain high level surveillance, and analyze via zkMe KYT AML platform or kytopenapi to conduct transaction analysis
Moderate 31 ~ 70 Moderate supervision required
Low 0 ~ 30 Minimal supervision required