API عمومی

داده‌های قیمت این سایت از طریق یک API عمومی و رایگان در دسترس توسعه‌دهنده‌هاست. پاسخ همه‌ی درخواست‌ها JSON است و برای استفاده نیازی به ثبت‌نام نیست.

نقطه‌های اصلی

GET /api/v1/prices
GET /api/v1/prices/USD
GET /api/v1/history/USD?interval=d1&limit=30
GET /api/v1/convert?amount=100&from=USD&to=EUR
GET /api/v1/assets
GET /api/v1/search?q=دلار

هر نقطه چه می‌دهد؟

• مسیر /api/v1/prices قیمت لحظه‌ای همه‌ی دارایی‌های فعال سایت را برمی‌گرداند.
• مسیر /api/v1/prices/USD فقط قیمت یک دارایی را می‌دهد. به‌جای USD نماد هر دارایی را می‌توانید بگذارید، مثلاً GOLD18 برای طلای ۱۸ عیار یا SEKE_EMAMI برای سکه امامی.
• مسیر /api/v1/history/USD تاریخچه‌ی قیمت را برای نمودار می‌دهد. پارامتر interval بازه‌ی هر نقطه را تعیین می‌کند و limit تعداد نقطه‌ها را.
• مسیر /api/v1/convert مقدار یک ارز یا دارایی را با نرخ لحظه‌ای به دیگری تبدیل می‌کند. پارامترها amount و from و to هستند.
• مسیر /api/v1/assets فهرست دارایی‌هایی را که سایت پوشش می‌دهد می‌دهد، و /api/v1/search بر اساس نام یا نماد جست‌وجو می‌کند.

محدودیت و شرایط استفاده

برای هر IP حداکثر ۱۲۰ درخواست در دقیقه مجاز است. اگر از داده‌ها در سایت یا اپلیکیشن خودتان استفاده می‌کنید، لطفاً منبع را ذکر کنید و لینک fm5.ir را بگذارید.

چند نکته‌ی کاربردی

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

اگر برای پروژه‌تان به حجم بیشتری از درخواست نیاز دارید، با ایمیل صفحه‌ی تماس هماهنگ کنید.