kya/risk

kya/risk 端点用于对指定区块链地址进行风险评估。它会结合地址的历史行为与关联标签，在给定链上计算其整体风险级别。

请求

• HTTP 方法：GET
• 端点路径：/kya/risk
• Query 参数：

参数	类型	必填	说明	示例
chain	String	是	目标区块链名称（必须是支持的链，见支持的链页面）	eth、btc、bsc、multi-chain
address	String	是	有效的区块链地址	0x1234567890abcdef1234567890abcdef12345678

响应

字段	类型	出现条件	说明
chain	String	始终返回	区块链网络标识（例如 eth、btc）。
address	String	始终返回	被查询的钱包地址。
risk_level	String	始终返回	风险等级分类（例如 High、Medium、Low）。
risk_score	Integer	始终返回	地址对应的数值风险评分。
risk_reasons	Array[String]	始终返回（无结果时返回 []）	对主要风险触发原因的简要说明。
risk_factors	Object	始终返回（无结果时返回 {}）	结构化风险分类详情（例如 Hack、Scam、Darknet）。
-origin	String	在 risk_factors 中始终返回	风险来源（例如 self）。
-sub_origin	String	在 risk_factors 中始终返回	风险来源维度（例如基于标签或实体）。
-category	String	在 risk_factors 中始终返回	高层分类（例如 Cefi、Dapp、Infra）。
-level	String	在 risk_factors 中始终返回	该具体风险因子的严重等级。
entities	Array[Object]	条件返回（识别到实体时）	与该地址关联的组织资料。
-entity_id	String	在 entities 中始终返回	识别出的实体唯一 ID。
-entity_name	Object	在 entities 中始终返回	实体多语言名称（包含 en 和 zh）。
-country	Object	在 entities 中始终返回	实体注册地或运营地区。
-description	Object	在 entities 中始终返回	实体详细背景和财务指标。
-link	String	在 entities 中始终返回	实体官网主链接。
-other_link	String	在 entities 中始终返回	以逗号分隔的其他外部链接（社媒、社区等）。
labels	Array[Object]	始终返回（无结果时返回 []）	地址对应的行为标签与分类集合。
-chain	String	在 labels 中始终返回	标签所属链标识（例如 evm、tron）。
-address	String	在 labels 中始终返回	标签关联的地址。
-category	String	在 labels 中始终返回	高层分类（例如 Cefi、Dapp、Infra）。
-sub_category	String	在 labels 中始终返回	更细粒度的分类（例如 CEX、DEX）。
-label	String	在 labels 中始终返回	具体标签名称（例如 Binance Deposit Wallet）。

示例代码

请求

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

响应

{
  "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": ""
      }
    ]
  }
}

在线调试