v4/kyt/risk

/v4/kyt/risk 端点会评估交易相关地址及风险因子，返回该笔交易的风险等级、风险评分、风险原因和规范化后的资产流转信息。

请求

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

参数	类型	必填	说明	示例
chain	String	是	目标区块链名称（必须是支持的链，见支持的链页面）	eth、btc、tron、sol
txn_hash	String	是	有效的区块链交易哈希。兼容旧参数名 txnHash。

响应

接口外层统一返回 code、message、data。以下字段位于 data 内。

通用字段

字段	类型	出现条件	说明
txn_hash	String	始终返回	区块链上的交易哈希。
chain	String	始终返回	请求中的区块链网络标识。
status	String	始终返回	链上交易执行状态。不同链的枚举值可能不同，例如 Success、Failure、SUCCESS。
tokens	Array[String]	始终返回	该交易涉及的资产/代币符号列表。符号来自链上解析或代币元数据；Solana 中 native SOL 与 SPL WSOL 会区分。
total_usd	Number	始终返回	该交易资产流转折算后的总 USD 价值，最多保留 6 位小数。
timestamp	String	始终返回	交易时间戳，按数据源原样返回；TRON 通常为毫秒，EVM/BTC/Solana 通常为秒。
risk_level	String	始终返回	整体风险等级，例如 None、Low、Medium、High。
risk_score	Integer	始终返回	该交易计算出的风险评分。
risk_factors	Object	始终返回	按风险类型分组的风险因子。Key 为风险分类，例如 Sanctioned、Hack、Scam。
transfer	Object	始终返回	该交易中的资产流转内容。
risk_reasons	Array[String]	始终返回	人类可读的风险原因说明。

风险因子

risk_factors 的每个分类下是风险因子数组。

字段	类型	出现条件	说明
origin	String	始终返回	风险来源，例如 self、counterparty。
sub_origin	String	始终返回	风险来源维度，例如 label、entity、direct、indirect。
category	String	始终返回	风险分类，例如 Sanctioned、Hack、Scam。
level	String	条件返回	风险因子的严重等级。
trigger	Object	条件返回	命中的规则触发信息。
exposure	Object	条件返回	风险敞口信息。

地址风险对象

转账中的 from / to 均为地址风险对象。

字段	类型	说明
address	String	地址。
category	String	地址命中的风险分类；无命中时为空字符串。
level	String	地址风险等级；无命中时为空字符串。
score	Integer	地址风险评分；无命中时为 0。

transfer.tx_list

transfer.tx_list 会随链类型变化。

EVM / WEMIX

适用于 eth、bsc、polygon、arb、op、base、avax、ftm、wemix 等 EVM 类链。

字段	类型	说明
tx	Array[Object]	原生币转账列表。
internalTx	Array[Object]	内部原生币转账列表。
tokenTx	Array[Object]	ERC-20 代币转账列表。

tx 和 internalTx 元素字段：

字段	类型	说明
from	Object	发送方地址风险对象。
to	Object	接收方地址风险对象。
amount	String	转账资产数量。
usd_value	String	该笔转账折算后的 USD 价值。

tokenTx 在上述字段基础上额外返回：

字段	类型	说明
symbol	String	代币符号。

TRON

字段	类型	说明
tx	Array[Object]	原生 TRX 转账列表。
tokenTx	Array[Object]	TRC-20 代币转账列表。

tx 元素返回 from、to、amount、usd_value；tokenTx 额外返回 symbol。

BTC

BTC 使用 UTXO 结构，tx_list 为数组。

字段	类型	说明
tx_list	Array[Object]	BTC 交易输入/输出列表。
vin	Array[Object]	输入地址列表。
vout	Array[Object]	输出地址列表。

vin / vout 元素字段：

字段	类型	说明
address	String	地址。
category	String	地址命中的风险分类；无命中时为空字符串。
level	String	地址风险等级；无命中时为空字符串。
score	Integer	地址风险评分；无命中时为 0。
value	String	BTC 数量。
usd_value	String	该笔输入/输出折算后的 USD 价值。

Solana

Solana 使用 getTransaction(jsonParsed) 解析。交易失败时，如果 meta.err != null，会返回 failed: true，通常不会计入资产转移。

字段	类型	说明
tx	Array[Object]	native SOL 资产流转列表。
tokenTx	Array[Object]	SPL Token 资产流转列表。
fee	String	交易手续费，单位 SOL。
fee_usd_value	String	手续费折算后的 USD 价值。
failed	Boolean	失败交易标记；仅失败时返回。

Solana tx / tokenTx 元素字段：

