برای وب‌سایت و اپلیکیشن

API عمومی مظنه یاب

قیمت‌های تازه و تاریخچهٔ ثبت‌شدهٔ طلا، سکه، نقره و ارز را با JSON دریافت کنید یا تابلوی آماده را در سایت خودتان قرار دهید.

بدون کلید API · فقط خواندنی

یک درخواست واقعی بفرستید

پاسخ مستقیم همین سرور را ببینید و کد درخواست را بردارید.

REST / JSON · v1
GET/api/v1/prices/

هر بار ارسال، یک درخواست از سهمیه را مصرف می‌کند.

بدون برنامه‌نویسی

تابلوی قیمت را در سایت خودتان بگذارید

ظاهر تابلو را انتخاب کنید، کد آماده را کپی کنید و داخل بخش HTML سایت قرار دهید. نرخ‌ها هر ۱۰ ثانیه بازخوانی می‌شوند؛ زمان دریافت واقعی منبع کنار نرخ قابل تشخیص است.

پیش‌نمایش زنده
در حال دریافت تابلوی قیمت…
نسخهv1
فرمتJSON
کش پاسخ۵ ثانیه
محدودیت۶۰ درخواست/دقیقه
GET/api/v1/symbols/

فهرست نمادها

نماد، نام فارسی، دسته، واحد و ارز هر دارایی؛ برای ساخت انتخاب‌گر یا دیدبان استفاده کنید. این مسیر به موجودبودن قیمت وابسته نیست.

GET/api/v1/prices/

همهٔ قیمت‌های فعلی

فهرست آخرین نرخ موجود، وضعیت، درصد تغییر، واحد و زمان دریافت را برمی‌گرداند.

fetch('https://mazanehyab.ir/api/v1/prices/')
  .then(response => {
    if (!response.ok) throw new Error('HTTP ' + response.status);
    return response.json();
  })
  .then(result => console.log(result.data))
  .catch(error => console.error(error));
GET/api/v1/prices/{symbol}/

قیمت یک دارایی

برای نمونه از نمادهای gold18، emami، silver999 و usd استفاده کنید.

curl "https://mazanehyab.ir/api/v1/prices/gold18/"
GET/api/v1/history/{symbol}/

تاریخچه و آمار بازه

پارامتر 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دریافت در ۱۵ دقیقه اخیر؛ زمان انتشار منبع تأیید نشده.
staleاز دریافت بیش از ۱۵ دقیقه گذشته است.
expiredاز دریافت بیش از ۲۴ ساعت گذشته است.
unavailableهیچ قیمت ثبت‌شده‌ای وجود ندارد.

خطاهای قابل پیش‌بینی

خطاها نیز JSON هستند: { "error": { "code": "not_found", "message": "…" } }

400 ورودی نامعتبر404 نماد یا مسیر ناموجود405 متد غیرمجاز429 پایان سهمیه500 خطای موقت سرور

API عمومی فقط خواندنی است و برای اتصال از دامنه دیگر نیازی به کوکی یا کلید ندارد. ماشین حساب داخلی سایت جزو API عمومی نسخه یک نیست. نام منابع در پاسخ‌ها و توضیح روش دریافت در صفحه منابع موجود است.

در مظنه یاب جستجو کنید

جستجو در مقاله‌ها