GET /apiv2/screening/providers

ผู้ให้บริการที่พร้อมใช้งานสำหรับบัญชีของคุณ พร้อมทั้งราคา เครือข่ายที่แต่ละรายครอบคลุม และมาตรวัดที่ใช้ในการประเมินคะแนน

นี่คือสัญญาเวอร์ชัน 2 ซึ่งเข้ามาแทนที่ GET /apiv2/aml/providers ที่ยังคงทำงานได้อยู่ตามปกติ

URL ของ Endpoint

GET https://netts.io/apiv2/screening/providers

Headers ของคำขอ

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

ตัวอย่างคำขอ

curl https://netts.io/apiv2/screening/providers \
  -H "X-API-KEY: your_api_key"

การตอบกลับ

{
  "schema_version": 2,
  "providers": [
    {
      "provider": "elliptic",
      "price_usdt": "0.98",
      "price_trx": "2.884881",
      "available": true,
      "networks": ["ada", "algo", "apt", "arb", "atom", "avax", "base", "bch",
                   "bnb", "bsc", "btc", "celo", "cro", "doge", "dot", "dydx",
                   "etc", "eth", "fil", "flr", "ftm", "gnosis", "hbar", "hype",
                   "icp", "inj", "linea", "ltc", "matic", "mob", "near", "okb",
                   "op", "sei", "sol", "strk", "sui", "tao", "ton", "trx",
                   "xdc", "xlm", "xrp", "xtz", "zec", "zen", "zil", "zksync"],
      "score_scale": { "min": 0, "max": 10 }
    }
  ],
  "trx_rate_usd": "0.339702",
  "supported_languages": ["en"]
}

ฟิลด์	ประเภท	คำอธิบาย
providers[].provider	string	ชื่อผู้ให้บริการ ตามที่ส่งในเนื้อหาคำขอการตรวจสอบ
providers[].price_usdt	string	ราคาตามรายการของการตรวจสอบหนึ่งครั้ง ในสกุล USDT
providers[].price_trx	string | null	ราคาเดียวกันที่แปลงตามอัตราแลกเปลี่ยนปัจจุบัน จะเป็น null เมื่อไม่สามารถระบุอัตราแลกเปลี่ยนได้
providers[].available	boolean	สามารถสั่งตรวจสอบได้ในขณะนี้หรือไม่
providers[].reason	string	มีอยู่เฉพาะเมื่อ available เป็น false เท่านั้น ปัจจุบันคือ quota_exhausted
providers[].networks	array	สัญลักษณ์ย่อของเครือข่ายที่ผู้ให้บริการรายนี้ครอบคลุม
providers[].score_scale	object	ค่า min และ max ของมาตรวัดคะแนนของผู้ให้บริการเอง
trx_rate_usd	string | null	อัตราแลกเปลี่ยนที่ใช้สำหรับการแปลงสกุลเงิน
supported_languages	array	ภาษาของรายงาน ปัจจุบันรองรับเฉพาะ en เท่านั้น

ราคาจะแสดงเป็นสตริงทศนิยมด้วยเหตุผลเดียวกับตัวเลขในผลลัพธ์การคัดกรอง — ดูที่ ตัวเลขเป็นสตริง ค่า score_scale เป็นตัวเลขจากทางเรา ไม่ใช่ตัวเลขของผู้ให้บริการ จึงยังคงเป็นตัวเลข JSON

เอ็นด์พอยต์นี้มีไว้สำหรับอะไร

นี่คือรายชื่อผู้ให้บริการ ฟิลด์ provider ของการตรวจสอบเป็นสตริงอิสระในสกีมา แทนที่จะเป็นชุดการแจกแจงแบบระบุค่า (enumeration) เพื่อป้องกันไม่ให้ผู้ให้บริการรายใหม่ ส่งผลกระทบต่อระบบของผู้ใช้ที่มีการตรวจสอบความถูกต้องของการตอบกลับ ผลลัพธ์คือ รายชื่อปัจจุบันจะอยู่ในส่วนของข้อมูล ไม่ได้กำหนดตายตัวในสกีมา: อ่านข้อมูลได้ที่นี่

