POST /apiv2/aml

ถูกแทนที่โดย POST /apiv2/screening

POST /apiv2/screening คือสัญญาเวอร์ชัน 2: รูปแบบการตอบกลับเดียวสำหรับทุกผู้ให้บริการและทุกสถานะของคำสั่งซื้อ, ตัวเลขทศนิยมในรูปแบบสตริงแทนตัวเลข JSON, สัดส่วนในระดับสเกลเดียว, และรูปแบบ ข้อผิดพลาดเดี่ยว เอนด์พอยต์นี้ยังคงใช้งานได้และจะไม่มีการยกเลิก โดยไม่แจ้งล่วงหน้า

ส่งแอดเดรสเพื่อทำการตรวจสอบ AML (การป้องกันและปราบปรามการฟอกเงิน) ส่งกลับคะแนนความเสี่ยง ระดับความเสี่ยง และการวิเคราะห์การเชื่อมโยงความเสี่ยงโดยละเอียด

การประทับเวลาทั้งหมดในการตอบกลับเป็นเวลา UTC รูปแบบสตริงไม่มีการเปลี่ยนแปลง — "2026-09-09 23:01:44" โดยไม่มีคำต่อท้ายเขตเวลา

URL ของ Endpoint

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

Headers ของคำขอ

ส่วนหัว	จำเป็น	คำอธิบาย
Content-Type	ใช่	application/json
X-API-KEY	ใช่	คีย์ API ของคุณจากแดชบอร์ด Netts

เนื้อหาของคำขอ

json

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

พารามิเตอร์

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
address	สตริง	ใช่	แอดเดรสบล็อกเชนที่ต้องการตรวจสอบ (10-100 ตัวอักษร)
network	สตริง	ใช่	ตัวระบุเครือข่ายบล็อกเชน (ดู เครือข่ายที่รองรับ ด้านล่าง)
provider	สตริง	ไม่	ผู้ให้บริการ AML: `elliptic` (ค่าเริ่มต้น)
wait	บูลีน	ไม่	หากเป็น `true` จะรอผลลัพธ์แบบซิงโครนัส (สูงสุด 15 วินาที) หากเป็น `false` หรือเว้นว่างไว้ จะส่งกลับทันทีพร้อมสถานะ `pending` และ `client_order_id` — ใช้สำหรับดึงข้อมูลผลลัพธ์ผ่าน GET /apiv2/aml/{order_id}
response_format	สตริง	ไม่	ระดับรายละเอียดการตอบกลับ: `rate` (เฉพาะคะแนน), `full` (ค่าเริ่มต้น, ข้อมูลครบถ้วน)
report_language	สตริง	ไม่	ภาษาสำหรับรายงาน: `en` (ค่าเริ่มต้น)

ผู้ให้บริการ

ผู้ให้บริการ	ช่วงคะแนน	คำอธิบาย
`elliptic`	0 — 10	คะแนนความเสี่ยงของ Elliptic 0 = ไม่มีความเสี่ยง, 10 = ความเสี่ยงสูงสุด `null` = ตรวจไม่พบปัจจัยกระตุ้น

Examples การร้องขอ

cURL (แบบซิงโครนัส)

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 (แบบอะซิงโครนัส)

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

การตอบกลับ

สำเร็จ — รอดำเนินการ (200 OK)

เมื่อไม่ได้กำหนด wait หรือการตรวจสอบยังอยู่ระหว่างดำเนินการ:

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"
}

สำเร็จ — Elliptic เสร็จสมบูรณ์ (200 OK)

การตอบกลับแบบเต็มของ Elliptic พร้อมโครงสร้างข้อมูลทั้งหมด:

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"
}

ฟิลด์การตอบกลับ

