مستندات API قیمتش؟

معرفی

API سایت قیمتش؟ به شما امکان می‌دهد به‌صورت رایگان و بدون احراز هویت، داده‌های قیمتی ارزهای دیجیتال، فیات، طلا، سکه، نقره و کالاها را در پروژه‌های خود استفاده کنید.
استفاده از این api به منزله تایید قوانین و قررات وشرایط استفاده موجود در صفحه زیر می‌باشد:
قوانین و شرایط استفاده

تمام داده‌ها از منابع مختلفی جمع‌آوری و با سیستم کش هوشمند ذخیره می‌شوند. خروجی API فاقد هرگونه اطلاعات منبع (مثل source) است و فقط شامل داده‌های خام و زمان آخرین به‌روزرسانی است.

آدرس پایه API

تمامی درخواست‌ها به آدرس زیر ارسال می‌شوند:

https://app.gheymatesh.ir/api/

فرمت پاسخ: application/json با کدگذاری UTF-8.

پارامترهای درخواست (اختیاری)

مثال‌های کاربردی

دریافت تمام داده‌ها

GET https://app.gheymatesh.ir/api/

فقط ارزهای دیجیتال

GET https://app.gheymatesh.ir/api/?type=crypto

جستجوی «سکه امامی»

GET https://app.gheymatesh.ir/api/?q=امامی

فقط نقره

GET https://app.gheymatesh.ir/api/?type=silver

ساختار خروجی (پاسخ)

پاسخ یک شیء JSON حاوی بخش‌های زیر است (بسته به فیلتر، برخی بخش‌ها ممکن است خالی یا غیرحضور داشته باشند):

• usd_rate: نرخ دلار به تومان (عدد)
• usd_rate_last_update: زمان آخرین به‌روزرسانی نرخ دلار (رشته)
• crypto: آرایه‌ای از ارزهای دیجیتال — هر آیتم شامل id, price_usd, change_24h, و last_update
• fiat: آرایه‌ای از ارزهای فیات — هر آیتم شامل symbol, usd_per_unit, و last_update
• gold: آرایه‌ای از طلا و سکه — هر آیتم شامل title, symbol, price_toman, و last_update
• silver: آرایه‌ای از انواع نقره — هر آیتم شامل title, price_usd, price_toman, و last_update
• commodities: آرایه‌ای از کالاهای صنعتی — هر آیتم شامل title, price_usd, price_toman, و last_update

هیچ فیلدی مانند source, icon یا title در بخش‌های crypto و fiat (در API) وجود ندارد — فقط داده‌های خام.

{
  "usd_rate": 625000,
  "usd_rate_last_update": "2025-04-05 14:32:10",
  "crypto": [
    {
      "id": "bitcoin",
      "price_usd": 67234.56,
      "change_24h": 1.23,
      "last_update": "2025-04-05 14:30:05"
    }
  ],
  "gold": [
    {
      "title": "سکه امامی",
      "symbol": "COIN-EMAMI",
      "price_toman": 31250000,
      "last_update": "2025-04-05 14:00:22"
    }
  ]
}

نکات مهم

• این API برای استفاده عمومی طراحی شده و نیازی به API Key ندارد.
• زمان last_update بر اساس زمان **آخرین ذخیره در کش** است (دقیقاً زمان به‌روزرسانی داده).
• داده‌ها با فواصل زمانی مختلف به‌روز می‌شوند:
  • ارزهای دیجیتال و فیات: هر 10 دقیقه
  • نرخ دلار: هر 2 دقیقه
  • طلا، سکه و کالاها: هر 30 دقیقه
• از CORS پشتیبانی می‌کند — می‌توانید مستقیماً از مرورگر به آن درخواست بزنید.
• لطفاً از سوءاستفاده یا درخواست‌های بیش از حد خودداری کنید.