跳转到内容

kya/screening_v2/result

/kya/screening_v2/result 端点用于查询通过 /kya/screening_v2 创建的筛查任务结果。任务完成后,它会返回详细的风险分析结果。

  • HTTP 方法:GET
  • 端点路径:/kya/screening_v2/result
  • Query 参数:
参数类型必填说明示例
task_idString筛查任务 ID
max_counterparties_countString返回的最大对手方数量,默认 100
字段类型出现条件说明
chainString始终返回区块链网络标识(例如 eth)。
addressString始终返回被筛查的钱包地址。
rule_set_idString始终返回该任务应用的合规策略 ID。
statusString始终返回当前任务状态(例如 SUCCESSFAILED)。
retry_countInteger始终返回系统重试次数。
created_atString始终返回任务创建时间,ISO 8601 格式。
updated_atString始终返回最近更新时间,ISO 8601 格式。
started_atString始终返回分析开始时间,ISO 8601 格式。
finished_atString始终返回分析结束时间,ISO 8601 格式。
api_keyString始终返回发起该请求的 API Key。
org_idString始终返回组织 ID。
resultObject始终返回筛查结果。
-risk_resultsObject始终返回分组后的风险类别(例如 HackScam)。
--originString在风险结果中始终返回风险来源(例如 self)。
--sub_originString在风险结果中始终返回风险来源维度(例如标签或实体)。
--categoryString在风险结果中始终返回高层分类(例如 CefiDappInfra)。
--levelString在风险结果中始终返回该风险因子的严重等级。
--triggerObject在风险结果中始终返回技术规则和触发器标识。
---rule_idString始终返回命中的内部规则 ID。
---trigger_idString始终返回命中的具体触发条件 ID。
--exposureObject在风险结果中始终返回风险关联的数值和路径分析。
---directionString始终返回资金方向(InboundOutbound)。
---shareFloat始终返回风险暴露金额占总金额的比例(0.0 到 1.0)。
---amount_usdFloat始终返回风险暴露对应的美元总额。
---amountNumber始终返回该风险暴露对应的资产数量。
---tx_countInteger始终返回贡献该暴露的交易数量。
---counterparty_addressString始终返回风险来源对应的地址。
---hop_countInteger始终返回目标地址与风险源之间的跳数(1 表示直接关联)。
---path_countInteger始终返回识别出的资金路径总数。
---paths_aggregatedBoolean始终返回是否对多条路径进行了聚合。
---pathsArray始终返回详细路径可视化数据(无结果时返回 [])。
-counterpartiesObject始终返回以钱包地址为键的对手方数据映射。
--counterpartyString在对手方数据中始终返回对手方钱包地址。
--risk_factorsObject在对手方数据中始终返回该对手方的具体风险标签和来源。
---originString在风险因子中始终返回风险来源(例如 self)。
---sub_originString在风险因子中始终返回风险来源维度(例如标签或实体)。
---categoryString在风险因子中始终返回高层分类(例如 CefiDappInfra)。
---levelString在风险因子中始终返回风险严重等级。
---triggerObject在风险因子中始终返回技术规则和触发器标识。
----rule_idString始终返回命中的内部规则 ID。
----trigger_idString始终返回命中的具体触发条件 ID。
--transactionsArray在对手方数据中始终返回与该对手方的实际转账列表。
---chainString在交易中始终返回交易发生的链。
---hashString在交易中始终返回交易哈希。
---typeString在交易中始终返回交易类型(例如 Normal)。
---block_numberInteger在交易中始终返回交易区块高度。
---timestampInteger在交易中始终返回Unix 时间戳。
---fromString在交易中始终返回发送地址。
---toString在交易中始终返回接收地址。
---amountString在交易中始终返回原始资产数量。
---usd_valueNumber在交易中始终返回转账时刻的美元估值。
---token_addressString在交易中始终返回资产合约地址(原生币通常使用 0xEeee...)。
---token_symbolString在交易中始终返回代币符号(例如 USDT)。
---token_decimalsInteger在交易中始终返回代币精度,用于格式化原始数量。
---token_nameString在交易中始终返回代币名称(例如 Tether USD)。
---token_priceNumber在交易中始终返回交易时刻该资产的美元单价。
-entitiesArray[Object]条件返回(识别到实体时)与该地址关联的组织/实体资料。
--entity_idStringentities 中始终返回识别出的实体唯一 ID。
--entity_nameObjectentities 中始终返回实体多语言名称(包含 enzh)。
--countryObjectentities 中始终返回实体注册地或运营地区。
--descriptionObjectentities 中始终返回实体详细背景和财务指标。
--linkStringentities 中始终返回实体官网主链接。
--other_linkStringentities 中始终返回以逗号分隔的其他外部链接(社媒、社区等)。
-labelsArray[Object]始终返回(无结果时返回 []地址对应的行为标签与分类集合。
--chainStringlabels 中始终返回标签所属链标识(例如 evmtron)。
--addressStringlabels 中始终返回标签关联的地址。
--categoryStringlabels 中始终返回高层分类(例如 CefiDappInfra)。
--sub_categoryStringlabels 中始终返回更细粒度的分类(例如 CEXDEX)。
--labelStringlabels 中始终返回具体标签名称(例如 USDT Frozen Address)。

请求

Terminal window
curl -X GET "https://api.skyinsights.certik.com/v4/kya/screening_v2/result?task_id=698d7b705f481da34257a174" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Secret: YOUR_API_SECRET"

响应

{
"code": 200,
"message": "success",
"data": {
"chain": "tron",
"address": "TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR",
"rule_set_id": "standard-mode-rule-set",
"status": "SUCCESS",
"retry_count": 0,
"created_at": "2026-07-17T01:16:03.753Z",
"updated_at": "2026-07-17T01:16:09.199Z",
"started_at": "2026-07-17T01:16:04.685Z",
"finished_at": "2026-07-17T01:16:09.199Z",
"api_key": "YOUR_API_KEY",
"org_id": "YOUR_ORG",
"result": {
"risk_results": {
"Blocked": [
{
"origin": "Self",
"sub_origin": "Label",
"category": "Blocked",
"level": "High",
"trigger": {
"rule_id": "rule-blocked",
"trigger_id": "blocked-self-label-trigger"
}
}
],
"Sanctioned": [
{
"origin": "Self",
"sub_origin": "Label",
"category": "Sanctioned",
"level": "High",
"trigger": {
"rule_id": "rule-sanctioned",
"trigger_id": "sanctioned-self-label-trigger"
}
},
{
"origin": "Direct Exposure",
"sub_origin": "Label",
"category": "Sanctioned",
"level": "High",
"trigger": {
"rule_id": "rule-sanctioned",
"trigger_id": "sanctioned-direct-label-trigger"
},
"exposure": {
"direction": "Inbound",
"share": 0.23813767305266928,
"amount_usd": 25700,
"amount": 0,
"tx_count": 1,
"counterparty_address": "TAN6jFzDmmZVyE3GbL1B2qNfy4o3MX6U9D",
"hop_count": 1,
"path_count": 0,
"paths_aggregated": false,
"paths": []
}
}
]
},
"counterparties": {
"TAN6jFzDmmZVyE3GbL1B2qNfy4o3MX6U9D": {
"counterparty": "TAN6jFzDmmZVyE3GbL1B2qNfy4o3MX6U9D",
"risk_factors": {
"Sanctioned": [
{
"origin": "Direct Exposure",
"sub_origin": "Label",
"category": "Sanctioned",
"level": "High",
"trigger": {
"rule_id": "rule-sanctioned",
"trigger_id": "sanctioned-direct-label-trigger"
},
"exposure": {
"direction": "Inbound",
"share": 0.23813767305266928,
"amount_usd": 25700,
"amount": 0,
"tx_count": 1,
"counterparty_address": "TAN6jFzDmmZVyE3GbL1B2qNfy4o3MX6U9D",
"hop_count": 1,
"path_count": 0,
"paths_aggregated": false,
"paths": []
}
}
]
},
"transactions": [
{
"chain": "tron",
"hash": "14878e7f6f598df3717d3863a47c8f96ad3266e78c3adc13428ce08ac8822f72",
"type": "ERC20",
"block_number": 0,
"timestamp": 1682582649,
"from": "TAN6jFzDmmZVyE3GbL1B2qNfy4o3MX6U9D",
"to": "TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR",
"amount": "25700000000",
"usd_value": 25700,
"token_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_symbol": "USDT",
"token_decimals": 6,
"token_name": "Tether USD",
"token_price": 1
}
]
}
},
"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": ""
}
]
}
}
}