ایران‌فی
ورود
خبر

شاخص‌یاب

جست‌وجوی نام یا نماد یک دارایی

ایران‌فی · اطلاعات و خدمات

وب‌سرویس ایران‌فی

راهنمای APIهای موجود قیمت و تاریخچه، با مثال قابل اجرا و توضیح واحد و زمان هر داده.

آزمایش یک درخواست واقعی

برای دیدن پاسخ، درخواست را اجرا کنید.

{}

قیمت‌های بازار

درخواست GET، شناسه‌ها را با کاما می‌گیرد. پاسخ شامل واحد هر دارایی، قیمت، تغییر و زمان منبع است. مقدار null را صفر فرض نکنید؛ زمان دریافت با زمان معامله تفاوت دارد.

GET https://iranphi.ir/api/markets?ids=price_dollar_rl,geram18,crypto-bitcoin

تاریخچهٔ قیمت

برای روند از time و value استفاده کنید. زمان نقاط بر حسب میلی‌ثانیهٔ یونیکس است. در پاسخ، unit واحد مقدار را نشان می‌دهد. بازه‌های 1h، 1d، 1w، 1m، 3m، 6m و 1y پشتیبانی می‌شوند.

GET https://iranphi.ir/api/markets/history?id=price_dollar_rl&range=1m

نمونهٔ جاوااسکریپت

const response = await fetch('/api/markets?ids=price_dollar_rl');
if (!response.ok) throw new Error('HTTP ' + response.status);
const data = await response.json();
console.log(data);

شرایط دسترسی

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

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

پرسش‌های متداول

زمان نقاط تاریخچه با چه واحدی است؟

فیلد time بر حسب میلی‌ثانیهٔ یونیکس است. واحد قیمت از فیلد unit همان پاسخ خوانده می‌شود.

مقدار null را صفر حساب کنم؟

خیر؛ null یا نبود یک فیلد یعنی مقدار قابل استفاده‌ای در پاسخ موجود نیست. زمان منبع، وضعیت دریافت و واحد را همراه مقدار بررسی کنید.