ฟิลด์	ชนิด	คำอธิบาย
data.client_order_id	สตริง	รหัสคำสั่งซื้อเฉพาะสำหรับใช้ตรวจสอบสถานะ
data.status	สตริง	`pending`, `processing`, `completed`, `failed`, `skipped`
data.risk_score	ตัวเลข \| null	คะแนนความเสี่ยง Elliptic: 0-10 `null` = ไม่มีปัจจัยกระตุ้น
data.risk_level	สตริง \| null	`none`, `low`, `medium`, `high` หรือ `severe` ทาง Elliptic จะส่งกลับ `low`, `medium`, `high`; BitOK จะมี `none` และ `severe` เพิ่มเติม `null` เมื่อผู้ให้บริการตรวจไม่พบปัจจัยกระตุ้นใดๆ เลย
data.is_sanctioned	บูลีน	`true` หากตรวจพบการเชื่อมโยงกับนิติบุคคลที่ถูกคว่ำบาตร ไม่มีการเปลี่ยนแปลงนับตั้งแต่เปิดตัวเอนด์พอยต์: ไม่ได้แยกความแตกต่างระหว่างแอดเดรสที่ถูกคว่ำบาตรเองหรือแอดเดรสที่มีความเชื่อมโยงกับผู้ที่ถูกคว่ำบาตร — ดูรายละเอียดที่ `data.sanctions`
data.sanctions	ออบเจกต์ \| null	รายละเอียดของการตรวจพบการคว่ำบาตร: แอดเดรสมีรายชื่ออยู่ในรายการคว่ำบาตรเองหรือไม่ ความเชื่อมโยงใกล้ชิดและมีขนาดเท่าใด ดู การคว่ำบาตร
data.result	ออบเจกต์	การตอบกลับฉบับเต็มของผู้ให้บริการ (เมื่อ `response_format=full`)

การคว่ำบาตร

is_sanctioned เป็นค่าบูลีนเดี่ยว และจะแสดงค่า true ในสองสถานการณ์ที่แตกต่างกันอย่างมาก: แอดเดรสที่ถูกตรวจสอบมีชื่ออยู่ในรายการคว่ำบาตรเอง และแอดเดรสที่ถูกตรวจสอบเคยได้รับเงินเศษเสี้ยวเปอร์เซ็นต์ผ่านตัวกลางสองทอดจากผู้ที่อยู่ในรายการคว่ำบาตร แฟล็กนี้ยังคงความหมายเดิมไว้เพื่อความเข้ากันได้ย้อนหลัง; data.sanctions จะช่วยแยกความแตกต่างของทั้งสองกรณีนี้

ฟิลด์	ชนิด	คำอธิบาย
sanctions.self	บูลีน	`true` เมื่อแอดเดรสที่ถูกตรวจสอบเป็นนิติบุคคลที่ถูกคว่ำบาตรเสียเอง
sanctions.self_entities	อาร์เรย์ \| null	รายชื่อนิติบุคคลที่ถูกคว่ำบาตรของตัวเอง เมื่อ `self` เป็น `true`
sanctions.exposure	ออบเจกต์ \| null	ความเชื่อมโยงกับการคว่ำบาตรที่ใหญ่ที่สุดรายการเดียว — สิ่งที่ควรแสดงในบทสรุป
sanctions.exposure.share	ตัวเลข	สัดส่วนของเงินที่เกี่ยวข้อง เป็นเปอร์เซ็นต์ (`8.03` หมายถึง 8.03%)
sanctions.exposure.proximity	สตริง	`screened_address`, `counterparty`, `indirect` หรือ `mixed`
sanctions.exposure.hops	ตัวเลข \| null	จำนวนขั้นการทำธุรกรรมขั้นต่ำ (hops) ไปยังนิติบุคคลที่ถูกคว่ำบาตร
sanctions.exposure.entity	สตริง \| null	ชื่อนิติบุคคลที่ถูกคว่ำบาตร รวมถึงรายการคว่ำบาตรและวันที่
sanctions.exposure.direction	สตริง \| null	`source` สำหรับเงินขาเข้า, `destination` สำหรับเงินขาออก
sanctions.items	อาร์เรย์	ทุกส่วนที่มีความเชื่อมโยงกับการคว่ำบาตร เรียงตามสัดส่วนที่ใหญ่ที่สุดก่อน ใช้ฟิลด์เดียวกันกับ `exposure` พร้อมด้วย `counterparty_share`, `indirect_share`, `value_usd` และ `trigger`
sanctions.related	อาร์เรย์ \| null	BitOK เท่านั้น: การเชื่อมโยงกับกระดานเทรดภายใต้การคว่ำบาตรของสหภาพยุโรปหรือสหราชอาณาจักร โดยแยกต่างหากจากรายการคว่ำบาตรโดยตรง

