API رایگان قیمت دلار، طلا، سکه و خودرو
API رایگان قیمت ارز، طلا، سکه و قیمت روز خودروی صفر به تومان با خروجی JSON، بدون ثبتنام و بدون کلید؛ CORS آزاد، بهروزرسانی هر چند دقیقه، نمونه کد curl، پایتون، PHP و جاوااسکریپت. فقط نام هدهد ویژن را با پیوند بیاورید.
آدرسها
| آدرس | کاربرد |
|---|---|
GET https://hodhodvision.ir/api/v1/open/prices/ | قیمت ارز، طلا و سکه؛ فیلتر با keys=usd,gold |
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 | درهم امارات | ۷۳,۱۴۱ تومان |
gold18 | طلای ۱۸ عیار (هر گرم) | ۲۴,۷۰۱,۷۰۰ تومان |
coin | سکه امامی | ۲۵۲,۶۷۰,۰۰۰ تومان |
nim | نیمسکه | ۱۳۲,۵۷۰,۰۰۰ تومان |
ons | اونس جهانی طلا | ۳,۸۶۷ دلار |
brent | نفت برنت | ۹۲ دلار |
btc | بیتکوین | ۶۴,۳۴۷ دلار |
eth | اتریوم | ۱,۸۲۲ دلار |
usdt | تتر | ۲۷۰,۱۱۶ تومان |
برندهای خودرو در API
audi— آئودی (۷ تیپ)artabanmotors— آرتابان (۱ تیپ)amico— آمیکو (۱ تیپ)avatar— آواتار (۱ تیپ)skywell— اسکایول (۱ تیپ)koda— اشکودا (۴ تیپ)mg— ام جی (۴ تیپ)mvm— ام وی ام (۱ تیپ)aventra— اونترا (۱ تیپ)opel— اپل (۳ تیپ)xtrim— اکستریم (۵ تیپ)irankhodro— ایران خودرو (۳۹ تیپ)eres— ایرس (۱ تیپ)baic— بایک (۳ تیپ)bestune— بستیون (۲ تیپ)mercedesbenz— بنز (۶ تیپ)bac— بک (۲ تیپ)bmw— بی ام و (۹ تیپ)byd— بی وای دی (۸ تیپ)beijing— بیجینگ (۲ تیپ)toyota— تویوتا (۷۲ تیپ)tigard— تیگارد (۴ تیپ)getta— جتا (۴ تیپ)jac— جک (۴ تیپ)geely— جیلی (۱ تیپ)dongfeng— دانگ فنگ (۵ تیپ)dacia— داچیا (۱ تیپ)dayun— دایون (۱ تیپ)renault— رنو (۴ تیپ)roewe— رووی (۱ تیپ)
نمونه کد
curl
curl "https://hodhodvision.ir/api/v1/open/prices/?keys=usd"JavaScript
const r = await fetch("https://hodhodvision.ir/api/v1/open/cars/?brand=saipa&limit=10");
const data = await r.json();Python
import requests
print(requests.get("https://hodhodvision.ir/api/v1/open/prices/", timeout=15).json())شرایط استفاده
استفاده رایگان است؛ نام «هدهد ویژن» را با پیوند به hodhodvision.ir نمایش دهید. حداکثر ۱۲۰ درخواست در دقیقه برای هر IP.
پرسشهای متداول
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 خبر» با کلید اختصاصی و فیلتر دلخواه ارائه میشود؛ یک روز تست رایگان دارد.