Skip to content

kya/risk

Summary

The kya/risk endpoint offers a risk assessment for a specific blockchain address. It analyzes the address’s historical activity and associated labels to determine its overall risk level on a given chain.

Request

HTTP Method: GET
Endpoint Path: /kya/risk
Query Parameters:

Parameter	Type	Required	Description	Example
`chain`	String	Yes	Name of the target blockchain (must be a supported chain; see Supported Chains)	`eth`, `btc`, `bsc`, `multi-chain`
`address`	String	Yes	Valid blockchain address	`0x1234567890abcdef1234567890abcdef12345678`

Response

Field	Type	Presence	Description
`chain`	String	Always	The blockchain network identifier (e.g., `eth`, `btc`).
`address`	String	Always	The blockchain wallet address being queried.
`risk_level`	String	Always	The categorized risk level (e.g., `High`, `Medium`, `Low`).
`risk_score`	Integer	Always	The numerical risk score assigned to the address.
`risk_reasons`	Array[String]	Always (Returns `[]` if none)	A list of brief descriptions explaining the primary risk triggers.
`risk_factors`	Object	Always (Returns `{}` if none)	Structured risk categorization details (e.g., `Hack`, `Scam`, `Darknet`).
`-origin`	String	Always (within `risk_factors`)	The source of the risk (e.g., `self`).
`-sub_origin`	String	Always (within `risk_factors`)	Specifies the risk source dimension (label or entity).
`-category`	String	Always (within `risk_factors`)	High-level grouping (e.g., `Cefi`, `Dapp`, `Infra`).
`-level`	String	Always (within `risk_factors`)	Severity level of the specific risk factor.
`entities`	Array[Object]	Conditional (Present if identified)	Profile details of organizations associated with the address.
`-entity_id`	String	Always (within `entities`)	Unique identifier for the identified entity.
`-entity_name`	Object	Always (within `entities`)	Multilingual names of the entity (includes `en` and `zh`).
`-country`	Object	Always (within `entities`)	The country/region where the entity is registered or operates.
`-description`	Object	Always (within `entities`)	Detailed background and financial metrics of the entity.
`-link`	String	Always (within `entities`)	Primary official website URL of the entity.
`-other_link`	String	Always (within `entities`)	Comma-separated external links (social media, community, etc.).
`labels`	Array[Object]	Always (Returns `[]` if none)	A collection of behavior-based tags and classifications for the address.
`-chain`	String	Always (within `labels`)	Chain identifier for the label (e.g., `evm`, `tron`).
`-address`	String	Always (within `labels`)	Address associated with the label.
`-category`	String	Always (within `labels`)	High-level grouping (e.g., `Cefi`, `Dapp`, `Infra`).
`-sub_category`	String	Always (within `labels`)	Granular classification providing context (e.g., `CEX`, `DEX`).
`-label`	String	Always (within `labels`)	The specific descriptive name of the tag (e.g., `Binance Deposit Wallet`).

Example Code

Request

curl -X GET "https://api.compliance.certik.com/v4/kya/risk?chain=tron&address=TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "tron",
    "address": "TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR",
    "risk_level": "High",
    "risk_score": 5,
    "risk_reasons": [
      "label: Blocked/USDT Frozen Address",
      "label: Sanctioned/"
    ],
    "risk_factors": {
      "Blocked": [
        {
          "origin": "self",
          "sub_origin": "label",
          "category": "Blocked",
          "level": "High"
        }
      ],
      "Sanctioned": [
        {
          "origin": "self",
          "sub_origin": "label",
          "category": "Sanctioned",
          "level": "High"
        }
      ]
    },
    "entities": [
      {
        "entity_id": "okx",
        "entity_name": {
          "en": "OKX",
          "zh": ""
        },
        "country": {
          "en": "Seychelles",
          "zh": ""
        },
        "description": {
          "en": "OKX is a centralized cryptocurrency exchange established in 2017 and is registered in Seychelles. Currently, there are 295 coins and 674 trading pairs available on the exchange. OKX 24h volume is reported to be at $3,004,658,390.58, a change of 20.14% in the last 24 hours. OKX has $27,698,590,265.24 in Exchange Reserves. The most active trading pair is ETH/USDT with a 24h volume of $838,294,809.05.",
          "zh": ""
        },
        "link": "https://www.okx.com/join/1902090",
        "other_link": "https://www.facebook.com/OKXofficial/,https://twitter.com/OKX,https://www.reddit.com/r/OKX/,https://t.me/OKXOfficial_English,https://www.youtube.com/@OKXExchange,https://www.linkedin.com/company/okxofficial/"
      },
      {
        "entity_id": "mr_xingbiao_shen",
        "entity_name": {
          "en": "Mr Xingbiao Shen",
          "zh": ""
        },
        "country": {
          "en": "cn",
          "zh": ""
        },
        "description": {
          "en": "Person",
          "zh": ""
        },
        "link": "",
        "other_link": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=45312,https://home.treasury.gov/news/press-releases/jy1779"
      }
    ],
    "labels": [
      {
        "chain": "tron",
        "address": "TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR",
        "category": "Blocked",
        "sub_category": "Frozen",
        "label": "USDT Frozen Address"
      },
      {
        "chain": "tron",
        "address": "TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR",
        "category": "Cefi",
        "sub_category": "CEX",
        "label": "OKX Deposit Wallet"
      },
      {
        "chain": "tron",
        "address": "TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR",
        "category": "Sanction",
        "sub_category": "OFAC",
        "label": ""
      }
    ]
  }
}

Try It