قیمت آنلایننصب اپ
قیمت آنلاین
در حال دریافت قیمت‌ها
REST · JSON · Swagger

API رایگان قیمت طلا، سکه، دلار و ارز دیجیتال

قیمت لحظه‌ای طلا، سکه، دلار و ارز دیجیتال را از طریق API دریافت کنید. مستندات کامل با فرمت Swagger در دسترس است و می‌توانید رایگان شروع کنید.

بدون ثبت‌نام و بدون توکن؛ مستندات را باز کنید و اولین درخواست را بفرستید.

درخواست رایگان در روز، بدون توکن
۲۵۰
منبع قیمت، ۵۹ بازار مرجع
۳۲
رایگان: ۲۵۰ درخواست در روز، بدون ثبت‌نام.
curl -G https://backend.gheymat.online/api/prices \
  -d base_currency=USDT \
  -d quote_currency=IRT \
  -d price_source=GHEYMAT
200 OKپاسخ واقعی ۱۹ مهر ۱۴۰۵، کوتاه‌شده
{
  "data": [
    {
      "symbol": "USDT-IRT",
      "price_source": { "symbol": "GHEYMAT", "en": "Gheymat" },
      "buy_price": "265254.00000000",
      "sell_price": "264959.00000000",
      "change": "-0.77",
      "real_value": "265367.00000000",
      "bubble": "-113.00000000",
      "bubble_percentage": "-0.04",
      "is_tradable": false,
      "is_up_to_date": true,
      "created_at": "2026-10-10T23:13:38.000000Z",
      …
    }
  ]
}
خط‌های بلند کد داخل همین کادر افقی جابه‌جا می‌شوند.

در سه قدم

از اولین درخواست تا قیمت روی صفحه‌ی خودتان؛ بدون ثبت‌نام.

پلن‌ها و قیمت
  1. endpoint را صدا بزنید

    بدون ثبت‌نام و بدون توکن. یک درخواست GET بفرستید و با پارامترها دارایی، واحد قیمت و منبع را انتخاب کنید.

    GET/api/prices?base_currency=USDT
  2. JSON را بخوانید

    buy_price را کنار نام منبع و زمان به‌روزرسانی بگذارید؛ همان کاری که خود قیمت آنلاین می‌کند.نمونه‌ی زیر از پاسخ ۱۹ مهر ۱۴۰۵ است، نه قیمت لحظه‌ای.

    تترقیمت آنلاین · ۲۲ ثانیه پیش۲۶۵٬۲۵۴تومان
  3. بیشتر از ۲۵۰ درخواست در روز؟

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

    x-api-token: YOUR_PLAN_TOKENهدر، فقط با پلن

API چه چیزی برمی‌گرداند

همه‌ی endpointها GET هستند و JSON برمی‌گردانند. بدون توکن هم کار می‌کنند، تا ۲۵۰ درخواست در روز. فهرست‌ها داخل کلید data می‌آیند.

endpointها

۵ مسیر GET؛ قیمت، تاریخچه، دارایی‌ها و منابع
endpointهای API قیمت و کاربرد هر کدام
GET/api/pricesقیمت‌ها با فیلتر منبع، دارایی و دسته؛ برای هر منبع یک ردیف.
GET/api/price-histories/{priceSource}/{symbol}تاریخچه‌ی قیمت یک بازار در یک منبع، به‌صورت OHLC؛ ساعتی یا روزانه.
GET/api/currenciesفهرست دارایی‌ها با نماد، نام فارسی و انگلیسی و دسته.
GET/api/currency-categoriesدسته‌ها: طلا، سکه، ارز و ارز دیجیتال.
GET/api/price-sourcesفهرست منابع قیمت با نام و لینک هر منبع.

فیلترهای /api/prices

۶ پارامتر اختیاری
price_source
منبع قیمت، مثل GHEYMAT یا NOBITEX
only_updated
با مقدار 1 فقط قیمت‌های به‌روز برمی‌گردد
base_currency
دارایی، مثل USDT یا GOLD18
quote_currency
واحد قیمت، مثل IRT برای تومان
base_currency_category
دسته‌ی دارایی: GOLD · COIN · CURRENCY · CRYPTOCURRENCY
quote_currency_category
دسته‌ی واحد قیمت، با همان چهار مقدار

در تاریخچه، timeframe اجباری است (HOURLY یاDAILY) و start وend اختیاری.

فیلدهای هر قیمت

قیمت، منبع، حباب و تازگی در GlobalPriceResource
symbol
نماد بازار، مثل USDT-IRT.
base_currency · quote_currency
دارایی و واحد قیمت؛ هر کدام با نماد، نام فارسی و انگلیسی و دسته.
price_source
منبعی که این قیمت را داده: نماد، نام و لینک.
buy_price · sell_price
قیمت خرید و فروش. رشته‌اند تا دقت عدد حفظ شود.
change
درصد تغییر ۲۴ ساعت.
is_tradable · buy_fee · sell_fee
آیا در خود منبع می‌شود معامله کرد، و کارمزد آن؛ 0.005 یعنی ۰٫۵٪.
real_value · bubble · bubble_percentage
ارزش ذاتی و حباب. فقط برای سکه‌ها، طلای ۱۸ عیار و تتر و فقط در ردیف منبع GHEYMAT مقدار دارد.
support · resistance
سطح حمایت و مقاومت؛ در ردیف منبع GHEYMAT.
created_at · is_up_to_date
زمان ثبت قیمت و اینکه هنوز به‌روز است یا نه. اگر false بود، قیمت را کهنه نشان بدهید:نمونه‌ی نشان: به‌روز نشده · ۲ ساعت پیش
مستندات کامل در Swagger

