skyinsights

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SkyInsights Risk Intelligence

SkyInsights 风险情报

Use

{skillDir}/scripts/skyinsights.py

for all API calls. The script handles credentials, request formatting, error handling, screening polling, and terminal-friendly output.

所有API调用请使用

{skillDir}/scripts/skyinsights.py

脚本。该脚本会处理凭证、请求格式化、错误处理、筛查轮询以及适配终端的输出。

Running Commands

运行命令

bash

python {skillDir}/scripts/skyinsights.py <subcommand> [args...]

bash

python {skillDir}/scripts/skyinsights.py <subcommand> [args...]

Subcommands

子命令

kya <address> [chain=eth]

—

GET /v4/kya/risk

labels <address> [chain=eth]

—

GET /v4/kya/labels

screen <address> [chain=eth] [rule_set_id=standard-mode-rule-set]

—

GET /v4/kya/screening_v2

+ poll (⚠️ 5–15s)

```
kyt <txn_hash> <chain>
```
—
```
GET /v4/kyt/risk
```
```
help
```
— show usage

rule_set_id

options:

standard-mode-rule-set

(default),

fast-mode-rule-set

kya <address> [chain=eth]

— 调用

GET /v4/kya/risk

接口

labels <address> [chain=eth]

— 调用

GET /v4/kya/labels

接口

screen <address> [chain=eth] [rule_set_id=standard-mode-rule-set]

— 调用

GET /v4/kya/screening_v2

接口并轮询结果（⚠️ 耗时5–15秒）

```
kyt <txn_hash> <chain>
```
— 调用
```
GET /v4/kyt/risk
```
接口
```
help
```
— 显示使用说明

rule_set_id

可选值：

standard-mode-rule-set

（默认）、

fast-mode-rule-set

Supported Chains

支持的链

Per-endpoint chain support. Use the API Value when specifying the

chain

parameter.

Chain	API Value	kya/labels	kya/risk	kya/screening_v2	kyt/risk
Bitcoin	`btc`	✓	✓	✓	✓
Bitcoin Cash	`bch`	✓	✓
Litecoin	`ltc`	✓	✓
Solana	`sol`	✓	✓
Ethereum	`eth`	✓	✓	✓	✓
Polygon	`polygon`	✓	✓	✓	✓
Optimism	`op`	✓	✓	✓	✓
Arbitrum	`arb`	✓	✓	✓	✓
Avalanche	`avax`	✓	✓	✓	✓
Binance Smart Chain	`bsc`	✓	✓	✓	✓
Fantom	`ftm`	✓	✓
Tron	`tron`	✓	✓	✓	✓
Wemix	`wemix`	✓	✓	✓	✓
Base	`base`	✓	✓	✓	✓
Blast	`blast`	✓	✓
Linea	`linea`	✓	✓
Sonic	`sonic`	✓	✓
Unichain	`unichain`	✓	✓
Polygon zkEVM	`polygon_zkevm`	✓	✓

kya/screening_v2

supports:

btc

eth

polygon

op

arb

avax

bsc

tron

wemix

base

multi-chain

is supported by

kya/risk

only.

各端点支持的链有所不同。指定

chain

参数时请使用API对应值。

链名称	API值	kya/labels	kya/risk	kya/screening_v2	kyt/risk
Bitcoin	`btc`	✓	✓	✓	✓
Bitcoin Cash	`bch`	✓	✓
Litecoin	`ltc`	✓	✓
Solana	`sol`	✓	✓
Ethereum	`eth`	✓	✓	✓	✓
Polygon	`polygon`	✓	✓	✓	✓
Optimism	`op`	✓	✓	✓	✓
Arbitrum	`arb`	✓	✓	✓	✓
Avalanche	`avax`	✓	✓	✓	✓
Binance Smart Chain	`bsc`	✓	✓	✓	✓
Fantom	`ftm`	✓	✓
Tron	`tron`	✓	✓	✓	✓
Wemix	`wemix`	✓	✓	✓	✓
Base	`base`	✓	✓	✓	✓
Blast	`blast`	✓	✓
Linea	`linea`	✓	✓
Sonic	`sonic`	✓	✓
Unichain	`unichain`	✓	✓
Polygon zkEVM	`polygon_zkevm`	✓	✓

kya/screening_v2
支持以下链：
btc
eth
polygon
op
arb
avax
bsc
tron
wemix
base
仅
kya/risk
支持
multi-chain
参数。

Default Workflow

默认工作流

Route user requests as follows:

