هدهد ویژن

API رایگان قیمت بیت‌کوین، اتریوم و تتر

قیمت بیت‌کوین و اتریوم به دلار و تتر به تومان در یک پاسخ JSON ساده. بدون کلید و بدون محدودیت دامنه، فقط با ذکر منبع.

نمونه‌ی کاربرد

مناسب ویجت قیمت رمزارز، وبلاگ‌های بلاک‌چین و ربات‌های اطلاع‌رسانی.

آدرس‌های 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/برندها و محدوده قیمت

قیمت لحظه‌ای (نمونه‌ی خروجی زنده)

قیمت‌هایی که این API برمی‌گرداند
کلیدعنوانقیمت
btcبیت‌کوین۶۳,۷۳۲ دلار
ethاتریوم۱,۸۰۳ دلار
usdtتتر۲۷۰,۲۹۵ تومان

نمونه کد

curl

curl "https://hodhodvision.ir/api/v1/open/prices/?keys=btc,eth,usdt"

JavaScript

const r = await fetch("https://hodhodvision.ir/api/v1/open/prices/?keys=btc,eth,usdt");
const data = await r.json();

Python

import requests
print(requests.get("https://hodhodvision.ir/api/v1/open/prices/?keys=btc,eth,usdt", timeout=15).json())

PHP

<?php
$data = json_decode(file_get_contents("https://hodhodvision.ir/api/v1/open/prices/?keys=btc,eth,usdt"), 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 قیمت خودرو برای فروشگاه یا سایت نمایشگاهی مناسب است؟

بله. با برند، مدل، سال و بازه قیمت فیلتر کنید و فهرست را مستقیم در سایت خود نمایش دهید؛ فقط ذکر منبع «هدهد ویژن» با پیوند الزامی است.