GET /apiv2/screening/price

Bir sağlayıcıdan yapılacak tek bir kontrolün fiyatı ve bakiyenizin bunu karşılayıp karşılamadığı.

Bu, sürüm 2 sözleşmesidir. Çalışmaya devam eden GET /apiv2/aml/price uç noktasının yerini alır.

Uç Nokta URL'si

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

İstek Üstbilgileri

Header	Zorunlu	Açıklama
X-API-KEY	Evet	Netts panelinizden alınan API anahtarınız

Sorgu Parametreleri

Parametre	Tür	Zorunlu	Açıklama
provider	string	Evet	elliptic veya bitok. Varsayılan bir değer yoktur

Sürüm 1'de bu parametre varsayılan olarak elliptic değerini alır; bu nedenle parametreyi belirtmeyen bir çağırıcıya, adını belirtmediği bir sağlayıcı için fiyat teklif edilirdi. Bir kontrolün gövdesi de aynı kurala sahiptir.

Örnek İstek

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

Yanıt

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

Alan	Tür	Açıklama
provider	string	Sorgulanan sağlayıcı
price_usdt	string	USDT cinsinden tek bir kontrolün liste fiyatı
price_trx	string | null	Güncel kur üzerinden dönüştürülmüş aynı fiyat
available	boolean	Kontrollerin şu anda sipariş edilip edilemeyeceği
reason	string	Yalnızca available değeri false olduğunda mevcuttur. Şu anda quota_exhausted
networks	array	Bu sağlayıcının kapsadığı ağ sembolleri
score_scale	object	Sağlayıcının kendi puan ölçeğinin min ve max değerleri
trx_rate_usd	string | null	Dönüşüm için kullanılan kur
balance_trx	string	TRX bakiyeniz
can_afford	boolean	balance_trx değerinin en az price_trx kadar olması durumu

can_afford bir kolaylıktır, bir rezervasyon değildir. Bu çağrı ile kontrol arasında kur değişebilir ve bakiye başka bir yerde harcanabilir. Kesin yanıt, 1004 ile işlemi reddeden ve tutarları belirten kontrolün kendisidir.

Tutarlar altı ondalık basamağa kadar belirtilir — bu bir görüntüleme tercihi değil, TRX'in bakiyeden fiilen tahsil edildiği hassasiyettir. Sayılar metindir bölümünde açıklanan nedenden ötürü bunlar ondalık metinlerdir (string).

Alt kullanıcı kâr marjı, tahsil edilen tutara dahil edildiği gibi price_trx değerine de dahil edilir.

Hatalar

RFC 9457, application/problem+json.

Kod	HTTP	Durum
4001	400	provider eksik veya bilinen bir sağlayıcı değil
4002	403	Sağlayıcı mevcut ancak hesabınız için kullanılabilir değil
4010 / 4011	401	API anahtarı yok veya kabul edilmeyen bir anahtar ya da IP
5030	503	Sağlayıcı geçici olarak kullanılamıyor

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

İstek Hızı Sınırları

Diğer tüm AML yollarıyla ortaktır: saniyede 5 istek, dakikada 150 istek.