پاسخ مستقیم همین سرور را ببینید و کد درخواست را بردارید.
REST / JSON · v1
GET/api/v1/prices/
هر بار ارسال، یک درخواست از سهمیه را مصرف میکند.
بدون برنامهنویسی
تابلوی قیمت را در سایت خودتان بگذارید
ظاهر تابلو را انتخاب کنید، کد آماده را کپی کنید و داخل بخش HTML سایت قرار دهید. نرخها هر ۱۰ ثانیه بازخوانی میشوند؛ زمان دریافت واقعی منبع کنار نرخ قابل تشخیص است.
پیشنمایش زنده
در حال دریافت تابلوی قیمت…
نسخهv1
فرمتJSON
کش پاسخ۵ ثانیه
محدودیت۶۰ درخواست/دقیقه
GET/api/v1/symbols/
فهرست نمادها
نماد، نام فارسی، دسته، واحد و ارز هر دارایی؛ برای ساخت انتخابگر یا دیدبان استفاده کنید. این مسیر به موجودبودن قیمت وابسته نیست.
GET/api/v1/prices/
همهٔ قیمتهای فعلی
فهرست آخرین نرخ موجود، وضعیت، درصد تغییر، واحد و زمان دریافت را برمیگرداند.
پارامتر range یکی از مقادیر day، week، month یا quarter است.
GET https://mazanehyab.ir/api/v1/history/usd/?range=month
قرارداد داده
قیمت را درست تفسیر کنید
عدد، واحد و مقدار خالی
قیمت و درصدها رشته اعشاری هستند تا دقت حفظ شود. IRT یعنی تومان و USD یعنی دلار آمریکا. null یعنی داده موجود نیست؛ آن را صفر نشان ندهید.
زمان پاسخ با زمان قیمت فرق دارد
meta.as_of زمان پاسخ سرور و fetched_at آخرین دریافت موفق است. source_at فقط در صورت وجود زمان معتبر منبع مقدار دارد. پاسخ تازه، لزوماً نرخ تازه نیست.
تاریخچه و نمودار
نقاط از قدیمی به جدید و حداکثر ۱۸۰ عدد هستند؛ آخرین مشاهده هر دقیقه، ساعت یا روز UTC انتخاب میشود. آمار stats از تمام مشاهدات بازه محاسبه میشود؛ این داده کندل OHLC نیست. تاریخچه خالی با points: [] و stats: {} برمیگردد.
اتصال پایدار
فاصله refresh_seconds را رعایت کنید. در خطای ۴۲۹ بهاندازه Retry-After ثانیه صبر کنید. سهمیه بر اساس IP است؛ شبکههای مشترک ممکن است سهمیه مشترک داشته باشند. درخواست OPTIONS سهمیه مصرف نمیکند.
وضعیت هر نرخ
status
معنی
recent
دریافت در ۱۵ دقیقه اخیر؛ زمان منبع موجود است.
unverified
دریافت در ۱۵ دقیقه اخیر؛ زمان انتشار منبع تأیید نشده.
400 ورودی نامعتبر404 نماد یا مسیر ناموجود405 متد غیرمجاز429 پایان سهمیه500 خطای موقت سرور
API عمومی فقط خواندنی است و برای اتصال از دامنه دیگر نیازی به کوکی یا کلید ندارد. ماشین حساب داخلی سایت جزو API عمومی نسخه یک نیست. نام منابع در پاسخها و توضیح روش دریافت در صفحه منابع موجود است.