User mentions a transaction hash / tx / txn → run
```
kyt
```
User asks about labels / entity / institution / exchange for an address → run
```
labels
```
User asks if an address is risky / safe / suspicious (no subcommand specified):
1. Run
```
kya
```
  first — fast, checks the address's own labels and risk score.
2. If
```
kya
```
  returns
```
None
```
  or
```
Low
```
  , automatically follow with
```
screen
```
  — a clean address can still have counterparty exposure to sanctioned or hacked funds. Tell the user: "该地址自身风险较低，正在进行合规筛查以检查对手方暴露情况，请稍候（约 5–15 秒）…"
3. If
```
kya
```
  returns
```
Medium
```
  ,
```
High
```
  , or
```
Unknown
```
  , present the result directly without running
```
screen
```
  .

按以下规则路由用户请求：

用户提及交易哈希 / tx / txn → 执行
```
kyt
```
命令
用户查询地址的标签 / 实体 / 机构 / 交易所信息 → 执行
```
labels
```
命令
用户询问地址是否有风险 / 是否安全 / 是否可疑（未指定子命令）：
1. 先执行
```
kya
```
  命令——速度快，检查地址自身的标签和风险评分。
2. 若
```
kya
```
  返回
```
None
```
  或
```
Low
```
  ，自动跟进执行
```
screen
```
  命令——干净的地址仍可能存在与制裁或被盗资金的对手方暴露风险。告知用户："该地址自身风险较低，正在进行合规筛查以检查对手方暴露情况，请稍候（约 5–15 秒）…"
3. 若
```
kya
```
  返回
```
Medium
```
  、
```
High
```
  或
```
Unknown
```
  ，直接展示结果，无需执行
```
screen
```
  命令。

Output Expectations

输出规范

Printed shapes per subcommand:

undefined

各子命令对应的输出格式：

undefined

kya

Risk: {None|Low|Medium|High|Unknown} (score={0-5}) Reasons: {reason1}, {reason2} ← omitted if empty

风险等级: {None|Low|Medium|High|Unknown} (评分={0-5}) 风险原因: {reason1}, {reason2} ← 若无则省略

labels

Entity: {name} Type: {type} Labels: {label1}, {label2} ← omitted if none

实体: {name} 类型: {type} 标签: {label1}, {label2} ← 若无则省略

screen

Screening: {Pass|Fail|Pending} Flagged counterparties: {count} {counterparty_address} {risk_level} {reason} ← one line per flagged party

筛查结果: {Pass|Fail|Pending} 标记的对手方数量: {count} {counterparty_address} {risk_level} {reason} ← 每个标记对手方占一行

kyt

Tx Risk: {None|Low|Medium|High|Unknown} (score={0-5}) Transfers: {count} {from} → {to} {amount} {token} ← one line per transfer


Risk level emojis: ✅ None / 🟡 Low / 🟠 Medium / 🔴 High / ⚪ Unknown

After running the script, summarize the key findings in plain language — especially the risk level and notable risk factors. Don't just repeat the raw output.

交易风险等级: {None|Low|Medium|High|Unknown} (评分={0-5}) 转账记录数: {count} {from} → {to} {amount} {token} ← 每条转账记录占一行


风险等级对应表情：✅ None / 🟡 Low / 🟠 Medium / 🔴 High / ⚪ Unknown

执行脚本后，用通俗易懂的语言总结关键发现——尤其是风险等级和显著风险因素，不要直接重复原始输出内容。

Error Handling

错误处理

Code	Meaning
200	Success
400	Bad Request — invalid parameters (e.g., unsupported chain, malformed address)
401	Unauthorized — missing, invalid, or expired `X-API-Key` / `X-API-Secret`
402	Payment Required — account quota exceeded
403	Forbidden — access denied
429	Too Many Requests — rate limit reached
500	Internal Server Error

Missing credentials: tell the user to set
```
SKYINSIGHTS_API_KEY
```
and
```
SKYINSIGHTS_API_SECRET
```
.
Unsupported chain: ask the user to retry with one of the supported chain identifiers.
```
risk_level
```
is
```
Unknown
```
: the address or transaction is not indexed on that chain, or has no available risk history.

状态码	含义
200	请求成功
400	请求参数错误（例如：不支持的链、格式无效的地址）
401	未授权——缺少、无效或过期的 `X-API-Key` / `X-API-Secret`
402	需付费——账户配额已用尽
403	禁止访问——无权限
429	请求过于频繁——触发速率限制
500	服务器内部错误

