نرخ طلا، ارز، نفت، بازار جهانی، سهام و ارز دیجیتال را با JSON استاندارد دریافت کنید. یک ماه دسترسی آزمایشی برای ارزیابی واقعی در پروژه شما در دسترس است.
عضویت سریع با موبایل یا Google؛ فعالسازی از ناحیه کاربری
GET /v1/quotes/gold-18 { "success": true, "data": { "reference": "gold-18", "market": "gold", "title": "طلای 18 عیار", "value": "23,800,729", "unit": "تومان" } }
از نمایش ساده قیمت تا سامانههای تحلیلی و داشبوردهای سازمانی.
آخرین نرخ، تغییر روزانه، کمترین، بیشترین و زمان بروزرسانی هر رفرنس.
شناسه و مشخصات رفرنسهای مجاز را مستقیماً از endpoint فهرست دریافت کنید.
احراز هویت با API Key، محدودسازی بازار و مدیریت سهمیه درخواستها.
خروجی JSON خوانا، نسخهبندی endpointها و خطاهای قابل پیشبینی.
بدون فرم فروش، کلید را از حساب خودتان دریافت کنید.
با شماره موبایل یا حساب Google وارد شوید و نام و نام خانوادگی را تکمیل کنید.
در «پلانها و API» شماره موبایل را تأیید و دسترسی یکماهه را فعال کنید. کلید فقط یکبار نمایش داده میشود.
API Key را با قالب Bearer بفرستید؛ ابتدا references را بخوانید و سپس نرخ رفرنس را دریافت کنید.
/v1/referencesفهرست رفرنسهای مجاز/v1/marketsفهرست بازارهای مجاز/v1/markets/{market}همه نرخهای یک بازار/v1/quotes/{reference}آخرین نرخ یک رفرنسBase URL نسخه فعلی https://goldprice.ir/v1 است.
curl -X GET "https://goldprice.ir/v1/quotes/gold-18" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
const response = await fetch(
"https://goldprice.ir/v1/quotes/gold-18",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
if (!response.ok) throw new Error(`API ${response.status}`);
const payload = await response.json();$curl = curl_init('https://goldprice.ir/v1/quotes/gold-18');
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Accept: application/json'
]
]);
$payload = json_decode(curl_exec($curl), true);
curl_close($curl);X-API-Key نیز پشتیبانی میشود.همه پاسخها envelope ثابت دارند تا مدیریت موفقیت و خطا قابل پیشبینی باشد.
success برابر true، داده در data و اطلاعات نسخه، زمان، تعداد نتیجه و سهمیه باقیمانده در meta قرار میگیرد.
data برابر null و خطا شامل error.code و error.message است. وضعیتهای 401، 403، 404 و 429 را مدیریت کنید.
سقف و مانده سهمیه در Headerهای X-RateLimit-Limit و X-RateLimit-Remaining و همچنین meta.quota_remaining برمیگردد.
API_KEY_REQUIREDINVALID_API_KEYACCOUNT_EXPIREDPERMISSION_DENIEDMARKET_NOT_ALLOWEDMONTHLY_QUOTA_EXCEEDEDREFERENCE_NOT_FOUNDیک API برای دادههایی که محصول مالی شما نیاز دارد.
ابتدا با داده واقعی آزمایش کنید؛ برای پلنهای تجاری متناسب با مصرف درخواست بفرستید.
برای ارزیابی ساختار داده و ساخت نمونه اولیه.
برای سرویسهای کوچک با تمرکز روی طلا.
برای وبسایت و اپلیکیشن در حال رشد.
برای ترافیک بالا و پوشش کامل داده.
پاسخ کوتاه به پرسشهای رایج فنی و تجاری.
عضو GoldPrice شوید، پروفایل و موبایل را تأیید کنید و در بخش «پلانها و API» دسترسی آزمایشی یکماهه را فعال کنید.
پس از فعالسازی، کلید فقط یکبار در ناحیه کاربری نمایش داده میشود. آن را امن نگه دارید؛ بازتولید کلید، کلید قبلی را فوراً باطل میکند.
سهمیه ماهانه به پلان وابسته است. مقدار باقیمانده در پاسخ v1 و Headerهای RateLimit اعلام میشود.
اگر به سهمیه بالاتر، پوشش مشخص بازار یا هماهنگی فنی نیاز دارید، جزئیات پروژه را بفرستید تا پیشنهاد متناسب دریافت کنید.
این فرم برای پلانهای پایه، حرفهای و سازمانی است.