POST /apiv2/aml

Đã được thay thế bởi POST /apiv2/screening

POST /apiv2/screening là hợp đồng phiên bản 2: cùng một cấu trúc phản hồi cho mọi nhà cung cấp và mọi trạng thái của đơn hàng, các số thập phân dưới dạng chuỗi thay vì số JSON, tỷ lệ chia sẻ trên cùng một thang đo, và một định dạng lỗi duy nhất. Điểm cuối này vẫn tiếp tục hoạt động và sẽ không bị ngừng cung cấp mà không có thông báo trước.

Gửi một địa chỉ để sàng lọc AML (Chống rửa tiền). Trả về điểm rủi ro, mức độ rủi ro và phân tích phơi nhiễm chi tiết.

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

POST https://netts.io/apiv2/aml

Headers của yêu cầu

Header	Bắt buộc	Mô tả
Content-Type	Có	application/json
X-API-KEY	Có	Khóa API của bạn từ bảng điều khiển Netts

Body của yêu cầu

json

{
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic",
    "wait": true
}

Tham số yêu cầu

Tham số	Loại	Bắt buộc	Mô tả
address	string	Có	Địa chỉ blockchain cần kiểm tra (10-100 ký tự)
network	string	Có	Định danh mạng blockchain (xem Các mạng được hỗ trợ bên dưới)
provider	string	Không	Nhà cung cấp AML: `elliptic` (mặc định)
wait	boolean	Không	Nếu `true`, đợi kết quả một cách đồng bộ (tối đa 15 giây). Nếu `false` hoặc bỏ qua, trả về ngay lập tức với trạng thái `pending` và `client_order_id` — sử dụng mã này để thăm dò kết quả qua GET /apiv2/aml/{order_id}
response_format	string	Không	Mức độ chi tiết của phản hồi: `rate` (chỉ điểm số), `full` (mặc định, toàn bộ dữ liệu)
report_language	string	Không	Ngôn ngữ cho báo cáo: `en` (mặc định)

Các nhà cung cấp

Nhà cung cấp	Thang điểm	Mô tả
`elliptic`	0 — 10	Điểm rủi ro Elliptic. 0 = không có rủi ro, 10 = rủi ro tối đa. `null` = không phát hiện yếu tố kích hoạt

Ví dụ

cURL (đồng bộ)

bash

curl -X POST https://netts.io/apiv2/aml \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic",
    "wait": true
  }'

cURL (bất đồng bộ)

bash

curl -X POST https://netts.io/apiv2/aml \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic"
  }'

Python

python

import requests

url = "https://netts.io/apiv2/aml"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
}

