API 概述
DeepAML API 为企业级用户提供稳定、快速的链上反洗钱数据服务。支持获取任意链上地址的风险评分、实体标签、功能标签及风险标签，帮助企业实现合规风控。
基础地址: https://openapi.deepaml.io
接口列表
| 接口 | 方法 | 路径 | 描述 |
|---|---|---|---|
| 获取风险评分 | GET | /v1/risk-score | 获取指定地址的风险评分 |
| 获取地址标签 | GET | /v1/address-labels | 批量获取地址的标签信息 |
请求限制
- 普通用户：每秒 2 次，每天 10000 次
- 认证用户：每秒 5 次，每天 100000 次
- 企业用户：自定义限制
认证方式
所有 API 请求需要通过 API Key 进行认证。将您的 API Key 放在请求头 API-KEY 中。
curl -X GET "https://openapi.deepaml.io/v1/risk-score?address=0x123...&chain=ETH" \ -H "API-KEY: your_api_key_here"
通用响应结构
所有接口均返回 JSON 格式的响应：
| 字段 | 类型 | 描述 |
|---|---|---|
| success | boolean | 请求是否成功 |
| code | integer | 状态码，200 表示成功 |
| message | string | 状态信息 |
| data | object | 响应数据（请求成功时存在） |
错误码说明
| 错误码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 请求参数错误 |
| 401 | API Key 无效或缺失 |
| 403 | 权限不足 |
| 404 | 请求地址不存在 |
| 429 | 请求过于频繁，已被限流 |
| 500 | 服务器内部错误 |
| 503 | 服务暂时不可用 |
获取风险评分
GET/v1/risk-score
获取指定链上地址的风险评分（0-100），分数越高风险越大
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| address | string | 是 | 链上地址 |
| chain | string | 否 | 公链标识符，默认为 ETH |
请求示例
curl -X GET "https://openapi.deepaml.io/v1/risk-score?address=0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC&chain=ETH" \ -H "X-API-Key: your_api_key_here"
响应示例
{
"success": true,
"code": 200,
"message": "success",
"data": {
"address": "0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC",
"chain": "ETH",
"risk_score": 85,
"risk_level": "high",
"risk_tags": ["mixer", "high_risk_exchange"],
"updated_at": "2024-01-15T10:30:00Z"
}
}获取地址标签
POST/v1/address-labels
批量获取链上地址的标签信息，支持同时查询多个地址
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| addresses | array | 是 | 地址列表，最多 100 个 |
| chain | string | 否 | 公链标识符，默认为 ETH |
| include_entity | boolean | 否 | 是否返回实体标签，默认 true |
| include_risk | boolean | 否 | 是否返回风险标签，默认 true |
请求示例
curl -X POST "https://openapi.deepaml.io/v1/address-labels" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"addresses":["0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC","0x9876543210abcdef9876543210abcdef98765432"],"chain":"ETH"}'响应示例
{
"success": true,
"code": 200,
"message": "success",
"data": {
"results": [
{"address":"0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC","chain":"ETH","entity_tags":["cex","binance"],"risk_tags":[],"risk_score":15,"risk_level":"low","updated_at":"2024-01-15T10:30:00Z"},
{"address":"0x9876543210abcdef9876543210abcdef98765432","chain":"ETH","entity_tags":["defi","uniswap_v3"],"risk_tags":[],"risk_score":20,"risk_level":"low","updated_at":"2024-01-15T10:30:00Z"}
]
}
}公链 ID 列表
目前支持 1 条公链：
风险等级说明
风险评分（0-100）分为四个等级：
高风险 (70-100)
该地址存在高度可疑行为，建议拒绝交易或进行深入调查。可能涉及混币器、暗网市场、诈骗、攻击成功等高风险场景。
中高风险 (40-69)
该地址存在一定风险，建议保持警惕。可能涉及未验证身份、高频转账、地址投毒等可疑行为。
中低风险 (20-39)
该地址风险较低，但建议保持关注。可能涉及 DeFi 交互、跨链桥接等行为。
低风险 (0-19)
该地址风险极低，判定为正常地址。建议正常交易。
注意事项
- 请勿使用 API 进行任何违法活动，否则后果自负
- 风险评分仅供参考，不构成任何投资建议或合规保证
- 我们会持续更新标签体系与风险模型，但无法保证 100% 准确
- 建议结合多种风控手段进行综合判断
- 如有疑问，请联系我们的专业团队
- API 可能因维护而暂时不可用，请留意我们的公告
- 批量查询建议使用 POST 接口，单次最多 100 个地址
- 建议缓存查询结果以减少 API 调用次数