GET /apiv2/screening/price

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

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

URL ปลายทาง

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

ส่วนหัวของคำขอ

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

พารามิเตอร์การสืบค้น

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
provider	string	ใช่	elliptic หรือ bitok ไม่มีค่าเริ่มต้น

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

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

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

การตอบกลับ

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

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

can_afford เป็นเพียงการอำนวยความสะดวก ไม่ใช่การกันวงเงิน อัตราแลกเปลี่ยนมีการเปลี่ยนแปลงและยอดคงเหลือ อาจถูกใช้ไปกับส่วนอื่นระหว่างการเรียกนี้กับการตรวจสอบ คำตอบที่ถือเป็นที่สิ้นสุด คือการตรวจสอบจริง ซึ่งจะปฏิเสธด้วยรหัส 1004 และระบุจำนวนเงิน

จำนวนเงินจะเสนอด้วยทศนิยมหกตำแหน่ง — นั่นคือความแม่นยำที่ TRX ถูกหัก ออกจากยอดคงเหลือจริง ไม่ใช่รูปแบบการแสดงผล ทั้งหมดเป็นสตริงทศนิยม ด้วยเหตุผลที่ระบุไว้ใน ตัวเลขเป็นสตริง

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

ข้อผิดพลาด

RFC 9457, application/problem+json

รหัส	HTTP	เงื่อนไข
4001	400	provider ขาดหายไป หรือไม่ใช่ผู้ให้บริการที่รู้จัก
4002	403	มีผู้ให้บริการอยู่ แต่ไม่พร้อมใช้งานสำหรับบัญชีของคุณ
4010 / 4011	401	ไม่มีคีย์ API หรือคีย์/IP ไม่ได้รับการยอมรับ
5030	503	ผู้ให้บริการไม่พร้อมใช้งานชั่วคราว

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

ขีดจำกัดอัตราการเรียกใช้งาน

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