API رایگان قیمت دلار و یورو
قیمت دلار آمریکا، یورو، پوند انگلیس و درهم امارات به تومان، با تغییر و درصد تغییر لحظهای. بدون ثبتنام و بدون کلید مستقیم از مرورگر یا سرور صدا بزنید.
نمونهی کاربرد
مناسب ماشینحساب ارز، سایتهای صرافی، فروشگاههای اینترنتی با قیمت ارزی و اپهای سفر.
آدرسهای API
| آدرس | کاربرد |
|---|---|
GET https://hodhodvision.ir/api/v1/open/prices/ | قیمت ارز، طلا، سکه و رمزارز؛ فیلتر با keys=usd,gold18 |
GET https://hodhodvision.ir/api/v1/open/prices/<key>/ | قیمت یک قلم |
GET https://hodhodvision.ir/api/v1/open/cars/ | قیمت خودرو؛ فیلتر brand, model, year, q, min_price, max_price |
GET https://hodhodvision.ir/api/v1/open/cars/brands/ | برندها و محدوده قیمت |
قیمت لحظهای (نمونهی خروجی زنده)
| کلید | عنوان | قیمت |
|---|---|---|
usd | دلار آمریکا | ۲۶۹,۹۷۰ تومان |
eur | یورو | ۲۹۶,۹۹۰ تومان |
gbp | پوند انگلیس | ۳۵۵,۰۸۰ تومان |
aed | درهم امارات | ۷۳,۵۱۵ تومان |
نمونه کد
curl
curl "https://hodhodvision.ir/api/v1/open/prices/?keys=usd,eur,gbp,aed"JavaScript
const r = await fetch("https://hodhodvision.ir/api/v1/open/prices/?keys=usd,eur,gbp,aed");
const data = await r.json();Python
import requests
print(requests.get("https://hodhodvision.ir/api/v1/open/prices/?keys=usd,eur,gbp,aed", timeout=15).json())PHP
<?php
$data = json_decode(file_get_contents("https://hodhodvision.ir/api/v1/open/prices/?keys=usd,eur,gbp,aed"), true);ویجت آماده قیمت ارز و طلا برای سایت شما
بدون برنامهنویسی: این کد را در صفحهی خود بگذارید تا جدول قیمت زنده نمایش داده شود.
<iframe src="https://hodhodvision.ir/embed/prices?keys=usd,eur,gold18,coin" width="100%" height="230" style="border:0"></iframe>
<p>منبع: <a href="https://hodhodvision.ir/prices">هدهد ویژن</a></p>شرایط استفاده
استفاده رایگان است؛ نام «هدهد ویژن» را با پیوند به hodhodvision.ir نمایش دهید. حداکثر ۱۲۰ درخواست در دقیقه برای هر IP؛ نتیجه را کش کنید.
API خبر با فیلتر دلخواه · مشخصات OpenAPI · قیمت روز خودرو
پرسشهای متداول
API قیمت ارز رایگان است؟
بله. API قیمت ارز هدهد ویژن رایگان است، ثبتنام و کلید نمیخواهد و CORS آزاد دارد. فقط نام «هدهد ویژن» را با پیوند نمایش دهید.
چطور قیمت ارز را در سایت خودم نمایش دهم؟
یک درخواست GET به آدرس نمونه بزنید، JSON را بخوانید و فیلد value (یا price_toman برای خودرو) را در صفحه بگذارید. نتیجه را حداقل یک دقیقه کش کنید.
قیمت ارز هر چند وقت بهروز میشود؟
قیمت ارز، طلا و رمزارز هر چند دقیقه بهروز میشود و فیلد updated_at زمان آخرین بهروزرسانی هر قلم را نشان میدهد.
API قیمت ارز و خودرو هدهد ویژن رایگان است؟
بله. قیمت دلار، یورو، طلا، سکه و قیمت روز خودروی صفر بهصورت رایگان، بدون ثبتنام و بدون کلید در دسترس است. تنها شرط، نمایش نام «هدهد ویژن» با پیوند به سایت است.
خروجی در چه قالبی است؟
JSON با کدگذاری UTF-8. مبلغها عدد هستند (تومان) و زمانها بهصورت ISO 8601 میآیند تا در هر زبان برنامهنویسی مستقیم استفاده شوند.
قیمتها هر چند وقت بهروز میشوند؟
قیمت ارز، طلا و سکه هر چند دقیقه و قیمت خودرو یک بار در روز، ساعت ۱۲ ظهر به وقت تهران. فیلد updated_at زمان آخرین بهروزرسانی هر قلم را نشان میدهد.
از مرورگر هم میشود صدا زد؟
بله. این API هدر CORS آزاد دارد و میتوانید مستقیم از جاوااسکریپت سایت خود فراخوانی کنید. پاسخها کش میشوند؛ لطفاً بیشتر از یک بار در دقیقه نپرسید.
محدودیت تعداد درخواست چقدر است؟
تا ۱۲۰ درخواست در دقیقه برای هر IP. بیشتر از آن پاسخ ۴۲۹ همراه با هدر Retry-After میگیرید. برای بار زیاد، نتیجه را در سرور خود کش کنید.
چطور بر اساس برند و قیمت خودرو فیلتر کنم؟
در /open/cars/ از پارامترهای brand، model، year، q، min_price و max_price استفاده کنید؛ برای صفحهبندی limit و offset. فهرست برندها در /open/cars/brands/ است.
قیمت خودرو قیمت قطعی معامله است؟
نه؛ برآورد بازار آزاد خودروی صفر است و ممکن است با قیمت واقعی معامله فرق کند. برای تصمیم خرید حتماً با نمایندگی یا فروشنده تأیید کنید.
خبر هم میتوانم از همین API بگیرم؟
خبرها در «API خبر» با کلید اختصاصی و فیلتر دلخواه ارائه میشود؛ یک روز تست رایگان دارد.
کدام قیمتها در API رایگان هست؟
دلار، یورو، پوند، درهم، تتر، طلای ۱۸ عیار، سکه امامی، نیمسکه، اونس جهانی طلا، نفت برنت، بیتکوین و اتریوم؛ همراه تغییر و درصد تغییر هر قلم.
API قیمت خودرو برای فروشگاه یا سایت نمایشگاهی مناسب است؟
بله. با برند، مدل، سال و بازه قیمت فیلتر کنید و فهرست را مستقیم در سایت خود نمایش دهید؛ فقط ذکر منبع «هدهد ویژن» با پیوند الزامی است.