Proximity สอดคล้องกับคอลัมน์ Closest Proximity ของรายงาน Elliptic:

ค่า	ความหมาย
`screened_address`	แอดเดรสที่ถูกตรวจสอบคือตัวกระตุ้นเอง ไม่ใช่คู่สัญญา
`counterparty`	คู่สัญญาโดยตรงของแอดเดรสที่ถูกตรวจสอบ
`indirect`	เชื่อมโยงผ่านตัวกลาง — ดู `hops`
`mixed`	มีทั้งกระแสเงินโดยตรงและโดยอ้อมไปยังนิติบุคคลเดียวกัน

ส่วนการทำธุรกรรมจะนับเป็นความเชื่อมโยงกับการคว่ำบาตรก็ต่อเมื่อผู้ให้บริการระบุไว้เช่นนั้น — risk_triggers.is_sanctioned สำหรับ Elliptic, หมวดหมู่ sanctions สำหรับ BitOK กฎของ Elliptic ที่ชื่อ Sanctioned, TF & CSAM นั้นยังทำงานกับปัจจัยกระตุ้นด้านประเทศและหมวดหมู่อื่นด้วย ดังนั้นชื่อของกฎเพียงอย่างเดียวจึงไม่ถือเป็นข้อสรุปของการคว่ำบาตร

ออบเจกต์ `result` ของ Elliptic

