راهنمای دریافت قیمت ارزها

‫برای ‬‫نمایش‬ ‫قیمت های‬ ‫بازار‪،‬‬ ‫ابتدا‬ ‫اطلاعات ‫اولیه‬ ‫از‬ ‫طریق‬ ‫‪API‬‬ ‫‪REST‬‬ ‫دریافت‬ ‫میشود‬ ‫و‬ ‫سپس‬ ‫قیمت ها‬ ‫به صورت‬ ‫لحظه ای ‫از‬ ‫طریق‬ ‫‪WebSocket‬‬
‫بروزرسانی ‬‫میشوند‪.‬‬

‫‪.1‬‬‫دریافت‬ ‫داده‬ ‫اولیه‬ ‫(‪API‬‬ ‫‪REST‬‬)

‫در‬‫ابتدای‬ ‫بارگذاری‬ ‫صفحه‪،‬‬ ‫لیست‬ ‫ارزها‬ ‫و‬ ‫اطلاعات ‫اولیه‬ ‫هر‬ ‫جفت ارز‬ ‫از‬ ‫طریق‬ ‫‪API‬‬ ‫دریافت‬ ‫میشود‪.‬‬

‫‪Endpoint‬‬
‫‪/market/currency/base‬‬‫‪GET‬‬

Example
https://admin.example.com/market/currency/base



‫پارامتر های  درخواست‬ :

نام پارامتر	توضیحات	مثال
base_currency_symbol	ارز پایه	USDT
page	شماره صفحه	1
main_currency_symbol	جستجو بر اساس نماد ارز (اختیاری)	BTC

نمونه درخواست:

https://admin.example.com/market/currency/base?base_currency_symbol=USDT&page=1&main_currency_symbol=BTC
‫‪
‫خروجی‬ پاسخ این api شامل اطلاعات اولیه هر جفت ارز میباشد.

۲- ‫‪‫دریافت‬ ‫قیمت‬ ‫لحظه ای ‫WebSocket‬‬

 ‫پس از ‫دریافت‬ ‫اطلاعات ‫اولیه‪،‬‬ ‫برای‬ ‫بروزرسانی‬ ‫لحظه ای ‫قیمت ها‬ ‫از‬ ‫‪Socket.IO‬‬ ‫استفاده‬ ‫کنید‪.‬‬

آدرس اتصال :
‫‪wss://wss.emaple.com/spot‬‬

‫دریافت‬ ‫قیمت‬ ‫جفت ارزها‬ ‫بر‬ ‫اساس‬ ‫تتر USDT‬‬ :

 

‫‪Message‬‬	‫‪Event‬‬
‫‪"pair":  "BTC_USDT"	‫‪pair:price‬‬

‫دریافت‬ ‫قیمت‬ ‬ ‫تتر به ریال  USDT/IRT :

Message‬‬	Event‬‬
‫‪"pair":  "USDT_IRT"	‫‪fiat:USDT_IRT‬‬

3- ‫‪‫روند دریافت اطلاعات قیمت

‫‪.1‬‬‫با‬ ‫استفاده‬ ‫از‬ ‫‪API‬‬ ‫‪/market/currency/base‬‬ ‫لیست‬ ‫بازار‬ ‫و‬ ‫قیمت‬ ‫اولیه‬ ‫دریافت‬ ‫میشود‪.‬‬
‫‪.2‬‬‫اتصال‬ ‫به‬ ‫‪WebSocket‬‬ ‫برقرار‬ ‫میشود‪.‬‬
‫‪.3‬‬‫برای‬ ‫هر‬ ‫جفت ارز‬ ‫مورد‬ ‫نیاز‪،‬‬ ‫‪Event‬‬ ‫‪pair:price‬‬ ‫ارسال‬ ‫میشود‪.‬‬
‫‪.4‬‬‫برای‬ ‫دریافت‬ ‫قیمت‬ ‫تتر ‫به‬ ‫ریال‪،‬‬ ‫‪Event‬‬ ‫‪fiat:USDT_IRT‬‬ ‫ارسال‬ ‫میشود‪.‬‬
‫‪.5‬‬‫قیمت های‬ ‫دریافتی‬ ‫از‬ ‫‪WebSocket‬‬ ‫به صورت‬ ‫لحظه ای ‫جایگزین‬ ‫قیمت های‬ ‫اولیه‬ ‫‪API‬‬ ‫میشوند‪.‬‬

‫نکته‪:‬‬‫هر‬ ‫دو‬ ‫سرویس‬ ‫‪WebSocket‬‬ ‫از‬ ‫یک‬ ‫آدرس‬ ‫اتصال‬ ‫استفاده‬ ‫میکنند‬ ‫و‬ ‫تنها‬ ‫مقدار‬ ‫‪Event‬‬ ‫و‬ ‫‪pair‬‬ ‫با‬ ‫یکدیگر‬ ‫متفاوت‬ ‫است‪.‬‬