钱包筛查 API

在你接收 USDT 或其他加密资金之前，先筛查对方地址的风险信号。 OnChainRisk 提供一个钱包筛查 API：传入一个地址，即可返回 0-100 的风险评分、风险等级、风险标记（pattern flags）与可解释的风险原因，用于收款、出款、OTC 交易或 P2P 结算之前的判断。支持波场（TRON）/ USDT-TRC20（在支持的网络上）。

创建免费沙盒密钥查看 API 文档

沙盒优先：先用免费沙盒密钥（前缀 ocr_test_）对接真实接口，测试完成后再切换到付费密钥用于生产环境。自助注册，无需销售沟通。

适用对象

交易所

在充值或提现审核中加入一次地址风险检查。

OTC / 场外交易台

在结算前检查交易对手地址的风险信号。

P2P 平台

在交易完成前审查对手方地址，包括 USDT-TRC20 收付款场景。

支付与收款服务

在出款前先筛查目标钱包，降低接收到高风险资金的可能。

开发者

用一个 REST API 把地址风险检查集成到你的产品、机器人或后端流程中。

合规团队

自动完成第一轮钱包风险初筛，并将高风险地址转交人工复核。

筛查流程

收到收款 / 结算请求

有用户申请提现，或有交易对手即将结算。你已经拿到目标 / 对手方地址。

调用钱包筛查 API

用该地址调用接口；网络会根据地址格式自动识别。EVM 地址默认按以太坊处理，其他 EVM 链（如 Polygon、BSC、Arbitrum）请显式指定 network。建议沙盒优先：先用沙盒密钥测试再上生产。

查看风险评分与信号

读取 0-100 风险评分、风险标记、资金流向敞口、可获得的交易对手 / 标签，以及在支持的网络上的制裁名单筛查结果。

放行、复核或升级处理

低风险地址自动放行，风险升高的转人工复核，高风险的在资金到账前先冻结或升级处理。

请求与响应示例

用你的 API 密钥向 POST /api/v1/check 传入一个地址。沙盒密钥（ocr_test_）与付费密钥使用完全相同的调用方式；只有 address 是必填项，非以太坊的 EVM 链请传 network 以消除歧义。

请求 Request

curl -X POST https://api.onchainrisk.io/api/v1/check \
  -H "Authorization: Bearer ocr_test_your_sandbox_key" \
  -H "Content-Type: application/json" \
  -d '{"address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "network": "tron"}'

响应示例 Response（字段结构，取自 API 参考）

{
  "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "network": "tron",
  "riskScore": 5,
  "riskLevel": "low",
  "patternFlags": []
}

响应可包含 riskScore（0-100）、riskLevel、 riskConfidence、patternFlags、排序后的 riskReasons 与 topCounterparties 等字段。制裁相关信号在支持的网络上可能包含在内。完整字段请参阅 API 文档。这些是用于辅助你审查的风险信号，并非担保。

波场（TRON）/ USDT-TRC20 收付款场景

USDT-TRC20 常用于收付款与交易对手往来，在出款或结算前先筛查 T 开头的地址，是该 API 支持的一种常见用法。该 API 会对波场地址评分，并一并审查 USDT-TRC20 交易对手（在支持的网络上）。

网络覆盖

多链覆盖仍在持续扩展中，各网络的可用性与历史数据完整度不尽相同 —— 具体的逐网络状态请查看实时覆盖矩阵。

先测试，再接入生产

沙盒优先：创建免费沙盒 API 密钥（前缀 ocr_test_），对接真实接口完成测试后，再切换到付费密钥用于生产。全程自助，无需销售沟通。

创建免费沙盒密钥

透明定价

免费

$0/月

用于测试与评估

· 用于集成测试的沙盒 API 密钥
· 自助注册，无需信用卡

Pro

$49/月

面向开发者与小团队

· 每月 1,000 次请求
· API 访问，10 req/s
· 完整分析响应

Business

$249/月

面向企业与合规团队

· 每月 5,000 次请求
· 10 个 API 密钥，50 req/s
· 批量分析

重要说明

OnChainRisk 提供风险信号，用于辅助你自己的审查流程。它不保证某个钱包是「干净的」，不是反洗钱（AML）或 KYT 合规项目的替代品，也不构成法律或合规意见。请与你自己的流程结合使用。制裁名单筛查仅在支持的网络上进行，且清晰的结果并不构成完整性保证。各网络的覆盖与可用信号可能不同。