GET /apiv2/screening/price

Harga satu kali pemeriksaan dari satu penyedia, dan apakah saldo Anda mencukupinya.

Ini adalah kontrak versi 2. Kontrak ini menggantikan GET /apiv2/aml/price, yang tetap berfungsi.

URL Endpoint

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

Header Permintaan

Header	Wajib	Deskripsi
X-API-KEY	Ya	Kunci API Anda dari dasbor Netts

Parameter Kueri

Parameter	Tipe	Wajib	Deskripsi
provider	string	Ya	elliptic atau bitok. Tidak ada nilai bawaan

Pada versi 1, parameter ini secara bawaan bernilai elliptic, sehingga pemanggil yang menghilangkannya diberikan penawaran harga untuk penyedia yang tidak mereka sebutkan. Isi (body) pemeriksaan memiliki aturan yang sama.

Contoh Permintaan

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

Respons

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

Bidang	Tipe	Deskripsi
provider	string	Penyedia yang ditanyakan
price_usdt	string	Harga daftar untuk satu kali pemeriksaan, dalam USDT
price_trx	string | null	Harga yang sama yang dikonversi pada kurs saat ini
available	boolean	Apakah pemeriksaan dapat dipesan saat ini
reason	string	Hanya ada jika available bernilai false. Saat ini quota_exhausted
networks	array	Simbol (ticker) jaringan yang dicakup penyedia ini
score_scale	object	min dan max dari skala skor milik penyedia itu sendiri
trx_rate_usd	string | null	Kurs yang digunakan untuk konversi
balance_trx	string	Saldo TRX Anda
can_afford	boolean	balance_trx setidaknya sebesar price_trx

can_afford adalah fitur bantuan kemudahan, bukan reservasi. Kurs bergerak dan saldo dapat dibelanjakan di tempat lain di antara panggilan ini dan pemeriksaan sesungguhnya. Jawaban yang mutlak adalah pemeriksaan itu sendiri, yang akan menolak dengan kode 1004 dan menyatakan jumlahnya.

Jumlah dicantumkan hingga enam tempat desimal — itu adalah presisi pengurangan TRX yang sebenarnya dari saldo, bukan sekadar pilihan tampilan. Jumlah tersebut berupa string desimal karena alasan yang dijelaskan dalam Angka adalah string.

Markup sub-pengguna sudah termasuk dalam price_trx, persis seperti yang disertakan dalam jumlah yang ditagihkan.

Kesalahan

RFC 9457, application/problem+json.

Kode	HTTP	Kapan
4001	400	provider tidak ada atau bukan penyedia yang dikenal
4002	403	Penyedia ada tetapi tidak tersedia untuk akun Anda
4010 / 4011	401	Tidak ada kunci API, atau kunci atau IP tidak diterima
5030	503	Penyedia sedang tidak tersedia untuk sementara waktu

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

Batas Frekuensi Panggilan

Berbagi batas dengan setiap jalur AML lainnya: 5 permintaan per detik, 150 per menit.