GET /apiv2/aml/history

已被 GET /apiv2/screening/history 取代

GET /apiv2/screening/history 采用游标分页而非页码分页，因此在您读取时记录不会发生位移；每个过滤条件均为可选，且包含跳过的检查。此端点将继续保持可用，且在未事先通知的情况下不会被下线。

获取特定地址的 AML 检查历史记录。仅返回属于当前已认证用户的检查。分页返回：每页 100 条记录，按最新优先排序。

响应中的所有时间戳均为 UTC。 字符串格式保持不变 — "2026-09-09 23:01:44"，不带时区后缀。

端点 URL

GET https://netts.io/apiv2/aml/history?address=<ADDRESS>&network=<NETWORK>&page=1

请求头

请求头	必填	描述
X-API-KEY	是	来自 Netts 控制台的 API 密钥

查询参数

参数	类型	必填	默认值	描述
address	string	是	—	区块链地址（10-100 个字符）
network	string	是	—	区块链网络代码（参见支持的网络）
page	integer	否	1	页码（从 1 开始，每页 100 条记录）

请求示例

cURL

curl -X GET "https://netts.io/apiv2/aml/history?address=TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV&network=trx&page=1" \
  -H "X-API-KEY: your_api_key"

Python

import requests

headers = {
    "X-API-KEY": "your_api_key",
}

response = requests.get(
    "https://netts.io/apiv2/aml/history",
    headers=headers,
    params={
        "address": "TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV",
        "network": "trx",
        "page": 1
    }
)
data = response.json()

if data["success"]:
    print(f"Total checks: {data['data']['total']}")
    print(f"Page {data['data']['page']} of {data['data']['pages']}")
    for check in data["data"]["checks"]:
        print(f"  {check['created_at']} | {check['client_order_id']} | "
              f"{check['provider']} | risk={check['risk_score']} ({check['risk_level']})")

响应

成功 (200 OK)

{
    "success": true,
    "data": {
        "address": "TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV",
        "total": 250,
        "page": 1,
        "pages": 3,
        "checks": [
            {
                "client_order_id": "A4C666ABE24BD4A",
                "provider": "elliptic",
                "status": "completed",
                "created_at": "2026-03-10 15:00:00",
                "completed_at": "2026-03-10 15:00:05",
                "risk_score": 10.0,
                "risk_level": "high",
                "is_sanctioned": false
            },
            {
                "client_order_id": "A7F3B2E1D9C04A6",
                "provider": "elliptic",
                "status": "completed",
                "created_at": "2026-03-09 12:30:00",
                "completed_at": "2026-03-09 12:30:08",
                "risk_score": 0.85,
                "risk_level": "high",
                "is_sanctioned": false
            }
        ]
    },
    "timestamp": "2026-03-10 15:05:00"
}

无结果 (200 OK)

{
    "success": true,
    "data": {
        "address": "TXtARC75jmh7sDDfHFunLbpA44T7JhJ53u",
        "total": 0,
        "page": 1,
        "pages": 0,
        "checks": []
    },
    "timestamp": "2026-03-10 15:05:00"
}

响应字段

字段	类型	描述
data.address	string	查询的地址
data.total	integer	该地址的检查总数
data.page	integer	当前页码
data.pages	integer	总页数
data.checks	array	检查记录数组（每页最多 100 条）

检查记录字段

字段	类型	描述
client_order_id	string	订单 ID — 可与 GET /apiv2/aml/{order_id} 配合使用以获取完整结果
provider	string	AML 服务商：elliptic
status	string	completed、pending、processing、failed
created_at	string	检查提交日期/时间
completed_at	string | null	检查完成日期/时间
risk_score	number | null	风险评分（Elliptic：0-10）。如果未完成则为 null
risk_level	string | null	low、medium 或 high
is_sanctioned	boolean | null	如果检测到制裁暴露则为 true

分页

• 每页最多返回 100 条记录，按日期排序（最新优先）
• 使用 total 了解此地址存在的检查总数
• 使用 pages 了解最后一个可用页码
• page=1 返回最新的 100 条检查记录，page=2 返回接下来的 100 条，依此类推

错误响应

认证错误 (401)

{
    "detail": {
        "code": -1,
        "msg": "API key not provided"
    }
}

无效网络 (400)

{
    "success": false,
    "error": {
        "code": 4002,
        "message": "Unsupported network: xyz. See supported networks list."
    }
}

注意事项

• 仅返回您自己的检查 — 您无法查看其他用户针对同一地址进行的检查
• 状态为 skipped 的检查（非活跃地址）不包含在历史记录中
• 要获取任何检查的完整结果，请使用带有 client_order_id 的 GET /apiv2/aml/{order_id}