payload = {
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic",
    "wait": True
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

if response.status_code == 200:
    result = data.get("data", {})
    print(f"Order ID: {result.get('client_order_id')}")
    print(f"Status: {result.get('status')}")
    print(f"Risk Score: {result.get('risk_score')}")
    print(f"Risk Level: {result.get('risk_level')}")
    print(f"Sanctioned: {result.get('is_sanctioned')}")
else:
    print(f"Error: {data}")

Phản hồi

Thành công — Đang xử lý (200 OK)

Khi wait không được thiết lập hoặc quá trình kiểm tra vẫn đang xử lý:

json

{
    "success": true,
    "data": {
        "client_order_id": "A4C666ABE24BD4A",
        "status": "pending",
        "address": "T...example...",
        "provider": "elliptic",
        "price_usdt": 0.98,
        "price_trx": 4.136286,
        "currency": "TRX",
        "message": "AML check order accepted. Use GET /apiv2/aml/A4C666ABE24BD4A to check status."
    },
    "timestamp": "2026-03-10 09:56:31"
}

Thành công — Elliptic đã hoàn thành (200 OK)

Phản hồi đầy đủ của Elliptic với tất cả các cấu trúc dữ liệu:

json

{
    "success": true,
    "data": {
        "client_order_id": "A019540900E55CA",
        "status": "completed",
        "address": "T...example...",
        "provider": "elliptic",
        "report_language": "en",
        "risk_score": 0.802904,
        "risk_level": "low",
        "is_sanctioned": true,
        "created_at": "2026-03-10 15:56:28",
        "completed_at": "2026-03-10 15:56:28",
        "result": {
            "risk_score": 0.802904473154148,
            "risk_score_detail": {
                "source": 0.233206,
                "destination": 0.802904
            },
            "contributions": {
                "source": [
                    {
                        "entities": [
                            {
                                "name": "Capitalist",
                                "is_vasp": true,
                                "actor_id": 53979,
                                "category": "Payment Services Provider",
                                "entity_id": "b73a9c87-...",
                                "category_id": "54f55bfe-...",
                                "is_primary_entity": true
                            }
                        ],
                        "indirect_value": { "usd": 40194.03 },
                        "contribution_value": { "usd": 40194.03 },
                        "counterparty_value": { "usd": 0 },
                        "min_number_of_hops": 2,
                        "indirect_percentage": 31.57,
                        "is_screened_address": false,
                        "contribution_percentage": 31.57,
                        "counterparty_percentage": 0
                    },
                    {
                        "entities": [
                            {
                                "name": "KuCoin",
                                "is_vasp": true,
                                "actor_id": 11620,
                                "category": "Exchange",
                                "entity_id": "e54292da-...",
                                "category_id": "0a52f7a2-...",
                                "is_primary_entity": true
                            }
                        ],
                        "indirect_value": { "usd": 28436.45 },
                        "contribution_value": { "usd": 29434.17 },
                        "counterparty_value": { "usd": 997.72 },
                        "min_number_of_hops": 1,
                        "indirect_percentage": 22.34,
                        "is_screened_address": false,
                        "contribution_percentage": 23.12,
                        "counterparty_percentage": 0.78
                    }
                ],
                "destination": [
                    {
                        "entities": [
                            {
                                "name": "Bybit",
                                "is_vasp": true,
                                "actor_id": 23354,
                                "category": "Exchange",
                                "entity_id": "bddde8b7-...",
                                "category_id": "0a52f7a2-...",
                                "is_primary_entity": true
                            }
                        ],
                        "indirect_value": { "usd": 26333.43 },
                        "contribution_value": { "usd": 27458.30 },
                        "counterparty_value": { "usd": 1124.86 },
                        "min_number_of_hops": 1,
                        "indirect_percentage": 20.69,
                        "is_screened_address": false,
                        "contribution_percentage": 21.57,
                        "counterparty_percentage": 0.88
                    }
                ]
            },
            "cluster_entities": [
                {
                    "name": "Unknown",
                    "is_vasp": null,
                    "actor_id": -4,
                    "category": "Unknown",
                    "entity_id": "00000000-...",
                    "category_id": "00000000-...",
                    "is_primary_entity": true,
                    "is_after_sanction_date": false
                }
            ],
            "evaluation_detail": {
                "source": [
                    {
                        "rule_id": "6c2dcb03-...",
                        "rule_name": "Obfuscating & Misc.",
                        "rule_type": "exposure",
                        "risk_score": 0.2332,
                        "matched_elements": [
                            {
                                "category": "Coin Swap Service",
                                "category_id": "ff85b715-...",
                                "contributions": [
                                    {
                                        "entity": "FixedFloat",
                                        "risk_triggers": {
                                            "category": "Coin Swap Service",
                                            "category_id": "ff85b715-..."
                                        },
                                        "indirect_value": { "usd": 2891.09, "native": 0, "native_major": 0 },
                                        "contribution_value": { "usd": 2968.66, "native": 0, "native_major": 0 },
                                        "counterparty_value": { "usd": 77.58, "native": 0, "native_major": 0 },
                                        "min_number_of_hops": 1,
                                        "indirect_percentage": 2.27,
                                        "is_screened_address": false,
                                        "contribution_percentage": 2.33,
                                        "counterparty_percentage": 0.06
                                    }
                                ],
                                "indirect_value": { "usd": 2891.09, "native": 0, "native_major": 0 },
                                "contribution_value": { "usd": 2968.66, "native": 0, "native_major": 0 },
                                "counterparty_value": { "usd": 0, "native": 0, "native_major": 0 },
                                "indirect_percentage": 100,
                                "contribution_percentage": 2.33,
                                "counterparty_percentage": 0
                            }
                        ],
                        "matched_behaviors": []
                    },
                    {
                        "rule_id": "0a2b68fd-...",
                        "rule_name": "Illicit Activity",
                        "rule_type": "exposure",
                        "risk_score": 0.0026,
                        "matched_elements": [
                            {
                                "category": "Token Blacklisting",
                                "category_id": "94b50de8-...",
                                "contributions": [
                                    {
                                        "entity": "Tether USD",
                                        "risk_triggers": {
                                            "category": "Token Blacklisting",
                                            "category_id": "94b50de8-..."
                                        },
                                        "contribution_value": { "usd": 1022.45, "native": 0, "native_major": 0 },
                                        "min_number_of_hops": 3,
                                        "contribution_percentage": 0.08
                                    }
                                ]
                            }
                        ],
                        "matched_behaviors": []
                    },
                    {
                        "rule_id": "df59fab5-...",
                        "rule_name": "Sanctions",
                        "rule_type": "exposure",
                        "risk_score": 0.0024,
                        "matched_elements": [
                            {
                                "category": "Sanctioned Entity",
                                "category_id": "c1648b7a-...",
                                "contributions": [
                                    {
                                        "entity": "Garantex",
                                        "risk_triggers": {
                                            "category": "Sanctioned Entity",
                                            "category_id": "c1648b7a-..."
                                        },
                                        "contribution_value": { "usd": 863.21, "native": 0, "native_major": 0 },
                                        "min_number_of_hops": 3,
                                        "contribution_percentage": 0.07
                                    }
                                ]
                            }
                        ],
                        "matched_behaviors": []
                    }
                ],
                "destination": []
            },
            "detected_behaviors": []
        },
        "sanctions": {
            "self": false,
            "self_entities": null,
            "exposure": {
                "share": 8.029045,
                "proximity": "mixed",
                "hops": 1,
                "entity": "Garantex Europe OU - OFAC SDN - 5 Apr 2022",
                "category": "OFAC Sanctioned Entity",
                "direction": "destination",
                "rule_name": "Sanctioned, TF & CSAM"
            },
            "items": [
                {
                    "entity": "Garantex Europe OU - OFAC SDN - 5 Apr 2022",
                    "category": "OFAC Sanctioned Entity",
                    "share": 8.02904473154148,
                    "counterparty_share": 2.472410320321629,
                    "indirect_share": 5.556634411219852,
                    "hops": 1,
                    "proximity": "mixed",
                    "is_sanctioned": true,
                    "trigger": "sanctions_list",
                    "value_usd": 7494.407584232807,
                    "direction": "destination",
                    "rule_name": "Sanctioned, TF & CSAM"
                }
            ]
        }
    },
    "timestamp": "2026-03-10 15:56:28"
}

Các trường phản hồi

Trường	Loại	Mô tả
data.client_order_id	string	Mã đơn hàng duy nhất để thăm dò trạng thái
data.status	string	`pending`, `processing`, `completed`, `failed`, `skipped`
data.risk_score	number \| null	Điểm rủi ro. Elliptic: 0-10. `null` = không có yếu tố kích hoạt
data.risk_level	string \| null	`none`, `low`, `medium`, `high` hoặc `severe`. Elliptic trả về `low`, `medium`, `high`; BitOK bổ sung `none` và `severe`. `null` khi nhà cung cấp hoàn toàn không phát hiện yếu tố kích hoạt nào
data.is_sanctioned	boolean	`true` nếu phát hiện có phơi nhiễm với các thực thể bị trừng phạt. Không thay đổi kể từ khi điểm cuối ra mắt: trường này không phân biệt một địa chỉ bị trừng phạt với một địa chỉ chỉ đơn thuần liên kết đến địa chỉ đó — xem `data.sanctions` để biết chi tiết
data.sanctions	object \| null	Phân tích chi tiết về kết quả trừng phạt: liệu bản thân địa chỉ đó có nằm trong danh sách hay không, mối liên kết gần đến mức nào và quy mô lớn ra sao. Xem Trừng phạt
data.result	object	Phản hồi đầy đủ của nhà cung cấp (khi `response_format=full`)

Trừng phạt

is_sanctioned là một giá trị boolean đơn lẻ, và nó hiển thị true trong hai tình huống rất khác nhau: địa chỉ được sàng lọc chính nó nằm trong danh sách trừng phạt, và địa chỉ được sàng lọc đã từng nhận một phần nhỏ của phần trăm thông qua hai bên trung gian từ một đối tượng nằm trong danh sách. Cờ này giữ nguyên ý nghĩa ban đầu để tương thích ngược; data.sanctions sẽ giúp phân biệt rõ ràng hai trường hợp này.

Trường	Loại	Mô tả
sanctions.self	boolean	`true` khi chính địa chỉ được sàng lọc là thực thể bị trừng phạt
sanctions.self_entities	array \| null	Tên các thực thể bị trừng phạt của chính địa chỉ đó, khi `self` là `true`
sanctions.exposure	object \| null	Mối liên kết trừng phạt lớn nhất duy nhất — những gì cần hiển thị trong phần tóm tắt
sanctions.exposure.share	number	Tỷ lệ vốn liên quan, tính theo phần trăm (`8.03` nghĩa là 8.03%)
sanctions.exposure.proximity	string	`screened_address`, `counterparty`, `indirect` hoặc `mixed`
sanctions.exposure.hops	number \| null	Số bước giao dịch tối thiểu đến thực thể bị trừng phạt
sanctions.exposure.entity	string \| null	Tên thực thể bị trừng phạt, bao gồm danh sách và ngày tháng
sanctions.exposure.direction	string \| null	`source` cho dòng tiền đến, `destination` cho dòng tiền đi
sanctions.items	array	Mọi đóng góp trừng phạt, tỷ lệ lớn nhất xếp đầu tiên, cùng các trường như `exposure` cộng thêm `counterparty_share`, `indirect_share`, `value_usd` và `trigger`
sanctions.related	array \| null	Chỉ áp dụng cho BitOK: mức độ phơi nhiễm với các sàn giao dịch chịu lệnh trừng phạt của EU hoặc UK, được tách riêng khỏi chính danh sách trừng phạt

Mức độ tiếp cận phản ánh cột Closest Proximity trong báo cáo của Elliptic:

Giá trị	Ý nghĩa
`screened_address`	Địa chỉ được sàng lọc chính là yếu tố kích hoạt, không phải bên đối tác
`counterparty`	Bên đối tác trực tiếp của địa chỉ được sàng lọc
`indirect`	Tiếp cận qua các bên trung gian — xem `hops`
`mixed`	Cả dòng tiền trực tiếp và gián tiếp đến cùng một thực thể

Một khoản đóng góp chỉ được tính là liên kết trừng phạt khi nhà cung cấp đánh dấu nó như vậy — risk_triggers.is_sanctioned đối với Elliptic, danh mục sanctions đối với BitOK. Quy tắc Elliptic mang tên Sanctioned, TF & CSAM cũng được kích hoạt bởi các yếu tố quốc gia và danh mục, do đó chỉ riêng tên quy tắc không phải là kết luận trừng phạt.

Đối tượng `result` của Elliptic

Trường	Loại	Mô tả
risk_score	number	Điểm rủi ro chính xác (0-10)
risk_score_detail	object	Chi tiết: điểm `source` và `destination`
contributions	object	Mảng `source` và `destination` chứa các yếu tố đóng góp vào dòng tiền
contributions[].entities	array	Các thực thể đã biết liên quan đến khoản đóng góp
contributions[].entities[].name	string	Tên thực thể (ví dụ: "Binance", "KuCoin")
contributions[].entities[].category	string	Loại thực thể (ví dụ: "Exchange", "Payment Services Provider")
contributions[].entities[].is_vasp	boolean \| null	Liệu thực thể có phải là Nhà cung cấp dịch vụ tài sản ảo hay không
contributions[].contribution_value.usd	number	Tổng khối lượng USD của khoản đóng góp
contributions[].contribution_percentage	number	Tỷ lệ phần trăm tổng số tiền từ thực thể này
contributions[].indirect_value.usd	number	Khối lượng USD nhận gián tiếp (qua các bên trung gian)
contributions[].indirect_percentage	number	Tỷ lệ phần trăm số tiền nhận gián tiếp
contributions[].counterparty_value.usd	number	Khối lượng USD với tư cách là bên đối tác trực tiếp
contributions[].counterparty_percentage	number	Tỷ lệ phần trăm với tư cách là bên đối tác trực tiếp
contributions[].min_number_of_hops	number	Số bước giao dịch tối thiểu từ thực thể (0 = trực tiếp)
contributions[].is_screened_address	boolean	`true` nếu đây chính là địa chỉ được sàng lọc
cluster_entities	array	Các thực thể đã biết liên kết trực tiếp với cụm địa chỉ
cluster_entities[].name	string	Tên thực thể
cluster_entities[].category	string	Danh mục thực thể
cluster_entities[].is_vasp	boolean \| null	Trạng thái VASP
cluster_entities[].is_after_sanction_date	boolean	`true` nếu hoạt động diễn ra sau khi thực thể bị trừng phạt
evaluation_detail	object	Mảng `source` và `destination` chứa các quy tắc rủi ro bị kích hoạt
evaluation_detail[].rule_name	string	Tên quy tắc (ví dụ: "Sanctions", "Illicit Activity", "Obfuscating & Misc.")
evaluation_detail[].rule_type	string	Loại quy tắc (ví dụ: "exposure")
evaluation_detail[].risk_score	number	Điểm rủi ro đóng góp từ quy tắc này
evaluation_detail[].matched_elements	array	Các danh mục và thực thể đã kích hoạt quy tắc
evaluation_detail[].matched_elements[].category	string	Danh mục rủi ro (ví dụ: "Sanctioned Entity", "Gambling", "Token Blacklisting")
evaluation_detail[].matched_elements[].contributions	array	Các thực thể trong danh mục khớp
evaluation_detail[].matched_elements[].contributions[].entity	string	Tên thực thể
evaluation_detail[].matched_elements[].contributions[].contribution_percentage	number	Tỷ lệ phần trăm phơi nhiễm
evaluation_detail[].matched_elements[].contributions[].min_number_of_hops	number	Số bước giao dịch
evaluation_detail[].matched_elements[].contributions[].is_screened_address	boolean	`true` khi chính địa chỉ được sàng lọc kích hoạt quy tắc
evaluation_detail[].matched_elements[].contributions[].risk_triggers	object	Lý do quy tắc được kích hoạt: `is_sanctioned` cho danh sách trừng phạt, `country` cho khu vực tài phán, `category` cho loại thực thể
evaluation_detail[].matched_behaviors	array	Các mô hình hành vi được phát hiện
detected_behaviors	array	Các mô hình hành vi tổng thể được phát hiện trên địa chỉ

Mức độ rủi ro

Elliptic (thang điểm 0-10):

Phạm vi	Mức độ	Mô tả
0 — 3	low	Rủi ro tối thiểu. Không có phơi nhiễm đáng kể
3 — 7	medium	Rủi ro trung bình. Phát hiện một số danh mục rủi ro
7 — 10	high	Rủi ro cao. Các thực thể bị trừng phạt, bất hợp pháp hoặc có rủi ro cao
null	-	Không phát hiện yếu tố kích hoạt rủi ro

BitOK (thang điểm 0-1): nhà cung cấp tự trả về mức độ — none, low, medium, high hoặc severe.

risk_level là kết luận duy nhất được sử dụng ở mọi nơi: phản hồi API, bảng điều khiển và báo cáo PDF đều in cùng một từ cho cùng một lần kiểm tra.

Phản hồi lỗi

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

json

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

Lỗi xác thực dữ liệu (400)

json

{
    "success": false,
    "error": {
        "code": 4001,
        "msg": "Invalid or missing address"
    }
}

json

{
    "success": false,
    "error": {
        "code": 4002,
        "msg": "Invalid provider. Use: elliptic"
    }
}

Số dư không đủ (402)

json

{
    "success": false,
    "error": {
        "code": 4020,
        "message": "Insufficient balance"
    },
    "timestamp": "2026-03-10 10:00:00"
}

Nhà cung cấp không khả dụng (503)

json

{
    "success": false,
    "error": {
        "code": 5030,
        "message": "Provider elliptic not available"
    },
    "timestamp": "2026-03-10 10:00:00"
}

Bảng tra cứu mã lỗi

Mã	Mô tả	Trạng thái HTTP
`-1`	Xác thực thất bại	401
`4001`	Địa chỉ không hợp lệ hoặc bị thiếu	400
`4002`	Nhà cung cấp không hợp lệ	400
`4020`	Số dư không đủ	402
`5030`	Nhà cung cấp không khả dụng	503

Giới hạn tần suất

Các giới hạn tốc độ sau áp dụng cho tất cả các điểm cuối AML (trên mỗi địa chỉ IP):

Khoảng thời gian	Giới hạn	Mô tả
1 giây	2 yêu cầu	Tối đa 2 yêu cầu mỗi giây
1 phút	30 yêu cầu	Tối đa 30 yêu cầu mỗi phút

Vượt quá giới hạn tốc độ (429)

json

{
    "message": "API rate limit exceeded"
}

Lưu bộ nhớ đệm kết quả

Nếu cùng một sự kết hợp địa chỉ + nhà cung cấp đã được kiểm tra trong vòng 60 giây qua, kết quả được lưu trong bộ nhớ đệm sẽ được trả về miễn phí.

Các mạng được hỗ trợ

Tham số network là bắt buộc. Sử dụng mã định danh từ bảng bên dưới.

Elliptic — Sàng lọc toàn diện

Việc sàng lọc được thực hiện cho một địa chỉ cụ thể trên một mạng cụ thể. Tuy nhiên, Elliptic sẽ theo dõi tất cả các tài sản liên kết với địa chỉ đó — bao gồm token, các giao dịch chuyển đổi chuỗi chéo và các tương tác với các thực thể đã biết trên các mạng khác.

Mạng	Mã định danh	Tài sản gốc
Algorand	`algo`	ALGO
Aptos	`apt`	APT
Arbitrum	`arb`	ETH
Avalanche (C-Chain)	`avax`	AVAX
Base	`base`	ETH
Binance Chain	`bnb`	BNB
Binance Smart Chain	`bsc`	BNB
Bitcoin	`btc`	BTC
Bittensor	`tao`	TAO
Cardano	`ada`	ADA
Celo	`celo`	CELO
Cosmos	`atom`	ATOM
Crypto.com	`cro`	CRO
Dogecoin	`doge`	DOGE
dYdX	`dydx`	DYDX
Ethereum	`eth`	ETH
Ethereum Classic	`etc`	ETC
Fantom	`ftm`	FTM
Filecoin	`fil`	FIL
Flare	`flr`	FLR
Gnosis	`gnosis`	xDai
Hedera	`hbar`	HBAR
HyperEVM	`hype`	HYPE
Injective	`inj`	INJ
Internet Computer	`icp`	ICP
Linea	`linea`	LINEA
Litecoin	`ltc`	LTC
MobileCoin	`mob`	MOB
Near	`near`	NEAR
Optimism	`op`	ETH
Polkadot	`dot`	DOT
Polygon	`matic`	MATIC
Ripple	`xrp`	XRP
Sei	`sei`	SEI
Solana	`sol`	SOL
Starknet	`strk`	STRK
Stellar	`xlm`	XLM
Sui	`sui`	SUI
Tezos	`xtz`	XTZ
TON	`ton`	TON
Tron	`trx`	TRX
XDC	`xdc`	XDC
XLayer	`okb`	OKB
Zilliqa	`zil`	ZIL
zkSync	`zksync`	ETH

Sàng lọc đơn tài sản

Các mạng này hỗ trợ sàng lọc địa chỉ/giao dịch riêng lẻ:

Mạng	Mã định danh	Tài sản gốc
Bitcoin Cash	`bch`	BCH
Horizen	`zen`	ZEN
ZCash	`zec`	ZEC

Khả năng tương thích của nhà cung cấp & mạng

Khi sử dụng provider: "elliptic" — tất cả các mạng từ các bảng Toàn diện và Đơn tài sản đều khả dụng (47 mạng). Nếu một mạng không được hỗ trợ được truyền vào, API sẽ trả về mã lỗi 4001.

Ghi chú

Định giá: Elliptic — $0.98 cho mỗi lần kiểm tra. Giá hiển thị bằng TRX theo tỷ giá hiện tại
Thời gian chờ đồng bộ: wait: true đợi tối đa 15 giây. Nếu quá trình kiểm tra mất nhiều thời gian hơn, hệ thống sẽ trả về trạng thái pending
Thời gian xử lý: Hầu hết các lần kiểm tra hoàn tất trong vòng vài giây. Tuy nhiên, một số yêu cầu (đặc biệt đối với các địa chỉ có lịch sử giao dịch phức tạp) có thể mất tới 3 phút để xử lý. Hãy sử dụng chế độ bất đồng bộ (bỏ qua wait hoặc đặt wait: false) và thăm dò qua GET /apiv2/aml/{order_id} cho các trường hợp như vậy
Địa chỉ không hoạt động: Các địa chỉ không có hoạt động blockchain sẽ trả về trạng thái skipped mà không tính phí

POST /apiv2/aml ​

URL Endpoint ​

Headers của yêu cầu ​

Body của yêu cầu ​

Tham số yêu cầu ​

Các nhà cung cấp ​

Ví dụ ​

cURL (đồng bộ) ​

cURL (bất đồng bộ) ​

Python ​

Phản hồi ​

Thành công — Đang xử lý (200 OK) ​

Thành công — Elliptic đã hoàn thành (200 OK) ​

Các trường phản hồi ​

Trừng phạt ​

Đối tượng result của Elliptic ​

Mức độ rủi ro ​

Phản hồi lỗi ​

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

Lỗi xác thực dữ liệu (400) ​

Số dư không đủ (402) ​

Nhà cung cấp không khả dụng (503) ​

Bảng tra cứu mã lỗi ​

Giới hạn tần suất ​

Vượt quá giới hạn tốc độ (429) ​

Lưu bộ nhớ đệm kết quả ​

Các mạng được hỗ trợ ​

Elliptic — Sàng lọc toàn diện ​

Sàng lọc đơn tài sản ​

Ghi chú ​

POST /apiv2/aml

URL Endpoint

Headers của yêu cầu

Body của yêu cầu

Tham số yêu cầu

Các nhà cung cấp

Ví dụ

cURL (đồng bộ)

cURL (bất đồng bộ)

Python

Phản hồi

Thành công — Đang xử lý (200 OK)

Thành công — Elliptic đã hoàn thành (200 OK)

Các trường phản hồi

Trừng phạt

Đối tượng `result` của Elliptic

Mức độ rủi ro

Phản hồi lỗi

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

Lỗi xác thực dữ liệu (400)

Số dư không đủ (402)

Nhà cung cấp không khả dụng (503)

Bảng tra cứu mã lỗi

Giới hạn tần suất

Vượt quá giới hạn tốc độ (429)

Lưu bộ nhớ đệm kết quả

Các mạng được hỗ trợ

Elliptic — Sàng lọc toàn diện

Sàng lọc đơn tài sản

Ghi chú