هدهد ویژن

API رایگان قیمت دلار، طلا، سکه و خودرو

API رایگان قیمت ارز، طلا، سکه و قیمت روز خودروی صفر به تومان با خروجی JSON، بدون ثبت‌نام و بدون کلید؛ CORS آزاد، به‌روزرسانی هر چند دقیقه، نمونه کد curl، پایتون، PHP و جاوااسکریپت. فقط نام هدهد ویژن را با پیوند بیاورید.

آدرس‌ها

نقطه‌های دسترسی API رایگان
آدرسکاربرد
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 خبر با فیلتر دلخواه · مشخصات OpenAPI

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

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 خبر» با کلید اختصاصی و فیلتر دلخواه ارائه می‌شود؛ یک روز تست رایگان دارد.