نرخ گیومه

API نرخ گیومه

نرخ دلار، یورو، تتر، طلای ۱۸ عیار و انس طلا را به شکل JSON بگیرید؛ هر ده دقیقه به‌روز، با زمان دقیق هر عدد و تاریخچه روزانه.

چه کسی می‌تواند استفاده کند؟

فروشگاه‌های گیومه پرایس: رایگان

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

درباره گیومه پرایس

برنامه‌ها و سایت‌های دیگر: با کلید

برای گرفتن کلید با ما تماس بگیرید. تعرفه را بر اساس مصرف‌تان اعلام می‌کنیم و پس از پرداخت، کلید را برای‌تان می‌فرستیم.

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

کلید را در سرآیند Authorization بفرستید:

curl -H "Authorization: Bearer YOUR_KEY" https://ex.giumeeh.ir/v1/rates

نمونه پاسخ

{
  "as_of": "2026-11-16T19:51:00.002Z",
  "attribution": "NerkhAra — https://nerkhara.com",
  "items": {
    "usd": {
      "value": "268750",
      "unit": "toman",
      "updated_at": "2026-11-16T19:44:43.000Z",
      "read_at": "2026-11-16T19:51:00.002Z",
      "stale": false,
      "change_24h": "0.94"
    }
  }
}

همه قیمت‌ها متن عددی‌اند، نه عدد اعشاری، تا هیچ رقمی گم نشود. updated_at زمان آخرین تغییر قیمت است و read_at زمانی که ما آن را خوانده‌ایم. اگر قیمتی بیش از نیم ساعت تازه نشده باشد، stale برابر true می‌شود.

آدرس‌ها

آدرسکاربرد
GET /v1/ratesهمه نرخ‌ها با هم
GET /v1/rates/{item}یک نرخ
GET /v1/history/{item}?from=YYYY-MM-DD&to=YYYY-MM-DDقیمت پایانی هر روز (روز به وقت تهران)؛ بدون تاریخ، سی روز گذشته؛ حداکثر ۴۰۰ روز

نرخ‌ها

شناسهنامواحد
usdدلار آمریکاتومان
eurیوروتومان
usdtتترتومان
gold18طلای ۱۸ عیار (هر گرم)تومان
ounceانس جهانی طلادلار

خطاها

هر خطا یک کد و یک پیام فارسی دارد: {"error": {"code": "...", "message": "..."}}

کدپیام
invalid_tokenکلید دسترسی معتبر نیست. کلید را دوباره بررسی کنید.
plan_inactiveاین کلید دیگر فعال نیست.
license_inactiveلایسنس گیومه پرایس این سایت فعال نیست. پس از فعال شدن لایسنس، نرخ‌ها دوباره دریافت می‌شوند.
rate_limitedتعداد درخواست‌ها از سقف مجاز گذشته است. کمی بعد دوباره امتحان کنید.
unknown_itemاین نرخ در فهرست ما نیست.
upstream_staleفعلاً نرخ تازه‌ای برای این مورد نداریم.
bad_requestدرخواست کامل یا درست نیست.
verify_failedنتوانستیم تأیید کنیم که این درخواست از همین سایت آمده است. مطمئن شوید سایت از اینترنت در دسترس است و دوباره امتحان کنید.
service_unavailableاین بخش فعلاً در دسترس نیست. کمی بعد دوباره امتحان کنید.

محدودیت‌ها و ذکر منبع

مشخصات کامل

مشخصات ماشین‌خوان API به قالب OpenAPI 3.1: /v1/openapi.json