GET /apiv2/screening/price

Giá của một lần kiểm tra từ một nhà cung cấp, và liệu số dư của bạn có đủ chi trả hay không.

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

URL endpoint

GET https://netts.io/apiv2/screening/price?provider=elliptic

Header 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

Tham số truy vấn

Tham số	Loại	Bắt buộc	Mô tả
provider	chuỗi	Có	`elliptic` hoặc `bitok`. Không có giá trị mặc định

Trong phiên bản 1, tham số này có giá trị mặc định là elliptic, vì vậy người gọi bỏ qua nó đã được báo giá cho một nhà cung cấp mà họ không nêu tên. Nội dung của một lần kiểm tra cũng có quy tắc tương tự.

Ví dụ yêu cầu

bash

curl "https://netts.io/apiv2/screening/price?provider=elliptic" \
  -H "X-API-KEY: your_api_key"

Phản hồi

json

{
  "schema_version": 2,
  "provider": "elliptic",
  "price_usdt": "0.98",
  "price_trx": "2.884881",
  "available": true,
  "networks": ["trx", "eth", "btc", "..."],
  "score_scale": { "min": 0, "max": 10 },
  "trx_rate_usd": "0.339702",
  "balance_trx": "113.910000",
  "can_afford": true
}

Trường	Loại	Mô tả
provider	chuỗi	Nhà cung cấp được hỏi
price_usdt	chuỗi	Giá niêm yết của một lần kiểm tra, tính bằng USDT
price_trx	chuỗi \| null	Cùng một mức giá được quy đổi theo tỷ giá hiện tại
available	boolean	Liệu các lần kiểm tra có thể được đặt ngay bây giờ hay không
reason	chuỗi	Chỉ xuất hiện khi `available` là `false`. Hiện tại là `quota_exhausted`
networks	mảng	Mã các mạng mà nhà cung cấp này hỗ trợ
score_scale	đối tượng	`min` và `max` của thang điểm riêng của nhà cung cấp
trx_rate_usd	chuỗi \| null	Tỷ giá được sử dụng để quy đổi
balance_trx	chuỗi	Số dư TRX của bạn
can_afford	boolean	`balance_trx` tối thiểu bằng `price_trx`

can_afford là một tiện ích, không phải là sự bảo lưu. Tỷ giá biến động và số dư có thể được chi tiêu ở nơi khác giữa lệnh gọi này và lần kiểm tra. Câu trả lời chính xác nhất là chính lần kiểm tra đó, nó sẽ từ chối với mã 1004 và nêu rõ các số tiền.

Số tiền được báo giá đến sáu chữ số thập phân — đó là độ chính xác mà TRX thực sự bị trừ khỏi số dư, không phải là tùy chọn hiển thị. Chúng là các chuỗi thập phân vì lý do được nêu trong Các số là chuỗi.

Phần chênh lệch giá cho người dùng phụ đã đượ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
`4001`	400	`provider` bị thiếu hoặc không phải là nhà cung cấp đã biết
`4002`	403	Nhà cung cấp tồn tại nhưng không khả dụng cho tài khoản của bạn
`4010` / `4011`	401	Không có khóa API, hoặc khóa hay IP không được chấp nhận
`5030`	503	Nhà cung cấp tạm thời không khả dụng

json

{
  "type": "https://doc.netts.io/api/v2/errors/provider-unavailable-for-account",
  "title": "Provider is not available for your account",
  "status": 403,
  "detail": "BitOK is not available for your account. Please use Elliptic.",
  "instance": "/apiv2/screening/price",
  "code": 4002
}

Giới hạn tốc độ

Được chia sẻ 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.

GET /apiv2/screening/price ​

URL endpoint ​

Header yêu cầu ​

Tham số truy vấn ​

Ví dụ yêu cầu ​

Phản hồi ​

Lỗi ​

Giới hạn tốc độ ​