ฟิลด์	ชนิด	คำอธิบาย
risk_score	ตัวเลข	คะแนนความเสี่ยงที่แม่นยำ (0-10)
risk_score_detail	ออบเจกต์	รายละเอียดจำแนก: คะแนน `source` และ `destination`
contributions	ออบเจกต์	อาร์เรย์ `source` และ `destination` ของผู้มีส่วนร่วมในการไหลของเงินทุน
contributions[].entities	อาร์เรย์	นิติบุคคลที่รู้จักซึ่งเกี่ยวข้องกับการมีส่วนร่วม
contributions[].entities[].name	สตริง	ชื่อนิติบุคคล (เช่น "Binance", "KuCoin")
contributions[].entities[].category	สตริง	ประเภทนิติบุคคล (เช่น "Exchange", "Payment Services Provider")
contributions[].entities[].is_vasp	บูลีน \| null	นิติบุคคลนั้นเป็นผู้ให้บริการสินทรัพย์เสมือน (VASP) หรือไม่
contributions[].contribution_value.usd	ตัวเลข	ปริมาณ USD รวมของการมีส่วนร่วม
contributions[].contribution_percentage	ตัวเลข	เปอร์เซ็นต์ของเงินทุนทั้งหมดจากนิติบุคคลนี้
contributions[].indirect_value.usd	ตัวเลข	ปริมาณ USD ที่ได้รับทางอ้อม (ผ่านตัวกลาง)
contributions[].indirect_percentage	ตัวเลข	เปอร์เซ็นต์ของเงินทุนที่ได้รับทางอ้อม
contributions[].counterparty_value.usd	ตัวเลข	ปริมาณ USD ในฐานะคู่สัญญาโดยตรง
contributions[].counterparty_percentage	ตัวเลข	เปอร์เซ็นต์ในฐานะคู่สัญญาโดยตรง
contributions[].min_number_of_hops	ตัวเลข	จำนวนขั้นการทำธุรกรรมขั้นต่ำจากนิติบุคคล (0 = โดยตรง)
contributions[].is_screened_address	บูลีน	`true` หากเป็นแอดเดรสที่ถูกตรวจสอบเอง
cluster_entities	อาร์เรย์	นิติบุคคลที่รู้จักซึ่งเชื่อมโยงโดยตรงกับคลัสเตอร์ของแอดเดรส
cluster_entities[].name	สตริง	ชื่อนิติบุคคล
cluster_entities[].category	สตริง	หมวดหมู่นิติบุคคล
cluster_entities[].is_vasp	บูลีน \| null	สถานะ VASP
cluster_entities[].is_after_sanction_date	บูลีน	`true` หากกิจกรรมเกิดขึ้นหลังจากนิติบุคคลถูกคว่ำบาตร
evaluation_detail	ออบเจกต์	อาร์เรย์ `source` และ `destination` ของกฎความเสี่ยงที่ถูกกระตุ้น
evaluation_detail[].rule_name	สตริง	ชื่อกฎ (เช่น "Sanctions", "Illicit Activity", "Obfuscating & Misc.")
evaluation_detail[].rule_type	สตริง	ประเภทของกฎ (เช่น "exposure")
evaluation_detail[].risk_score	ตัวเลข	คะแนนความเสี่ยงที่ได้รับจากกฎนี้
evaluation_detail[].matched_elements	อาร์เรย์	หมวดหมู่และนิติบุคคลที่กระตุ้นกฎ
evaluation_detail[].matched_elements[].category	สตริง	หมวดหมู่ความเสี่ยง (เช่น "Sanctioned Entity", "Gambling", "Token Blacklisting")
evaluation_detail[].matched_elements[].contributions	อาร์เรย์	นิติบุคคลภายในหมวดหมู่ที่ตรงกัน
evaluation_detail[].matched_elements[].contributions[].entity	สตริง	ชื่อนิติบุคคล
evaluation_detail[].matched_elements[].contributions[].contribution_percentage	ตัวเลข	เปอร์เซ็นต์ความเสี่ยงจากการเชื่อมโยง
evaluation_detail[].matched_elements[].contributions[].min_number_of_hops	ตัวเลข	ขั้นการทำธุรกรรม (hops)
evaluation_detail[].matched_elements[].contributions[].is_screened_address	บูลีน	`true` เมื่อแอดเดรสที่ถูกตรวจสอบเป็นตัวกระตุ้นกฎเสียเอง
evaluation_detail[].matched_elements[].contributions[].risk_triggers	ออบเจกต์	สาเหตุที่กฎทำงาน: `is_sanctioned` สำหรับรายการคว่ำบาตร, `country` สำหรับเขตอำนาจศาล, `category` สำหรับประเภทนิติบุคคล
evaluation_detail[].matched_behaviors	อาร์เรย์	รูปแบบพฤติกรรมที่ตรวจพบ
detected_behaviors	อาร์เรย์	รูปแบบพฤติกรรมภาพรวมที่ตรวจพบบนแอดเดรส

ระดับความเสี่ยง

Elliptic (สเกล 0-10):

ช่วง	ระดับ	คำอธิบาย
0 — 3	low	ความเสี่ยงต่ำมาก ไม่มีความเชื่อมโยงที่สำคัญ
3 — 7	medium	ความเสี่ยงปานกลาง ตรวจพบหมวดหมู่ที่มีความเสี่ยงบางรายการ
7 — 10	high	ความเสี่ยงสูง นิติบุคคลที่ถูกคว่ำบาตร ผิดกฎหมาย หรือมีความเสี่ยงสูง
null	-	ตรวจไม่พบปัจจัยกระตุ้นความเสี่ยง

BitOK (สเกล 0-1): ผู้ให้บริการจะส่งกลับระดับความเสี่ยงเอง — none, low, medium, high หรือ severe

