GET /apiv2/screening/providers

Các nhà cung cấp khả dụng cho tài khoản của bạn, kèm theo giá, các mạng lưới mà mỗi nhà cung cấp hỗ trợ và thang đo điểm số tương ứng.

Đây là hợp đồng phiên bản 2. Nó thay thế cho GET /apiv2/aml/providers, vốn vẫn tiếp tục hoạt động.

URL điểm cuối

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

Tiêu đề yêu cầu

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

Ví dụ yêu cầu

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

Phản hồi

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

Trường	Loại	Mô tả
providers[].provider	string	Tên nhà cung cấp, như được gửi trong phần thân của yêu cầu kiểm tra
providers[].price_usdt	string	Giá niêm yết của một lần kiểm tra, tính bằng USDT
providers[].price_trx	string | null	Cùng mức giá đó được quy đổi theo tỷ giá hiện tại. null khi tỷ giá không khả dụng
providers[].available	boolean	Liệu các lượt kiểm tra có thể được đặt ngay bây giờ hay không
providers[].reason	string	Chỉ xuất hiện khi available là false. Hiện tại là quota_exhausted
providers[].networks	array	Mã ticker của các mạng lưới mà nhà cung cấp này hỗ trợ
providers[].score_scale	object	min và max của chính thang đo điểm số từ nhà cung cấp
trx_rate_usd	string | null	Tỷ giá được sử dụng để quy đổi
supported_languages	array	Các ngôn ngữ báo cáo. Hiện tại chỉ có en

Giá là các chuỗi số thập phân vì cùng lý do với các con số trong kết quả sàng lọc — xem Số là chuỗi. score_scale là số liệu của chúng tôi chứ không phải của nhà cung cấp, vì vậy nó vẫn là một số JSON.

Endpoint này dùng để làm gì

Đây là danh sách các nhà cung cấp. Trường provider của một yêu cầu kiểm tra là một chuỗi tự do trong schema thay vì một enum, mục đích chính là để khi có nhà cung cấp mới sẽ không làm hỏng ứng dụng của bất kỳ ai đang xác thực phản hồi. Do đó, danh sách hiện tại nằm trong dữ liệu chứ không nằm trong schema: hãy đọc danh sách tại đây.

Đây cũng là danh sách các mạng lưới. Việc ghép cặp là rất quan trọng — một nhà cung cấp không nhất thiết phải hỗ trợ mọi mạng lưới. Đặt một lượt kiểm tra cho một cặp không được hỗ trợ sẽ trả về 4004 trước khi bất kỳ khoản phí nào được tính.

Và đây là nơi xác định thang đo. Điểm số 7 từ một nhà cung cấp và 0.7 từ một nhà cung cấp khác không phải là cùng một mức đánh giá, và bản thân con số không cho biết nó thuộc thang đo nào. Thang đo cũng được gửi kèm bên trong mỗi kết quả sàng lọc, tại risk.scale, vì vậy một tích hợp chỉ đọc kết quả thì hoàn toàn không cần đến endpoint này.

Nhà cung cấp mà tài khoản của bạn không thể sử dụng sẽ không được liệt kê. BitOK bị hạn chế, và các tài khoản nằm ngoài danh sách cho phép (allowlist) của nó sẽ không thấy nó ở đây và sẽ bị từ chối tại POST /apiv2/screening với mã 4002.

Những thay đổi so với phiên bản 1

Phiên bản 1 cũng trả về supported_formats. Trường đó thuộc về mô hình yêu cầu của phiên bản 1, nơi định dạng được cố định khi đơn hàng được tạo; trong phiên bản 2 không có trường như vậy trong yêu cầu, bởi vì định dạng hiển thị được chọn khi đọc kết quả, do đó danh sách này đã bị loại bỏ.

Cho đến ngày 13 tháng 9 năm 2026, danh sách đó đã nêu tên bốn định dạng — rate, full, md và pdf — trong đó chỉ có hai định dạng từng được tạo ra. Yêu cầu pdf sẽ âm thầm trả về full thông thường. Cả hai endpoint hiện chỉ nêu tên những gì chúng thực sự trả về, và phiên bản 1 từ chối md và pdf trong một yêu cầu thay vì âm thầm thay thế bằng định dạng khác.

Mức chênh lệch giá (markup) của người dùng phụ (sub-user) đã được bao gồm trong price_trx, chính xác như cách nó được tính vào số tiền bị trừ.

Lỗi

RFC 9457, application/problem+json.

Mã	HTTP	Khi nào
4010 / 4011	401	Không có khóa API, hoặc khóa hay IP không được chấp nhận

Giới hạn tỷ lệ yêu cầu

Dùng chung với mọi đường dẫn AML khác: 5 yêu cầu mỗi giây, 150 yêu cầu mỗi phút.