跳转到内容

kya/screening_v2

/kya/screening_v2 端点用于提交新的筛查任务，支持同步和异步两种模式。异步模式会返回 task_id 供后续查询结果；同步模式则会直接在响应中返回风险结果。

请求

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

参数	类型	必填	说明	示例
`chain`	String	是	目标区块链名称（必须是支持的链，见支持的链页面）	`eth`、`btc`、`bsc`、`sol`
`address`	String	是	有效的区块链地址	`0x1234567890abcdef1234567890abcdef12345678`
`rule_set_id`	String	否	可选参数：`standard-mode-rule-set`（默认）、`fast-mode-rule-set` 或 `strict-mode-rule-set`
`mode`	String	否	可选参数：`async`（默认）或 `sync`

异步模式响应

字段	类型	出现条件	说明
`task_id`	String	始终返回	筛查任务 ID

示例代码 - 异步模式

请求

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

响应

{
  "code": 202,
  "message": "accepted",
  "data": {
    "task_id": "698d7b705f481da34257a174"
  }
}

同步模式响应

字段	类型	出现条件	说明
`chain`	String	始终返回	区块链网络标识（例如 `eth`）。
`address`	String	始终返回	被筛查的钱包地址。
`rule_set_id`	String	始终返回	该任务使用的合规策略 ID。
`status`	String	始终返回	当前任务状态（例如 `SUCCESS`、`FAILED`）。
`retry_count`	Integer	始终返回	系统重试次数。
`created_at`	String	始终返回	任务创建时间，ISO 8601 格式。
`updated_at`	String	始终返回	最近更新时间，ISO 8601 格式。
`started_at`	String	始终返回	分析开始时间，ISO 8601 格式。
`finished_at`	String	始终返回	分析结束时间，ISO 8601 格式。
`api_key`	String	始终返回	发起该请求的 API Key。
`org_id`	String	始终返回	组织 ID。
`result`	Object	始终返回	筛查结果。
`-risk_results`	Object	始终返回	分组后的风险类别（例如 `Hack`、`Scam`）。
`--origin`	String	在风险结果中始终返回	风险来源（例如 `self`）。
`--sub_origin`	String	在风险结果中始终返回	风险来源维度（例如标签或实体）。
`--category`	String	在风险结果中始终返回	高层分类（例如 `Cefi`、`Dapp`、`Infra`）。
`--level`	String	在风险结果中始终返回	该风险因子的严重等级。
`--trigger`	Object	在风险结果中始终返回	技术规则和触发器标识。
`---rule_id`	String	始终返回	命中的内部规则 ID。
`---trigger_id`	String	始终返回	具体命中的触发条件 ID。
`--exposure`	Object	在风险结果中始终返回	风险关联的数值和路径分析。
`---direction`	String	始终返回	资金方向（`Inbound` 或 `Outbound`）。
`---share`	Float	始终返回	风险暴露金额占总金额的比例（0.0 到 1.0）。
`---amount_usd`	Float	始终返回	该风险暴露对应的美元总额。
`---amount`	Number	始终返回	该风险暴露对应的资产数量。
`---tx_count`	Integer	始终返回	贡献该暴露的交易数量。
`---counterparty_address`	String	始终返回	风险来源对应的地址。
`---hop_count`	Integer	始终返回	目标地址与风险源之间的跳数（1 表示直接关联）。
`---path_count`	Integer	始终返回	识别出的资金路径总数。
`---paths_aggregated`	Boolean	始终返回	是否对多条路径进行了聚合。
`---paths`	Array	始终返回	详细路径可视化数据（无结果时返回 `[]`）。
`-counterparties`	Object	始终返回	以钱包地址为键的对手方数据映射。
`--counterparty`	String	在对手方数据中始终返回	对手方钱包地址。
`--risk_factors`	Object	在对手方数据中始终返回	该对手方的具体风险标签和来源。
`---origin`	String	在风险因子中始终返回	风险来源（例如 `self`）。
`---sub_origin`	String	在风险因子中始终返回	风险来源维度（例如标签或实体）。
`---category`	String	在风险因子中始终返回	高层分类（例如 `Cefi`、`Dapp`、`Infra`）。
`---level`	String	在风险因子中始终返回	风险严重等级。
`---trigger`	Object	在风险因子中始终返回	技术规则和触发器标识。
`----rule_id`	String	始终返回	命中的内部规则 ID。
`----trigger_id`	String	始终返回	具体命中的触发条件 ID。
`--transactions`	Array	在对手方数据中始终返回	与该对手方的实际转账列表。
`---chain`	String	在交易中始终返回	交易发生的链。
`---hash`	String	在交易中始终返回	交易哈希。
`---type`	String	在交易中始终返回	交易类型（例如 `Normal`）。
`---block_number`	Integer	在交易中始终返回	交易区块高度。
`---timestamp`	Integer	在交易中始终返回	Unix 时间戳。
`---from`	String	在交易中始终返回	发送地址。
`---to`	String	在交易中始终返回	接收地址。
`---amount`	String	在交易中始终返回	原始资产数量。
`---usd_value`	Number	在交易中始终返回	转账时刻的美元估值。
`---token_address`	String	在交易中始终返回	资产合约地址（原生币通常使用 `0xEeee...`）。
`---token_symbol`	String	在交易中始终返回	代币符号（例如 `USDT`）。
`---token_decimals`	Integer	在交易中始终返回	代币精度，用于格式化原始数量。
`---token_name`	String	在交易中始终返回	代币名称（例如 `Tether USD`）。
`---token_price`	Number	在交易中始终返回	交易时刻该资产的美元单价。
`-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` 中始终返回	具体标签名称（例如 `USDT Frozen Address`）。

示例代码 - 同步模式

请求

curl -X GET "https://api.skyinsights.certik.com/v4/kya/screening_v2?chain=tron&address=TEAqwfMhXLaomXhZ8KeMhx3njGmQEDnsUR&rule_set_id=standard-mode-rule-set&mode=sync" \
  -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": ""
        }
      ]
    }
  }
}

相关页面

在线调试