CertiK - SkyInsights API 文档

CertiK SkyInsights API 文档 CertiK SkyInsights API 是一种实时区块链智能解决方案，专为监管合规、反洗钱/打击资助恐怖主义行为筛查和风险监控而设计。

You can test the API endpoints in this document on our Swagger API page.

To begin using the SkyInsights API, please visit our Contact page to connect with a CertiK representative and obtain access credentials. Once issued, your API Key must be kept secure and never shared in public channels or with unauthorized parties.

基地信息

基本 URL

https://api.skyinsights.certik.com/v4

验证

必需的请求标头

要验证请求，请包含以下两个带有有效凭据的标头：

标题字段	说明	示例值
X-API-Key	客户 API 访问的唯一标识符	hubbuxihpvznyrdfpsosmkghgegvdavn
X-API-Secret	与 API 密钥配对的密钥，用于安全身份验证	TTYAVYAZJYABBTLDHHPEBVDPRFRRCDMY

身份验证失败的后果

Missing, invalid, or expired X-API-Key or X-API-Secret will result in a 401 Unauthorized error (see Section Errors for details).
Credentials that have been revoked by CertiK (e.g., due to non-compliance with terms of service) will also trigger a 401 Unauthorized error.

通用响应格式

所有 API 端点都遵循此顶级响应结构。只有数据字段因端点而异：

顶级字段	类型	说明
code	数字	状态码： 200 - 成功 400 - 错误的请求 401 - 未经授权 404 - 未找到 429 - 请求过多 500 - 内部服务器错误
message	细绳	人类可读的结果（例如，“成功”、“无效链”）
data	空/对象/数组	业务特定的响应内容（仅在成功时返回；结构因端点而异）

成功响应模板

JSON

{
    "code": 200,
    "message": "success",
    "data": {
        // Endpoint-specific content
    }
}

错误响应模板

JSON

{
    "code": 400,
    "message": "invalid chain",
    "data": null
}

API Endpoints

kya/labels

摘要

The kya/labels endpoint provides detailed insights into blockchain address labeling. It returns both entity and behavior labels for a given address on a specified chain.

用户可以

确定与地址相关的实体类型。
了解与地址相关的行为模式。
根据分配的标签评估地址的风险级别。

要求

HTTP Method: GET
Endpoint Path: /kya/labels
查询参数：

范围	类型	必需的	说明	例子
chain	细绳	不	Name of the target blockchain (must be a supported chain—see Section Supported Chains)	eth, btc, bsc
address	细绳	是的	用于检索标签的有效区块链地址	0x1234567890abcdef1234567890abcdef12345678

响应（数据结构）

data is an object type, the specific structure is as follows:

场地	类型	在场	说明
chain	细绳	总是	匹配请求中的链参数
address	细绳	总是	匹配请求中的地址参数
entity_id	细绳	条件	仅当地址与特定实体关联时才返回
labels	数组<Object>	总是	行为标签和实体标签
-chain	细绳	总是
-address	细绳	总是
-category	细绳	总是
-sub_category	细绳	总是
-label	细绳	总是

代码示例

REQUEST CODE

Shell

curl -X GET "https://api.skyinsights.certik.com/v4/kya/labels?chain=btc&address=bc1q8yja3gw33ngd8aunmfr4hj820adc9nlsv0syvz" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-API-Secret: YOUR_API_SECRET"

RESPONSE DATA

JSON

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "btc",
    "address": "bc1q8yja3gw33ngd8aunmfr4hj820adc9nlsv0syvz",
    "entity_id": "KuCoin",
    "labels": [
      {
        "chain": "btc",
        "address": "bc1q8yja3gw33ngd8aunmfr4hj820adc9nlsv0syvz",
        "category": "Cefi",
        "sub_category": "CEX",
        "label": "KuCoin Hot Wallet",
      }
    ]
  }
}

REQUEST CODE

Shell

curl -X GET "https://api.skyinsights.certik.com/v4/kya/labels?chain=eth&address=0x0621160a25a17b7735ce7641fce5d24798c0a039" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-API-Secret: YOUR_API_SECRET"

RESPONSE DATA

JSON

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "eth",
    "address": "0x0621160a25a17b7735ce7641fce5d24798c0a039",
    "labels": [
      {
        "chain": "eth",
        "address": "0x0621160A25A17B7735Ce7641fCe5D24798C0a039",
        "category": "Hack",
        "sub_category": "Contract Exploit",
        "label": "Layer2DAO Exploit",
      }
    ]
  }
}

