钱包筛选API：链上风险评估，自带密钥仅需0.02美元 (ZH)

KYC检查可以告诉你钱包的所有者是真实的人，但无法告诉你钱包中的代币流向。在链上，一个看似普通的钱包可能距离受制裁地址仅一步之遥，距离暗网市场两步之遥，或者刚从混币器中出来。钱包筛选——即“了解您的交易”（KYT）——是在您允许价值转移之前读取其历史的层。

Didit的钱包筛选API根据链上风险情报评估任何加密钱包地址或交易哈希。您发送一个地址，它会返回一个0-100的风险评分，一个低/中/高/关键的风险等级，以及资金暴露于哪些风险类别（制裁、混币器、暗网市场、勒索软件、被盗资金等）的明细。自带密钥（BYOK）的成本是每次筛选0.02美元，这比直接购买区块链分析订阅便宜大约10倍。

本指南涵盖了API筛选的内容、评分机制以及如何将其集成到存款或提款流程中。

主要要点

• 一次调用，链上风险。发送钱包地址（转帐前）或交易哈希（转帐后），即可获得风险评估结果。
• 0-100风险评分映射到四个等级——低 / 中 / 高 / 关键——因此策略可以是一个简单的阈值，而非旷日持久的研究项目。
• 14+资金来源类别——SANCTIONED（受制裁）、TERRORIST_FINANCING（恐怖主义融资）、RANSOMWARE（勒索软件）、DARKNET_MARKET（暗网市场）、MIXER（混币器）、STOLEN_FUNDS（被盗资金）、SCAM（诈骗）等——每种都按暴露类型显示。
• 暴露表 + 网络图——直接和间接（多跳）暴露，因此您不仅可以看到交易对手，还可以看到其资金来源。
• 自带密钥（BYOK），每次筛选0.02美元。自带您的Crystal或Merkle Science密钥；Chainalysis和Elliptic即将推出。我们也提供托管定价。
• 内置于交易监控中——加密交易可以自动触发钱包筛选，无需额外配置。

钱包筛选的作用

区块链是公共账本，但原始交易数据并非风险数据。将地址转化为风险评估结果需要一个聚类和标记层，将地址映射到真实世界的实体——交易所、混币器、受制裁钱包、勒索软件操作者、暗网市场——然后追踪它们之间的价值流动。

Didit的钱包筛选API基于这些情报。提供一个钱包地址，它会分析该地址的暴露情况：其流入和流出价值有多少直接或通过中间跳连接到高风险实体。它会返回一个单一的风险评分、该评分所属的等级以及导致风险的类别——因此合规策略可以表述为“阻止关键风险，审查高风险，通过其余”。

为什么它很重要

对于任何涉及加密货币的业务——交易所、出入金通道、托管方、钱包、VASP——接受资金即是接受其历史。制裁暴露是最尖锐的问题：无论意图如何，向或从制裁名单上的钱包转移价值都是违规行为。但实际风险更为广泛。通过混币器洗钱的资金、勒索软件支付的收益，或因漏洞被盗的代币都会在其他地方出现之前很久就在链上暴露出来。

传统问题是成本。区块链分析平台以企业订阅形式出售，年度最低费用为五位数和六位数——对于只需要在存款时筛选钱包的团队来说，这是一个真正的障碍。Didit通过自带密钥（BYOK）消除了这一障碍：您自带提供商密钥，通过Didit的统一API支付每次筛选0.02美元，并完全跳过席位许可。

技术细节

钱包筛选在统一的/v3/ API上的交易监控中运行。当您提交加密交易时，引擎可以自动筛选交易对手；您也可以通过设置currency_kind: "crypto"并指定方向来明确筛选。

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_5b21fa",
    "category": "finance",
    "amount": 12500,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x9f1c...e3a2",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_7781", "role": "RECEIVER" }
  }'

响应包含筛选结果——一个数字评分、等级和暴露明细：

{
  "transaction_id": "txn_5b21fa",
  "status": "IN_REVIEW",
  "wallet_screening": {
    "risk_score": 78,
    "risk_band": "HIGH",
    "provider": "crystal",
    "exposure": [
      { "category": "MIXER", "type": "INDIRECT", "hops": 2, "share": 0.34 },
      { "category": "DARKNET_MARKET", "type": "INDIRECT", "hops": 3, "share": 0.11 }
    ]
  }
}

风险评分和等级。每次筛选返回一个0-100的评分，映射到四个等级：