缺少凭证：告知用户设置
```
SKYINSIGHTS_API_KEY
```
和
```
SKYINSIGHTS_API_SECRET
```
环境变量。
不支持的链：请用户使用支持的链标识符重试。
```
risk_level
```
为
```
Unknown
```
：该地址或交易在对应链上未被索引，或无可用风险历史记录。

Risk Factors Reference

风险因素参考

Risk Factor	Default Level	Description
Sanctioned	High	Associated with international sanctions lists or restricted entities
TerroristFinancing	High	Involved in terrorist financing or support activities
ChildAbuse	High	Related to child exploitation or illegal content payments
Hack	High	Funds linked to hacking or security breach incidents
Scam	High	Fraud-related activities (e.g., phishing, rug pulls)
Ransomware	High	Connected to ransomware attacks or extortion
Darkweb	High	Associated with dark web markets or illicit transactions
Laundering	High	Associated with on-chain money laundering activities
Blocked	High	Officially frozen by stablecoin issuers (e.g., USDT, USDC)
Blacklisted	High	Listed in blacklists by users or partners
Mixing	Medium	Related to mixing services or fund obfuscation behavior
Gambling	Medium	Connected to gambling or betting platforms

风险因素	默认等级	描述
Sanctioned	高	与国际制裁名单或受限实体相关联
TerroristFinancing	高	涉及恐怖主义融资或支持活动
ChildAbuse	高	与儿童剥削或非法内容付款相关
Hack	高	资金与黑客攻击或安全漏洞事件相关
Scam	高	涉及欺诈活动（例如：钓鱼、跑路骗局）
Ransomware	高	与勒索软件攻击或敲诈勒索相关
Darkweb	高	与暗网市场或非法交易相关联
Laundering	高	与链上洗钱活动相关
Blocked	高	被稳定币发行方（如USDT、USDC）正式冻结
Blacklisted	高	被用户或合作伙伴列入黑名单
Mixing	中	与混币服务或资金混淆行为相关
Gambling	中	与赌博或博彩平台相关联

Risk Score & Level Mapping

风险评分与等级映射

Score	Level	Description
0	None	No known risk — no history of malicious behavior or suspicious associations
1	Low	Low likelihood of illicit involvement, no unusual behavior detected
2–3	Medium	Moderate risk due to indirect exposure or uncertain behavior
4–5	High	Strong indications of potential involvement in malicious or high-risk activity

评分	等级	描述
0	None	无已知风险——无恶意行为历史或可疑关联
1	Low	非法参与可能性低，未检测到异常行为
2–3	Medium	因间接暴露或不确定行为存在中等风险
4–5	High	有强烈迹象表明可能涉及恶意或高风险活动

Risk Reasons Format

风险原因格式

The

risk_reasons

field explains why a risk was assigned. Each entry is prefixed by type:

```
label: Scam/Rugpull
```
— risk comes from a specific label
```
label: Sanction/OFAC
```
```
entity: huione
```
— risk linked to a known entity without a direct label
```
entity: blender_io
```

risk_reasons

字段用于说明风险等级的判定依据，每个条目以类型为前缀：

```
label: Scam/Rugpull
```
— 风险来自特定标签
```
label: Sanction/OFAC
```
```
entity: huione
```
— 风险与已知实体相关，但无直接标签
```
entity: blender_io
```

Usage (for users)

用户使用说明

When a user asks how to use this skill, show them these commands:

/skyinsights kya <address> [chain]       Address risk assessment / 地址风险评分
/skyinsights labels <address> [chain]    Address labels & entity info / 地址标签和实体信息
/skyinsights screen <address> [chain]    Compliance screening (AML) / 合规筛查，需 5–15 秒
/skyinsights kyt <txn_hash> <chain>      Transaction risk / 交易风险分析
/skyinsights help                        Show help / 显示帮助

Prerequisites / 前提条件： Set credentials in environment or

.env

file / 在环境变量或

.env

文件中设置凭证：

SKYINSIGHTS_API_KEY=your_key
SKYINSIGHTS_API_SECRET=your_secret

当用户询问如何使用此Skill时，展示以下命令：

/skyinsights kya <address> [chain]       地址风险评估 / 地址风险评分
/skyinsights labels <address> [chain]    地址标签与实体信息 / 地址标签和实体信息
/skyinsights screen <address> [chain]    合规筛查（AML） / 合规筛查，需 5–15 秒
/skyinsights kyt <txn_hash> <chain>      交易风险分析 / 交易风险分析
/skyinsights help                        显示帮助 / 显示帮助

前提条件 / 前提条件： 在环境变量或

.env

文件中设置凭证：

SKYINSIGHTS_API_KEY=your_key
SKYINSIGHTS_API_SECRET=your_secret