นอกจากนี้ยังเป็นรายชื่อเครือข่ายอีกด้วย การจับคู่มีความสำคัญ — ผู้ให้บริการอาจไม่ได้ครอบคลุม ทุกเครือข่ายเสมอไป การสั่งตรวจสอบสำหรับคู่ที่ไม่ครอบคลุม จะส่งผลลัพธ์กลับมาเป็น 4004 ก่อนที่จะมีการเรียกเก็บเงินใดๆ

และยังเป็นแหล่งที่มาของมาตรวัดคะแนน คะแนน 7 จากผู้ให้บริการรายหนึ่ง และ 0.7 จากอีกรายหนึ่งนั้นไม่ใช่ค่าที่เหมือนกัน และไม่มีสิ่งใดในตัวเลขนั้นที่บ่งบอกว่า มันสังกัดอยู่ในมาตรวัดใด นอกจากนี้ มาตรวัดจะถูกส่งมาพร้อมกับผลลัพธ์การคัดกรองทุกรายการ ใน risk.scale อยู่แล้ว ดังนั้นการผสานระบบที่อ่านเฉพาะผลลัพธ์ จึงไม่จำเป็นต้องใช้เอ็นด์พอยต์นี้เลย

ผู้ให้บริการที่บัญชีของคุณไม่สามารถใช้งานได้จะไม่ปรากฏในรายการ BitOK มีการจำกัดการใช้งาน และบัญชีที่อยู่นอก allowlist จะไม่เห็นผู้ให้บริการนี้ที่นี่ และจะถูกปฏิเสธที่ POST /apiv2/screening ด้วยรหัส 4002

สิ่งที่เปลี่ยนแปลงจากเวอร์ชัน 1

เวอร์ชัน 1 ยังส่งคืน supported_formats กลับมาด้วย ฟิลด์ดังกล่าวเป็นของรูปแบบคำขอในเวอร์ชัน 1 ที่รูปแบบผลลัพธ์จะถูกกำหนดไว้ตั้งแต่ตอนสร้างคำสั่งซื้อ แต่ในเวอร์ชัน 2 จะไม่มีฟิลด์ดังกล่าวในคำขอ เนื่องจากรูปแบบการแสดงผลจะถูกเลือกในขั้นตอนการอ่านผลลัพธ์ รายการดังกล่าวจึงถูกตัดออกไป

จนถึงวันที่ 13 กันยายน 2026 รายการดังกล่าวเคยระบุรูปแบบไว้ 4 แบบ ได้แก่ rate, full, md และ pdf — ซึ่งในความเป็นจริงมีเพียงสองรูปแบบแรกเท่านั้นที่ถูกสร้างขึ้น การขอรูปแบบ pdf จะส่งคืนรูปแบบ full แบบทั่วไปกลับมาโดยไม่มีการแจ้งเตือน ในปัจจุบัน เอ็นด์พอยต์ทั้งสองเวอร์ชันจะระบุเฉพาะสิ่งที่ส่งคืนจริงเท่านั้น และเวอร์ชัน 1 จะปฏิเสธการขอ md และ pdf ในคำขอ แทนที่จะแทนที่ด้วยรูปแบบอื่นเงียบๆ

ส่วนเพิ่มราคาสำหรับผู้ใช้ย่อยจะรวมอยู่ใน price_trx แล้ว เช่นเดียวกับที่รวมอยู่ใน ยอดเงินที่ถูกเรียกเก็บจริง

ข้อผิดพลาด

RFC 9457, application/problem+json

รหัส	HTTP	กรณีที่เกิด
4010 / 4011	401	ไม่มีคีย์ API หรือคีย์หรือ IP ไม่ได้รับการยอมรับ

อัตราการจำกัดคำขอ

ใช้งานร่วมกับพาธ AML อื่นๆ ทั้งหมด: 5 คำขอต่อวินาที, 150 คำขอต่อนาที