CertiK - SkyInsights API 문서

CertiK SkyInsights API 문서 CertiK SkyInsights API는 규제 준수, AML/CFT 스크리닝 및 위험 모니터링을 위해 설계된 실시간 블록체인 인텔리전스 솔루션입니다.

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	Null/객체/배열	비즈니스별 응답 콘텐츠(성공 시에만 반환됨, 구조는 엔드포인트에 따라 다름)

성공 응답 템플릿

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	끈	아니요	선택적 매개변수 모두(기본값) 토종의 토큰

응답(데이터 구조)

최상위 데이터 필드의 데이터 유형은 요청의 체인 매개변수에 따라 달라집니다.

데이터는 단일 체인의 주소에 대한 스크리닝 결과를 담고 있는 객체입니다.

필드	유형	있음	설명
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

체인	API의 가치	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	내부 서버 오류