پلن‌ها و قیمت

ماهانه، با پرداخت تتر (USDT). همه‌ی پلن‌ها قیمت لحظه‌ای می‌دهند؛ توکن فقط برای پلن‌های پولی است.

رایگان

بدون هزینهبدون توکن

برای تست و استفاده‌ی سبک. کاربران رایگان می‌توانند هر روز ۲۵۰ درخواست به API بزنند؛ بدون ثبت‌نام و بدون توکن.

محدودیت روزانه
۲۵۰درخواست
نرخ به‌روزرسانی
لحظه‌ای
شروع رایگان

استاندارد

۵۰دلارماهانه، پرداخت با تتر (USDT)
نرخ به‌روزرسانی
لحظه‌ای
محدودیت ساعتی
۴۲ درخواست
محدودیت روزانه
۱٬۰۰۰ درخواست
محدودیت ماهانه
۳۰٬۰۰۰ درخواست
خرید با تتر

طلایی

پرطرفدار
۱۰۰دلارماهانه، پرداخت با تتر (USDT)
نرخ به‌روزرسانی
لحظه‌ای
محدودیت ساعتی
نامحدود
محدودیت روزانه
۳٬۰۰۰ درخواست
محدودیت ماهانه
۹۰٬۰۰۰ درخواست
خرید با تتر

الماسی

۲۵۰دلارماهانه، پرداخت با تتر (USDT)
نرخ به‌روزرسانی
لحظه‌ای
محدودیت ساعتی
نامحدود
محدودیت روزانه
۱۰٬۰۰۰ درخواست
محدودیت ماهانه
۳۰۰٬۰۰۰ درخواست
خرید با تتر

مقایسه‌ی چهار سطح

سقف درخواست
  • رایگانبدون هزینه
    ۲۵۰ در روز، بدون توکن · ساعتی و ماهانه: —
  • استاندارد۵۰دلار در ماه
    ۴۲ در ساعت · ۱٬۰۰۰ در روز · ۳۰٬۰۰۰ در ماه
  • طلاییپرطرفدار۱۰۰دلار در ماه
    ساعتی نامحدود · ۳٬۰۰۰ در روز · ۹۰٬۰۰۰ در ماه
  • الماسی۲۵۰دلار در ماه
    ساعتی نامحدود · ۱۰٬۰۰۰ در روز · ۳۰۰٬۰۰۰ در ماه

رایگان بدون توکن است؛ سه پلن دیگر با توکن. «—» یعنی عددی اعلام نشده است.

قیمت پلن‌ها به دلار اعلام شده و پرداخت با تتر (USDT) انجام می‌شود. برای خرید بهinfo@gheymat.online ایمیل بزنید.

سلب مسئولیت

قیمت‌هایی که از طریق API ارائه می‌شوند صرفاً از منابع گوناگون جمع‌آوری شده‌اند و قیمت آنلاین هیچ‌گونه تضمینی نسبت به درستی، دقت یا به‌روز بودن آن‌ها ارائه نمی‌کند.

استفاده‌ی حساس و حیاتی؟

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

مشاهده‌ی صفحه‌ی کسب‌وکار

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

پلن رایگان چه محدودیتی دارد؟

کاربران رایگان می‌توانند هر روز ۲۵۰ درخواست به API بزنند. برای نرخ بالاتر، پلن استاندارد، طلایی یا الماسی را تهیه کنید.

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

نه. درخواست بدون توکن کار می‌کند و سقف آن ۲۵۰ درخواست در روز است. توکن فقط برای پلن‌های استاندارد، طلایی و الماسی است؛ بعد از خرید، آن را در هدر x-api-token می‌فرستید.

مستندات API کجاست؟

مستندات کامل با فرمت Swagger در آدرس backend.gheymat.online/docs/api در دسترس است.

پرداخت چگونه انجام می‌شود؟

هزینه‌ی پلن‌ها به دلار اعلام شده و پرداخت با تتر (USDT) انجام می‌شود. برای خرید با ما در ارتباط باشید.

آیا قیمت‌های API تضمین‌شده هستند؟

خیر. قیمت‌هایی که از طریق API ارائه می‌شوند صرفاً از منابع مختلف جمع‌آوری می‌شوند و هیچ‌گونه تضمینی نسبت به درستی یا به‌روز بودن آن‌ها وجود ندارد. برای استفاده‌های حساس، لطفاً صفحه‌ی کسب‌وکار را ببینید.

اولین درخواست را رایگان بفرستید

۲۵۰ درخواست در روز، بدون هزینه و بدون توکن. هر وقت بیشتر لازم شد، یکی از پلن‌ها را بگیرید.