kya/risk

摘要

The kya/risk endpoint offers a risk assessment for a specific blockchain address. It analyzes the address's historical activity and associated labels to determine its overall risk level on a given chain.

要求

HTTP Method: GET
Endpoint Path: /kya/risk
查询参数：

范围	类型	必需的	说明	例子
chain	细绳	是的	Name of the target blockchain (must be a supported chain—see Section Supported Chains)	eth, btc, bsc, multi-chain
address	细绳	是的	有效的区块链地址	0x1234567890abcdef1234567890abcdef12345678

响应（数据结构）

顶级数据字段的数据类型根据请求中的链参数而变化：

数据是一个对象，其中包含该单一链上地址的风险详情。
当请求中指定多链时：数据是一个数组，其中每个元素代表一个受支持的链上的地址的风险详情。

场地	类型	在场	说明
chain	细绳	总是	匹配请求中的链参数
address	细绳	总是	匹配请求中的地址参数
risk_level	细绳	总是	高、中、低、无
risk_score	数字	总是	0-5
risk_reasons	数组<String>	总是

代码示例

REQUEST CODE

Shell

curl -X GET "https://api.skyinsights.certik.com/v4/kya/risk?chain=eth&address=0x0621160a25a17b7735ce7641fce5d24798c0a039" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-API-Secret: YOUR_API_SECRET"

RESPONSE DATA

JSON

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "eth",
    "address": "0x0621160a25a17b7735ce7641fce5d24798c0a039",
    "risk_level": "High",
    "risk_score": 5,
    "risk_reasons": [
      "label: Hack/Contract Exploit"
    ]
  }
}

示例代码 - 多链

REQUEST CODE

Shell

curl -X GET "https://api.skyinsights.certik.com/v4/kya/risk?chain=multi-chain&address=0x0621160a25a17b7735ce7641fce5d24798c0a039" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-API-Secret: YOUR_API_SECRET"

RESPONSE DATA

JSON

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "chain": "eth",
      "address": "0x0621160a25a17b7735ce7641fce5d24798c0a039",
      "risk_level": "High",
      "risk_score": 5,
      "risk_reasons": [
        "label: Hack/Contract Exploit"
      ]
    },
    {
      "chain": "arb",
      "address": "0x0621160a25a17b7735ce7641fce5d24798c0a039",
      "risk_level": "High",
      "risk_score": 5,
      "risk_reasons": [
        "label: Hack/Contract Exploit"
      ]
    },  
    ...
  ]
}

kya/screening

摘要

The kya/screening endpoint lets you retrieve all transactions involving risky counterparties for a given chain and address, including both token transfers and native-coin transfers.

要求

HTTP Method: GET
Endpoint Path: /kya/screening
查询参数：

范围	类型	必需的	说明	例子
chain	细绳	是的	目标区块链的名称	eth, btc, bsc
address	细绳	是的	有效的区块链地址	0x1234567890abcdef1234567890abcdef12345678
exposure	细绳	不	可选参数直接（默认）
direction	细绳	不	可选参数两者（默认）传入传出
type	细绳	不	可选参数全部（默认）本国的代币

响应（数据结构）

顶级数据字段的数据类型根据请求中的链参数而变化：

data 是一个对象，其中包含该单链上地址的筛选结果。

场地	类型	在场	说明
chain	细绳	总是	匹配请求中的链参数
address	细绳	总是	匹配请求中的地址参数
risk_level	细绳	总是	高、中、低、无
risk_score	数字	总是	0-5
risk_reasons	数组<String>	总是
counterparties	数组<Object>	总是	风险交易对手的地址
-counterparty	细绳	总是
-risk	目的	总是	风险详情
- -risk_level	细绳	总是	高、中、低、无
- -risk_score	数字	总是	0-5
- -risk_reasons	数组<String>	总是
-transactions	数组<Object>	总是
- -tx_hash	细绳	总是
- -block_number	数字	总是
- -timestamp	数字	总是
- -from	细绳	总是
- -to	细绳	总是
- -amount	数字	总是
- -usd_value	数字	条件	仅限 EVM 链和 BTC 链
- -symbol	细绳	总是
- -type	细绳	总是
- -fund_direction	细绳	总是
- -exposure_type	细绳	总是