等级	评分	典型策略
LOW	0–24	通过
MEDIUM	25–49	通过并记录/软审查
HIGH	50–79	暂停等待分析师审查
CRITICAL	80–100	拒绝/冻结

资金来源类别。暴露归因于特定类别——SANCTIONED（受制裁）、TERRORIST_FINANCING（恐怖主义融资）、CHILD_EXPLOITATION（儿童剥削）、RANSOMWARE（勒索软件）、STOLEN_FUNDS（被盗资金）、DARKNET_MARKET（暗网市场）、MIXER（混币器）、SCAM（诈骗）、HIGH_RISK_EXCHANGE（高风险交易所）、HIGH_RISK_JURISDICTION（高风险司法管辖区）、GAMBLING_UNLICENSED（未经许可的赌博）、P2P_EXCHANGE（P2P交易所）、EXCHANGE（交易所）和UNNAMED_SERVICE（未命名服务）——因此您看到的是评分的原因，而不仅仅是数字。

暴露类型和网络图。每个类别都报告为直接（钱包与风险实体进行交易）或间接（价值通过中间跳到达），并附带跳数。网络图追踪路径，以便分析师可以看到资金如何通过中介连接。

价格。自带密钥（Crystal或Merkle Science）每次筛选0.02美元。托管定价——由Didit提供数据——Crystal每次筛选0.18美元，Merkle Science每次筛选0.15美元。

转帐前和转帐后筛选

钱包筛选在流程中的两个点起作用。转帐前筛选接收一个钱包地址，并在您接受存款或发放提款之前评估其风险——决策发生在价值转移之前。转帐后筛选接收一个交易哈希（作为payment_reference_id传递），并在事后评估已结算的交易，用于记录和持续审查。大多数团队会同时运行这两种筛选：转帐前用于把控流程，转帐后用于保留可审计的记录。

使用场景

• 加密货币交易所——筛选每一个入金地址和每一个出金目的地；自动拒绝关键风险，将高风险路径交由分析师处理。
• 出入金通道——在结算之前，根据交易对手钱包的暴露情况，限制法币到加密货币和加密货币到法币的兑换。
• 托管方——在接收时筛选钱包并在移动时重新筛选，并以网络图作为任何冻结资产的证据。
• 钱包——通过警告或阻止向具有高制裁或诈骗暴露的地址转移来保护用户。
• VASP——将钱包筛选与FATF旅行规则数据交换相结合，以便同时评估交易对手和来源风险。

如何与Didit集成

1. 设置您的提供商和默认值。在商业控制台的交易 → 设置中，选择Crystal或Merkle Science，添加您的BYOK密钥，并设置加密交易是否默认进行筛选。
2. 发送加密交易。使用currency_kind: "crypto"和方向POST /v3/transactions/。使用include_crypto_screening覆盖每次调用的默认值。
3. 读取结果。根据risk_band和暴露明细采取行动——通过低/中风险，暂停高风险，拒绝关键风险。
4. 在控制台中处理警报。高风险筛选会打开一个附带网络图的警报，供调查和SAR备案。

由于所有这些都基于统一的/v3/ API，钱包筛选、交易监控、KYC和AML组合成一个身份和欺诈平台——被标记的钱包可以暂停交易并自动触发补救步骤。

常见问题

钱包筛选的费用是多少？

自带密钥（Crystal或Merkle Science）每次筛选0.02美元——比直接购买区块链分析订阅便宜大约10倍。托管定价是Crystal每次筛选0.18美元，Merkle Science每次筛选0.15美元。

支持哪些区块链分析提供商？

目前支持Crystal和Merkle Science，通过BYOK或托管方式。Chainalysis和Elliptic即将推出，同样是BYOK每次0.02美元。

风险评分和风险等级有什么区别？

评分是一个0-100的数字；等级（低/中/高/关键）是它所属的范围，因此您可以根据标签制定策略，而无需自行调整数字阈值。

我可以在不发送资金的情况下筛选钱包吗？

是的。转帐前筛选接收一个钱包地址，并在任何价值转移之前返回风险，因此您可以决定是否接受存款或发放提款。

它是否涵盖间接暴露，而不仅仅是直接交易对手？

是的。暴露报告为直接或间接，并附带跳数，网络图追踪资金如何通过中介到达风险实体。

准备好开始了吗？

阅读文档中的钱包筛选概述，在钱包筛选产品页面了解它如何融入平台，并在定价页面查看透明的按次调用定价。准备好后，免费开始——每月500次免费KYC检查，以及自带密钥（BYOK）每次筛选0.02美元的钱包筛选服务。