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 | این بخش فعلاً در دسترس نیست. کمی بعد دوباره امتحان کنید. |
محدودیتها و ذکر منبع
- سقف درخواست هر کلید در ساعت و در ماه مشخص است. بیش از آن، پاسخ
429با سرآیندRetry-Afterمیگیرید. - نرخها هر ده دقیقه عوض میشوند؛ بیشتر از دقیقهای یک بار درخواست فایدهای ندارد.
- هر جا این نرخها را نشان میدهید، نام نرخآرا را با پیوند به nerkhara.com و زمان هر نرخ را کنارش بیاورید.
مشخصات کامل
مشخصات ماشینخوان API به قالب OpenAPI 3.1: /v1/openapi.json