字段	类型	出现条件	说明
from	Object	始终返回	发送方地址风险对象。
to	Object	始终返回	接收方地址风险对象。
amount	String	始终返回	转账资产数量。
usd_value	String	始终返回	该笔转账折算后的 USD 价值。
symbol	String	始终返回	资产符号，例如 SOL、WSOL、USDC。
asset_type	String	始终返回	资产类型：native 或 spl_token。
mint	String	SPL Token 返回	SPL Token mint 地址。native SOL 不返回该字段。
name	String	条件返回	代币名称。
icon	String	条件返回	代币图标 URL。
decimals	Integer	SPL Token 返回	代币精度。
usd_price	String	条件返回	单个代币的 USD 价格。
from_token_account	String	条件返回	SPL Token 来源 token account 地址。
to_token_account	String	条件返回	SPL Token 目标 token account 地址。

示例代码

请求

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

响应

{
  "code": 200,
  "message": "success",
  "data": {
    "txn_hash": "f5acde95106888ffba67d4fa6fde6c0302f6fe9aefa112bf47e124dfee98a1da",
    "chain": "tron",
    "status": "SUCCESS",
    "tokens": [
      "tron",
      "usdt"
    ],
    "total_usd": 301200.000000,
    "timestamp": "1768374081000",
    "risk_level": "Medium",
    "risk_score": 4,
    "risk_factors": {
      "Sanctioned": [
        {
          "origin": "self",
          "sub_origin": "label",
          "category": "Sanctioned",
          "level": "Medium"
        }
      ]
    },
    "transfer": {
      "tx_list": {
        "tx": [
          {
            "from": {
              "address": "TVvJnVcU6Fp6bVgvDUTHBnLR7nPEsvEpYi",
              "category": "",
              "level": "",
              "score": 0
            },
            "to": {
              "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "category": "",
              "level": "",
              "score": 0
            },
            "amount": "0.000000",
            "usd_value": "0.000000"
          }
        ],
        "tokenTx": [
          {
            "from": {
              "address": "TVvJnVcU6Fp6bVgvDUTHBnLR7nPEsvEpYi",
              "category": "",
              "level": "",
              "score": 0
            },
            "to": {
              "address": "TND3uTbNsxzjrYszteJsRTYCunbzQYKfqx",
              "category": "",
              "level": "",
              "score": 0
            },
            "amount": "301200.000000",
            "usd_value": "301200.000000",
            "symbol": "usdt"
          }
        ]
      }
    },
    "risk_reasons": [
      "label: Sanctioned/Huione Withdrawal Address"
    ]
  }
}

不同链的 tx_list 示例

EVM

{
  "tx": [
    {
      "from": { "address": "0x...", "category": "", "level": "", "score": 0 },
      "to": { "address": "0x...", "category": "", "level": "", "score": 0 },
      "amount": "0.1",
      "usd_value": "350.120000"
    }
  ],
  "internalTx": [],
  "tokenTx": [
    {
      "from": { "address": "0x...", "category": "", "level": "", "score": 0 },
      "to": { "address": "0x...", "category": "", "level": "", "score": 0 },
      "amount": "240000.000000",
      "usd_value": "240000.000000",
      "symbol": "usdc"
    }
  ]
}

BTC

[
  {
    "vin": [
      {
        "address": "bc1...",
        "category": "",
        "level": "",
        "score": 0,
        "value": "0.5",
        "usd_value": "42500.000000"
      }
    ],
    "vout": [
      {
        "address": "bc1...",
        "category": "",
        "level": "",
        "score": 0,
        "value": "0.499",
        "usd_value": "42415.000000"
      }
    ]
  }
]

Solana

{
  "tx": [
    {
      "from": { "address": "Cxrq...", "category": "", "level": "", "score": 0 },
      "to": { "address": "9xQe...", "category": "", "level": "", "score": 0 },
      "amount": "0.5",
      "usd_value": "42.057022",
      "symbol": "SOL",
      "asset_type": "native"
    }
  ],
  "tokenTx": [
    {
      "from": { "address": "Cxrq...", "category": "", "level": "", "score": 0 },
      "to": { "address": "Cxrq...", "category": "", "level": "", "score": 0 },
      "amount": "0.264828381",
      "usd_value": "22.275786",
      "symbol": "WSOL",
      "asset_type": "spl_token",
      "mint": "So11111111111111111111111111111111111111112",
      "name": "Wrapped SOL",
      "icon": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
      "decimals": 9,
      "usd_price": "84.11404368010011",
      "to_token_account": "6hYahbDh2pebae3UaWegeE5YoAJTJGT5wvtXQbLstFqq"
    }
  ],
  "fee": "0.000005",
  "fee_usd_value": "0.000421"
}

在线调试