رفتن به محتوای اصلی
سرویکس وب‌سرویس و API داده‌های بازار ایران

وب‌سرویس طلای ۱۸ عیار با احراز هویت

وب‌سرویس و API قیمت طلای ۱۸ عیار ایران

با وب‌سرویس سرویکس و کلید API می‌توانید قیمت و تاریخچه GOLD_18_RLS را به‌صورت ساختاریافته در ربات، داشبورد یا بک‌اند دریافت کنید. پیش‌نمایش عمومی طلا و سکه فقط به‌صورت تصویر گروهی تولیدشده روی سرور نمایش داده می‌شود.

این داده برای ربات قیمت طلا، داشبورد بازار، هشدار تغییر قیمت و گزارش های سمت سرور مناسب است. زمان کنار تصویر، businessTime snapshot است و داده ساختاریافته با API Key دریافت می شود.

جهت قیمت: ریال ایران برای یک گرم طلای ۱۸ عیار (۷۵۰)

آخرین قیمت ثبت شده

نمای تصویری گروه طلا و سکه سرویکس
تصویر گروهی قیمت طلا و سکه سرویکس

آخرین قیمت ثبت شده

عیار و خلوص
۱۸ عیار (۷۵۰ از ۱۰۰۰)
واحد قیمت
یک گرم طلای ۱۸ عیار
کد API
GOLD_18_RLS
وضعیت تازگی
تازه
زمان تجاری رکورد

نمونه استفاده از API

برای دریافت قیمت طلای ۱۸ عیار در قالب JSON، نماد GOLD_18_RLS را با API Key از endpoint تک نماد بخوانید. value ریال و businessTime زمان تجاری رکورد است.

نمونه درخواست

curl -sS https://servix.cc/api/v1/assets/GOLD_18_RLS \
  -H "X-API-Key: pk_live_your_key_here"

نمونه پاسخ

{
  "code": "GOLD_18_RLS",
  "name": "GOLD_18_RLS",
  "slug": "gold_18_rls",
  "labelEn": "18K Gold / Iranian Rial",
  "labelFa": "طلای ۱۸ عیار / ریال ایران",
  "quoteUnit": "RLS",
  "value": "<protected-market-value>",
  "businessTime": "<source-timestamp>"
}

روش محاسبه و تازگی داده

سرویکس تصویر عمومی را از آخرین رکورد پذیرفته شده GOLD_18_RLS بر اساس زمان تجاری می سازد. تاریخچه در DOM یا جدول عمومی قرار نمی گیرد و فقط از API احرازشده قابل دریافت است.

کاربردهای پیشنهادی

  • نمایش قیمت یک گرم طلای ۱۸ عیار در ربات یا اپلیکیشن
  • ثبت تاریخچه طلا و ایجاد هشدار تغییر قیمت
  • تغذیه داشبورد و ابزار پایش بازار طلای ایران

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

قیمت طلای ۱۸ عیار در API ریال است یا تومان؟
فیلد value برای نماد GOLD_18_RLS ریال ایران است. تومان فقط با تقسیم همان عدد بر ۱۰ نمایش داده می شود.
وضعیت stale چه معنایی دارد؟
یعنی رکورد مبنای تصویر از آستانه تازگی سرویکس قدیمی تر است. زمان و وضعیت کنار تصویر را بررسی کنید و مقدار ساختاریافته را فقط با API Key بخوانید.
آیا می توان تاریخچه قیمت طلا را از API گرفت؟
بله. endpoint تاریخچه بازه حداکثر ۳۱ روز را می پذیرد و ممکن است برای روزهای بدون رکورد، ردیفی برنگرداند.

صفحه ها و راهنماهای مرتبط