接口选型：kya/risk 与 kya/screening_v2

kya/risk 与 kya/screening_v2 都用于评估区块链地址的风险，但两者的评估范围并不相同。本页帮助你理解二者的关系，并在不同场景下选择合适的接口。

一句话结论

• /kya/risk 只回答一个问题：「这个地址本身是否高风险？」——响应快、结构轻，适合大批量、高频的初步排查。
• /kya/screening_v2 在此基础上进一步审查该地址的交易对手，还原资金暴露、路径与交易明细，是能力更全面的合规级筛查接口。

二者不是「轻量版 / 完整版」的简单替代关系：screening_v2 覆盖了 risk 的自身风险判断，并额外提供 risk 无法给出的对手方风险视图。需要出具合规结论时，应以 screening_v2 为准。

两个接口的定位

/kya/risk — 地址自身风险

仅基于与目标地址直接关联的实体（entities）与标签（labels）来计算风险，输出风险等级、风险分数和风险因子（Risk Factors）。它不追溯资金来往的对手方，因此响应通常在毫秒级。

适合回答：「这个地址本身是不是被标记为制裁、黑客、诈骗等高风险对象？」

/kya/screening_v2 — 全面地址筛查

在完成地址自身审查的同时，继续审查该地址的交易对手（counterparties），评估对手方通过资金往来引入的风险暴露，并可返回：

• 每一条风险的触发规则（rule_id / trigger_id），便于审计追溯；
• 对手方的资金暴露（方向、占比、美元金额、跳数、路径）；
• 支撑该判断的具体交易明细（交易哈希、金额、代币、时间戳等）；
• 支持同步 / 异步两种模式，可按合规策略（rule_set_id）切换筛查严格度。

适合合规筛查、KYC/KYT 尽职调查以及需要正式审查结论与留痕的场景，响应通常约 2–3 秒。

能力对比

对比项	/kya/risk	/kya/screening_v2
能力定位	地址自身风险评估	地址自身 + 交易对手全面筛查
评估范围	仅目标地址本身	目标地址 + 其交易对手方
审查交易对手	否	是
资金暴露 / 路径分析（exposure、paths）	否	是
交易明细（transactions）	否	是
触发规则可追溯（trigger、rule_id）	否	是
实体与标签（entities、labels）	是	是
合规策略切换（rule_set_id）	否	是
同步 / 异步模式	仅同步	同步 + 异步
响应时间	毫秒级	约 2–3 秒
典型用途	快速、高频的初步风险排查	合规筛查、尽调与正式审查

同一地址，两种视角

以同一个地址 TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR 为例，可以直观看到两个接口的能力差异。

/kya/risk 判定该地址自身命中 Blocked 与 Sanctioned（均来自地址自身的标签），给出风险等级为 High：

"risk_factors": {
  "Blocked":   [{ "origin": "self", "sub_origin": "label", "category": "Blocked",   "level": "High" }],
  "Sanctioned":[{ "origin": "self", "sub_origin": "label", "category": "Sanctioned", "level": "High" }]
}

/kya/screening_v2 除了给出相同的自身风险外，还额外发现了一笔来自受制裁对手方的资金暴露——这是 risk 无法提供的信息：

"Sanctioned": [
  { "origin": "Self", "sub_origin": "Label", "category": "Sanctioned", "level": "High" },
  {
    "origin": "Direct Exposure", "sub_origin": "Label", "category": "Sanctioned", "level": "High",
    "exposure": {
      "direction": "Inbound",
      "amount_usd": 25700,
      "counterparty_address": "TAN6jFzDmmZVyE3GbL1B2qNfy4o3MX6U9D",
      "hop_count": 1
    }
  }
]

screening_v2 进一步在 counterparties 中给出该对手方的完整交易明细（交易哈希、代币、金额、时间戳等），使风险判断可核查、可留痕。

如何选择

你的场景	推荐接口
大批量、高频地址的初步风险预检	/kya/risk
只需知道地址本身是否高风险	/kya/risk
合规筛查、KYC / KYT 尽职调查	/kya/screening_v2
需要审查资金往来对手方的风险暴露	/kya/screening_v2
需要触发规则、交易明细以出具审查结论与留痕	/kya/screening_v2

建议：可用 /kya/risk 做低成本的第一道过滤，对命中或存疑的地址再调用 /kya/screening_v2 做深度筛查。

相关页面

• kya/risk
• kya/screening_v2
• kya/labels