risk_level เป็นข้อสรุปเดี่ยวที่ใช้เหมือนกันทุกที่: การตอบกลับของ API, แดชบอร์ด และรายงาน PDF จะแสดงข้อความเดียวกันสำหรับการตรวจสอบครั้งเดียวกัน

การตอบกลับเมื่อเกิดข้อผิดพลาด

ข้อผิดพลาดในการตรวจสอบสิทธิ์ (401)

json

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

ข้อผิดพลาดในการตรวจสอบความถูกต้องของข้อมูล (400)

json

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

json

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

ยอดคงเหลือไม่เพียงพอ (402)

json

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

ผู้ให้บริการไม่พร้อมใช้งาน (503)

json

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

การอ้างอิงรหัสข้อผิดพลาด

รหัส	คำอธิบาย	สถานะ HTTP
`-1`	การตรวจสอบสิทธิ์ล้มเหลว	401
`4001`	แอดเดรสไม่ถูกต้องหรือไม่ระบุ	400
`4002`	ผู้ให้บริการไม่ถูกต้อง	400
`4020`	ยอดคงเหลือไม่เพียงพอ	402
`5030`	ผู้ให้บริการไม่พร้อมใช้งาน	503

ขีดจำกัดอัตราการเรียกใช้

การจำกัดอัตราต่อไปนี้มีผลกับเอนด์พอยต์ AML ทั้งหมด (ต่อที่อยู่ IP):

ช่วงเวลา	ขีดจำกัด	คำอธิบาย
1 วินาที	2 คำขอ	สูงสุด 2 คำขอต่อวินาที
1 นาที	30 คำขอ	สูงสุด 30 คำขอต่อนาที

เกินขีดจำกัดอัตรา (429)

json

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

การแคชผลลัพธ์

หากมีการตรวจสอบชุดข้อมูลแอดเดรส + ผู้ให้บริการเดิมภายใน 60 วินาที ล่าสุด ระบบจะส่งผลลัพธ์ที่แคชไว้กลับมา โดยไม่มีค่าใช้จ่าย

เครือข่ายที่รองรับ

พารามิเตอร์ network จำเป็นต้องระบุ โปรดใช้สัญลักษณ์ย่อ (ticker) จากตารางด้านล่าง

Elliptic — การคัดกรองแบบองค์รวม (Holistic Screening)

การตรวจสอบจะดำเนินการสำหรับแอดเดรสเฉพาะบนเครือข่ายเฉพาะ อย่างไรก็ตาม Elliptic จะติดตามสินทรัพย์ทั้งหมดที่เชื่อมโยงกับแอดเดรสนั้น — รวมถึงโทเคน, การโอนย้ายข้ามเชน (cross-chain), และปฏิสัมพันธ์กับนิติบุคคลที่รู้จักบนเครือข่ายอื่น ๆ

เครือข่าย	ตัวย่อ	สินทรัพย์เนทีฟ
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

การคัดกรองสินทรัพย์เดี่ยว (Single Asset Screening)

เครือข่ายเหล่านี้รองรับการคัดกรองแอดเดรส/ธุรกรรมแบบรายตัว:

เครือข่าย	ตัวย่อ	สินทรัพย์เนทีฟ
Bitcoin Cash	`bch`	BCH
Horizen	`zen`	ZEN
ZCash	`zec`	ZEC

ความเข้ากันได้ของผู้ให้บริการและเครือข่าย

เมื่อใช้ provider: "elliptic" — สามารถใช้งานได้ทุกเครือข่ายจากทั้งตาราง Holistic และ Single Asset (47 เครือข่าย) หากส่งเครือข่ายที่ไม่รองรับ API จะส่งกลับรหัสข้อผิดพลาด 4001

หมายเหตุ

