跳转到内容
SkyInsights SkyInsights SkyInsights

kya/screening_v2/result

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

请求

Section titled “请求”
  • HTTP 方法：GET
  • 端点路径：/kya/screening_v2/result
  • Query 参数：
参数类型必填说明示例
task_idString是筛查任务 ID
max_counterparties_countString否返回的最大对手方数量，默认 100

响应

Section titled “响应”
字段类型出现条件说明
chainString始终返回区块链网络标识（例如 eth）。
addressString始终返回被筛查的钱包地址。
rule_set_idString始终返回该任务应用的合规策略 ID。
statusString始终返回当前任务状态（例如 SUCCESS、FAILED）。
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始终返回分组后的风险类别（例如 Hack、Scam）。
--originString在风险结果中始终返回风险来源（例如 self）。
--sub_originString在风险结果中始终返回风险来源维度（例如标签或实体）。
--categoryString在风险结果中始终返回高层分类（例如 Cefi、Dapp、Infra）。
--levelString在风险结果中始终返回该风险因子的严重等级。
--triggerObject在风险结果中始终返回技术规则和触发器标识。
---rule_idString始终返回命中的内部规则 ID。
---trigger_idString始终返回命中的具体触发条件 ID。
--exposureObject在风险结果中始终返回风险关联的数值和路径分析。
---directionString始终返回资金方向（Inbound 或 Outbound）。
---shareFloat始终返回风险暴露金额占总金额的比例（0.0 到 1.0）。
---amount_usdFloat始终返回风险暴露对应的美元总额。
---tx_countInteger始终返回贡献该暴露的交易数量。
---counterparty_addressString始终返回风险来源对应的地址。
---hop_countInteger始终返回目标地址与风险源之间的跳数（1 表示直接关联）。
---path_countInteger始终返回识别出的资金路径总数。
---paths_aggregatedBoolean始终返回是否对多条路径进行了聚合。
---pathsArray始终返回详细路径可视化数据（无结果时返回 []）。
-counterpartiesObject始终返回以钱包地址为键的对手方数据映射。
--counterpartyString在对手方数据中始终返回对手方钱包地址。
--risk_factorsObject在对手方数据中始终返回该对手方的具体风险标签和来源。
---originString在风险因子中始终返回风险来源（例如 self）。
---sub_originString在风险因子中始终返回风险来源维度（例如标签或实体）。
---categoryString在风险因子中始终返回高层分类（例如 Cefi、Dapp、Infra）。
---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_decimalsInteger在交易中始终返回代币精度，用于格式化原始数量。
---token_priceNumber在交易中始终返回交易时刻该资产的美元单价。

示例代码

Section titled “示例代码”

请求

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

响应

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "eth",
    "address": "0x2782b70De7B99cEc2AD56Ff67b14fA269945Ce4b",
    "rule_set_id": "standard-mode-rule-set",
    "status": "SUCCESS",
    "retry_count": 0,
    "created_at": "2026-03-10T09:10:30.374Z",
    "updated_at": "2026-03-10T09:10:35.529Z",
    "started_at": "2026-03-10T09:10:34.927Z",
    "finished_at": "2026-03-10T09:10:35.529Z",
    "api_key": "eh7s3qk7c41w7vbffov6gzzga8e71t62",
    "org_id": "fireworks",
    "result": {
      "risk_results": {
        "Mixing": [
          {
            "origin": "Direct Exposure",
            "sub_origin": "Label",
            "category": "Mixing",
            "level": "Medium",
            "trigger": {
              "rule_id": "rule-mixing",
              "trigger_id": "mixing-direct-label-trigger"
            },
            "exposure": {
              "direction": "Inbound",
              "share": 0.33919121289729925,
              "amount_usd": 96325.4921875,
              "tx_count": 1,
              "counterparty_address": "0x0039F22efB07A647557C7C5d17854CFD6D489eF3",
              "hop_count": 1,
              "path_count": 0,
              "paths_aggregated": false,
              "paths": []
            }
          }
        ]
      },
      "counterparties": {
        "0x0039F22efB07A647557C7C5d17854CFD6D489eF3": {
          "counterparty": "0x0039F22efB07A647557C7C5d17854CFD6D489eF3",
          "risk_factors": {
            "Mixing": [
              {
                "origin": "Self",
                "sub_origin": "Label",
                "category": "Mixing",
                "level": "Medium",
                "trigger": {
                  "rule_id": "label_based",
                  "trigger_id": "Tornado Withdrawal Address"
                }
              }
            ]
          },
          "transactions": [
            {
              "chain": "eth",
              "hash": "0xd331f3956229f16e6abb7463c73927f4a8147cebe706ea3de91834e0c3dd5430",
              "type": "Normal",
              "block_number": 15479035,
              "timestamp": 1662397862,
              "from": "0x0039F22efB07A647557C7C5d17854CFD6D489eF3",
              "to": "0x2782b70De7B99cEc2AD56Ff67b14fA269945Ce4b",
              "amount": "47000000000000000000",
              "usd_value": 96325.4921875,
              "token_address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
              "token_decimals": 18,
              "token_price": 2049.478515625
            }
          ]
        }
      }
    }
  }
}

在线调试

Section titled “在线调试”