GET /apiv2/aml/history

Được thay thế bởi GET /apiv2/screening/history

GET /apiv2/screening/history phân trang theo con trỏ thay vì số trang, do đó các bản ghi không bị dịch chuyển trong khi bạn đọc; mọi bộ lọc đều là tùy chọn và các lần kiểm tra bị bỏ qua cũng được bao gồm. Điểm cuối này vẫn tiếp tục hoạt động và sẽ không bị gỡ bỏ mà không có thông báo trước.

Lấy lịch sử kiểm tra AML cho một địa chỉ cụ thể. Chỉ trả về các lần kiểm tra thuộc về người dùng đã xác thực. Phân trang: 100 mục mỗi trang, mới nhất xếp trước.

Tất cả dấu thời gian trong phản hồi đều là UTC. Định dạng chuỗi không thay đổi — "2026-09-09 23:01:44", không có hậu tố múi giờ.

URL endpoint

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

Header yêu cầu

Header	Required	Description
X-API-KEY	Có	API key của bạn từ trang tổng quan Netts

Tham số truy vấn

Parameter	Type	Required	Default	Description
address	string	Có	—	Địa chỉ blockchain (10-100 ký tự)
network	string	Có	—	Mã mạng blockchain (xem Mạng được hỗ trợ)
page	integer	Không	1	Số trang (bắt đầu từ 1, 100 mục mỗi trang)

Examples Yêu cầu

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']})")

Phản hồi

Thành công (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"
}

Không có kết quả (200 OK)

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

Các trường Response

Field	Type	Description
data.address	string	Địa chỉ đã truy vấn
data.total	integer	Tổng số lượt kiểm tra cho địa chỉ này
data.page	integer	Số trang hiện tại
data.pages	integer	Tổng số trang
data.checks	array	Mảng các bản ghi kiểm tra (tối đa 100 mục mỗi trang)

Các trường bản ghi kiểm tra

Field	Type	Description
client_order_id	string	ID đơn hàng — sử dụng với GET /apiv2/aml/{order_id} để nhận kết quả đầy đủ
provider	string	Nhà cung cấp AML: elliptic
status	string	completed, pending, processing, failed
created_at	string	Ngày/giờ gửi yêu cầu kiểm tra
completed_at	string | null	Ngày/giờ hoàn thành kiểm tra
risk_score	number | null	Điểm rủi ro (Elliptic: 0-10). null nếu chưa hoàn thành
risk_level	string | null	low, medium, hoặc high
is_sanctioned	boolean | null	true nếu phát hiện có liên quan đến lệnh trừng phạt

Phân trang

• Mỗi trang trả về tối đa 100 bản ghi, được sắp xếp theo ngày (mới nhất xếp trước)
• Sử dụng total để biết có bao nhiêu lần kiểm tra tồn tại cho địa chỉ này
• Sử dụng pages để biết số trang khả dụng cuối cùng
• page=1 trả về 100 lần kiểm tra gần đây nhất, page=2 trả về 100 lần tiếp theo, v.v.

Phản hồi lỗi

Lỗi xác thực (401)

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

Mạng không hợp lệ (400)

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

Ghi chú

• Chỉ các lần kiểm tra của chính bạn mới được trả về — bạn không thể xem các lần kiểm tra do người dùng khác thực hiện cho cùng một địa chỉ
• Các lần kiểm tra có trạng thái skipped (địa chỉ không hoạt động) được loại trừ khỏi lịch sử
• Để nhận kết quả đầy đủ cho bất kỳ lần kiểm tra nào, hãy sử dụng GET /apiv2/aml/{order_id} với client_order_id