ราคา: Elliptic — $0.98 ต่อการตรวจสอบ ราคาที่แสดงเป็น TRX จะอิงตามอัตราแลกเปลี่ยนปัจจุบัน
ระยะเวลาหมดเวลาของซิงโครนัส: wait: true จะรอนานสูงสุด 15 วินาที หากการตรวจสอบใช้เวลานานกว่านั้น จะส่งกลับสถานะ pending
เวลาในการประมวลผล: การตรวจสอบส่วนใหญ่จะเสร็จสมบูรณ์ภายในไม่กี่วินาที อย่างไรก็ตาม บางคำขอ (โดยเฉพาะแอดเดรสที่มีประวัติการทำธุรกรรมที่ซับซ้อน) อาจใช้เวลาประมวลผลสูงสุด 3 นาที สำหรับกรณีดังกล่าว โปรดใช้โหมดอะซิงโครนัส (เว้นว่าง wait หรือตั้งค่า wait: false) แล้วทำการดึงข้อมูลผลลัพธ์ผ่าน GET /apiv2/aml/{order_id}
แอดเดรสที่ไม่มีการเคลื่อนไหว: แอดเดรสที่ไม่มีกิจกรรมบนบล็อกเชนจะส่งกลับสถานะ skipped โดยไม่มีค่าใช้จ่าย

POST /apiv2/aml ​

URL ของ Endpoint ​

Headers ของคำขอ ​

เนื้อหาของคำขอ ​

พารามิเตอร์ ​

ผู้ให้บริการ ​

Examples การร้องขอ ​

cURL (แบบซิงโครนัส) ​

cURL (แบบอะซิงโครนัส) ​

Python ​

การตอบกลับ ​

สำเร็จ — รอดำเนินการ (200 OK) ​

สำเร็จ — Elliptic เสร็จสมบูรณ์ (200 OK) ​

ฟิลด์การตอบกลับ ​

การคว่ำบาตร ​

ออบเจกต์ result ของ Elliptic ​

ระดับความเสี่ยง ​

การตอบกลับเมื่อเกิดข้อผิดพลาด ​

ข้อผิดพลาดในการตรวจสอบสิทธิ์ (401) ​

ข้อผิดพลาดในการตรวจสอบความถูกต้องของข้อมูล (400) ​

ยอดคงเหลือไม่เพียงพอ (402) ​

ผู้ให้บริการไม่พร้อมใช้งาน (503) ​

การอ้างอิงรหัสข้อผิดพลาด ​

ขีดจำกัดอัตราการเรียกใช้ ​

เกินขีดจำกัดอัตรา (429) ​

การแคชผลลัพธ์ ​

เครือข่ายที่รองรับ ​

Elliptic — การคัดกรองแบบองค์รวม (Holistic Screening) ​

การคัดกรองสินทรัพย์เดี่ยว (Single Asset Screening) ​

หมายเหตุ ​

POST /apiv2/aml

URL ของ Endpoint

Headers ของคำขอ

เนื้อหาของคำขอ

พารามิเตอร์

ผู้ให้บริการ

Examples การร้องขอ

cURL (แบบซิงโครนัส)

cURL (แบบอะซิงโครนัส)

Python

การตอบกลับ

สำเร็จ — รอดำเนินการ (200 OK)

สำเร็จ — Elliptic เสร็จสมบูรณ์ (200 OK)

ฟิลด์การตอบกลับ

การคว่ำบาตร

ออบเจกต์ `result` ของ Elliptic

ระดับความเสี่ยง

การตอบกลับเมื่อเกิดข้อผิดพลาด

ข้อผิดพลาดในการตรวจสอบสิทธิ์ (401)

ข้อผิดพลาดในการตรวจสอบความถูกต้องของข้อมูล (400)

ยอดคงเหลือไม่เพียงพอ (402)

ผู้ให้บริการไม่พร้อมใช้งาน (503)

การอ้างอิงรหัสข้อผิดพลาด

ขีดจำกัดอัตราการเรียกใช้

เกินขีดจำกัดอัตรา (429)

การแคชผลลัพธ์

เครือข่ายที่รองรับ

Elliptic — การคัดกรองแบบองค์รวม (Holistic Screening)

การคัดกรองสินทรัพย์เดี่ยว (Single Asset Screening)

หมายเหตุ