استاندارد
- نرخ بهروزرسانی
- لحظهای
- محدودیت ساعتی
- ۴۲ درخواست
- محدودیت روزانه
- ۱٬۰۰۰ درخواست
- محدودیت ماهانه
- ۳۰٬۰۰۰ درخواست
قیمت لحظهای طلا، سکه، دلار و ارز دیجیتال را از طریق API دریافت کنید. مستندات کامل با فرمت Swagger در دسترس است و میتوانید رایگان شروع کنید.
بدون ثبتنام و بدون توکن؛ مستندات را باز کنید و اولین درخواست را بفرستید.
curl -G https://backend.gheymat.online/api/prices \
-d base_currency=USDT \
-d quote_currency=IRT \
-d price_source=GHEYMATcurl -G https://backend.gheymat.online/api/prices \
-H "x-api-token: YOUR_PLAN_TOKEN" \
-d base_currency=USDT \
-d quote_currency=IRT \
-d price_source=GHEYMATconst url = new URL("https://backend.gheymat.online/api/prices");
url.search = new URLSearchParams({
base_currency: "USDT", quote_currency: "IRT", price_source: "GHEYMAT",
});
const res = await fetch(url);
const { data } = await res.json();const url = new URL("https://backend.gheymat.online/api/prices");
url.search = new URLSearchParams({
base_currency: "USDT", quote_currency: "IRT", price_source: "GHEYMAT",
});
const res = await fetch(url, {
headers: { "x-api-token": "YOUR_PLAN_TOKEN" },
});
const { data } = await res.json();import requests
res = requests.get(
"https://backend.gheymat.online/api/prices",
params={"base_currency": "USDT", "quote_currency": "IRT",
"price_source": "GHEYMAT"},
)
data = res.json()["data"]import requests
res = requests.get(
"https://backend.gheymat.online/api/prices",
params={"base_currency": "USDT", "quote_currency": "IRT",
"price_source": "GHEYMAT"},
headers={"x-api-token": "YOUR_PLAN_TOKEN"},
)
data = res.json()["data"]{
"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",
…
}
]
}از اولین درخواست تا قیمت روی صفحهی خودتان؛ بدون ثبتنام.
بدون ثبتنام و بدون توکن. یک درخواست GET بفرستید و با پارامترها دارایی، واحد قیمت و منبع را انتخاب کنید.
/api/prices?base_currency=USDTbuy_price را کنار نام منبع و زمان بهروزرسانی بگذارید؛ همان کاری که خود قیمت آنلاین میکند.نمونهی زیر از پاسخ ۱۹ مهر ۱۴۰۵ است، نه قیمت لحظهای.
یکی از پلنها را بخرید و توکن آن را در هدر همین درخواست بفرستید. چیز دیگری عوض نمیشود.
x-api-token: YOUR_PLAN_TOKENهدر، فقط با پلن
همهی endpointها GET هستند و JSON برمیگردانند. بدون توکن هم کار میکنند، تا ۲۵۰ درخواست
در روز. فهرستها داخل کلید
data میآیند.
| endpoint و کاربرد |
|---|
GET /api/pricesقیمتها با فیلتر منبع، دارایی و دسته؛ برای هر منبع یک ردیف. |
GET /api/price-histories/{priceSource}/{symbol}تاریخچهی قیمت یک بازار در یک منبع، بهصورت OHLC؛ ساعتی یا روزانه. |
GET /api/currenciesفهرست داراییها با نماد، نام فارسی و انگلیسی و دسته. |
GET /api/currency-categoriesدستهها: طلا، سکه، ارز و ارز دیجیتال. |
GET /api/price-sourcesفهرست منابع قیمت با نام و لینک هر منبع. |
/api/pricesدر تاریخچه، timeframe اجباری است (HOURLY یاDAILY) و start وend اختیاری.
GlobalPriceResourceGlobalPriceResourceماهانه، با پرداخت تتر (USDT). همهی پلنها قیمت لحظهای میدهند؛ توکن فقط برای پلنهای پولی است.
برای تست و استفادهی سبک. کاربران رایگان میتوانند هر روز ۲۵۰ درخواست به API بزنند؛ بدون ثبتنام و بدون توکن.
رایگان بدون توکن است؛ سه پلن دیگر با توکن. «—» یعنی عددی اعلام نشده است.
قیمت پلنها به دلار اعلام شده و پرداخت با تتر (USDT) انجام میشود. برای خرید بهinfo@gheymat.online ایمیل بزنید.
«—» یعنی برای این پلن عددی اعلام نشده است.
قیمتهایی که از طریق API ارائه میشوند صرفاً از منابع گوناگون جمعآوری شدهاند و قیمت آنلاین هیچگونه تضمینی نسبت به درستی، دقت یا بهروز بودن آنها ارائه نمیکند.
هر قیمت با is_up_to_date وcreated_at میآید؛ در محصول خودتان هم نام منبع و زمان را کنار عدد نگه دارید.
پلن API عمومی برای استفادههای عمومی طراحی شده و قیمتها صرفاً از منابع مختلف جمعآوری میشوند؛ ما هیچگونه تضمینی نسبت به آنها نداریم. اگر کسبوکار شما به قیمتگذاری دقیق و حساس وابسته است، پیشنهاد میکنیم بهجای پلن عمومی از طریق صفحهی کسبوکار با ما در ارتباط باشید تا راهکار مناسب را بررسی کنیم.
مشاهدهی صفحهی کسبوکارجوابتان اینجا نیست؟ به info@gheymat.online ایمیل بزنید.
کاربران رایگان میتوانند هر روز ۲۵۰ درخواست به API بزنند. برای نرخ بالاتر، پلن استاندارد، طلایی یا الماسی را تهیه کنید.
نه. درخواست بدون توکن کار میکند و سقف آن ۲۵۰ درخواست در روز است. توکن فقط برای پلنهای استاندارد، طلایی و الماسی است؛ بعد از خرید، آن را در هدر x-api-token میفرستید.
مستندات کامل با فرمت Swagger در آدرس backend.gheymat.online/docs/api در دسترس است.
هزینهی پلنها به دلار اعلام شده و پرداخت با تتر (USDT) انجام میشود. برای خرید با ما در ارتباط باشید.
خیر. قیمتهایی که از طریق API ارائه میشوند صرفاً از منابع مختلف جمعآوری میشوند و هیچگونه تضمینی نسبت به درستی یا بهروز بودن آنها وجود ندارد. برای استفادههای حساس، لطفاً صفحهی کسبوکار را ببینید.
۲۵۰ درخواست در روز، بدون هزینه و بدون توکن. هر وقت بیشتر لازم شد، یکی از پلنها را بگیرید.