示例代码 - 单链

REQUEST CODE

Shell

curl -X GET "https://api.skyinsights.certik.com/v4/kya/screening?chain=eth&address=0x2782b70De7B99cEc2AD56Ff67b14fA269945Ce4b" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-API-Secret: YOUR_API_SECRET"

RESPONSE DATA

JSON

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "eth",
    "address": "0x2782b70De7B99cEc2AD56Ff67b14fA269945Ce4b",
    "risk_level": "None",
    "risk_score": 0,
    "risk_reasons": [],
    "counterparties": [
      {
        "counterparty": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
        "risk": {
          "risk_level": "Medium",
          "risk_score": 4,
          "risk_reasons": [
            "label: Scam/Phishing"
          ]
        },
        "transactions": [
          {
            "tx_hash": "0x35afb3a16bab2b58d1505ce065e11be1f321f8dbb2ee782457a857379d59ab38",
            "block_number": 23295644,
            "timestamp": 1757060063,
            "from": "0x19c3d81f77b3adea8235e874857752971cfbf6f4",
            "to": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
            "amount": 0,
            "usd_value": 0,
            "symbol": "ETH",
            "type": "native",
            "fund_direction": "outgoing",
            "exposure_type": "indirect"
          }
        ]
      }
    ]
  }
}

kyt/risk

要求

HTTP Method: GET
Endpoint Path: /kyt/risk
查询参数：

范围	类型	必需的	说明	例子
chain	细绳	是的	Name of the target blockchain (must be a supported chain—see Section Supported Chains)	eth, btc, bsc
txnHash	细绳	是的	有效的区块链 txnHash

响应（数据结构）

data is an object type, the specific structure is as follows:

场地	类型	在场	说明
chain	细绳	总是	匹配请求中的链参数
txnHash	细绳	总是	匹配请求中的 txnHash 参数
risk_level	细绳	总是	高、中、低、无
risk_score	数字	总是	0-5
risk_reasons	数组<String>	总是

代码示例

REQUEST CODE

Shell

curl -X GET "https://api.skyinsights.certik.com/v4/kyt/risk?chain=eth&txnHash=0xb0e50563d9f1b97065617fed560ed6553ba9667e81cc07e996023af473aad464" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-API-Secret: YOUR_API_SECRET"

RESPONSE DATA

JSON

{
  "code": 200,
  "message": "success",
  "data": {
    "chain": "eth",
    "txn_hash": "0xb0e50563d9f1b97065617fed560ed6553ba9667e81cc07e996023af473aad464"
    "risk_level": "High",
    "risk_score": 5,
    "risk_reasons": [
      "label: Mixer/Contract Mixer",
      "label: Sanction/OFAC",
      "label: Sanction/US:OFAC"
    ]
  }
}

Supported Chains

链条	应用程序接口中的值	kya/labels	kya/risk	kya/screening	kyt/risk
Bitcoin	btc	Y	Y	Y	Y
Bitcoin Cash	bch	Y	Y		Y
Litecoin	ltc	Y	Y	Y	Y
Solana	sol	Y	Y	Y	Y
Ethereum	eth	Y	Y	Y	Y
Polygon	polygon	Y	Y	Y	Y
Optimism	op	Y	Y	Y	Y
Arbitrum	arb	Y	Y	Y	Y
Avalanche	avax	Y	Y	Y	Y
Binance Smart Chain	bsc	Y	Y	Y	Y
Fantom	ftm	Y	Y	Y	Y
Tron	tron	Y	Y	Y	Y
Base	base	Y	Y		Y
Blast	blast	Y	Y		Y
Scroll	scroll	Y	Y		Y
Linea	linea	Y	Y		Y
Sonic	sonic	Y	Y		Y
Kaia	kaia	Y	Y		Y
World Chain	world_chain	Y	Y		Y
Unichain	unichain	Y	Y		Y
Polygon zkEVM	polygon_zkevm	Y	Y		Y

Errors

遇到错误时，您将在查询响应的正文中收到一个 HTTP 状态代码以及一条信息和错误代码。我们使用以下状态代码表示错误：

代码	意义
200	找到并正确返回信息
400	无效请求
401	未经授权的错误
402	需要付款
403	服务器禁止
429	API 费率限制
500	服务器内部错误