با یک درخواست به /prices همه قیمتها از هر ۴ منبع (gateio، bonbast، arya، abantether) را JSON بگیرید و در برنامه خودتان بر اساس فیلد source تفکیک کنید.
تمام endpointهای قیمت (بهجز health) نیاز به توکن API دارند.
برای دریافت توکن با پشتیبانی تلگرام تماس بگیرید.
Authorization: Bearer YOUR_API_TOKEN
| Header | مقدار | توضیح |
|---|---|---|
Authorization |
Bearer {token} |
روش اصلی ارسال توکن |
در هر پاسخ موفق، هدرهای زیر ارسال میشوند:
| Header | توضیح |
|---|---|
X-RateLimit-Limit | سقف درخواست در دقیقه |
X-RateLimit-Remaining | تعداد باقیمانده در پنجره فعلی |
Retry-After | فقط در پاسخ 429 — ثانیه تا امکان درخواست مجدد |
تمام پاسخها application/json هستند. ساختار کلی:
{
"success": true,
"data": { ... }
}
| فیلد | نوع | توضیح |
|---|---|---|
price_toman |
integer | قیمت تومانی — بدون اعشار |
price_usdt |
string | قیمت USDT — حداکثر ۸ رقم اعشار |
change_24h |
string | تغییر ۲۴ ساعته — فقط gateio |
source)هر آیتم در پاسخ /prices فیلد source دارد. برای جدا کردن منابع، در سمت کلاینت فیلتر کنید — نیازی به endpoint جدا نیست.
const gateio = allPrices.filter(item => item.source === 'gateio'); const bonbast = allPrices.filter(item => item.source === 'bonbast'); const arya = allPrices.filter(item => item.source === 'arya'); const abantether = allPrices.filter(item => item.source === 'abantether');
gateio قیمتها را به USDT (price_usdt) بر میگرداند و price_toman از نرخ لحظهای USDT محاسبه میشود.
bonbast، arya و abantether مستقیماً به تومان قیمت میدهند — فقط price_toman دارند و price_usdt/change_24h در آنها وجود ندارد.
بررسی سلامت سرویس. برای مانیتورینگ و uptime check مناسب است.
{
"success": true,
"status": "ok"
}
curl -X GET "https://price.aryagostaran.com/api/v1/health"
دریافت لیست همه قیمتها بهصورت JSON. با page و per_page صفحهبندی کنید تا کل داده (~۳۱۰۰ آیتم از هر ۴ منبع) را بگیرید، سپس با فیلد source در برنامه خودتان تفکیک کنید.
| پارامتر | نوع | پیشفرض | توضیح |
|---|---|---|---|
page |
integer | 1 | شماره صفحه |
per_page |
integer | 20 | تعداد آیتم در هر صفحه — حداکثر 100 (پیشنهاد: 100) |
# صفحه ۱ curl "https://price.aryagostaran.com/api/v1/prices?page=1&per_page=100" \ -H "Authorization: Bearer YOUR_API_TOKEN" # تا has_next=false — page=2, page=3, ...
{
"success": true,
"data": [
{
"source": "gateio",
"source_label": "Gate.io",
"symbol": "BTC",
"display_name": "Bitcoin (Gate.io)",
"icon": "https://price.aryagostaran.com/media/price-images/gateio_btc.png",
"price_usdt": "64679.3",
"price_toman": 11538787120,
"change_24h": "2.81",
"updated_at": "2026-07-15 14:55:52"
}
],
"pagination": {
"page": 1,
"per_page": 20,
"total": 3119,
"total_pages": 156,
"has_next": true,
"has_prev": false
}
}
{
"success": true,
"data": [
{
"source": "bonbast",
"source_label": "بنبست",
"symbol": "USD",
"display_name": "دلار آمریکا (بنبست)",
"icon": "https://price.aryagostaran.com/media/price-images/bonbast_usd.svg",
"price_toman": 187700,
"updated_at": "2026-07-15 14:55:35"
}
],
"pagination": { ... }
}
{
"success": true,
"data": [
{
"source": "arya",
"source_label": "آریا",
"symbol": "G18",
"display_name": "طلای ۱۸ عیار (آریا)",
"icon": "https://price.aryagostaran.com/media/price-images/arya_g18.svg",
"price_toman": 18431000,
"updated_at": "2026-07-15 14:55:36"
}
],
"pagination": { ... }
}
آریا ۱۶ نماد دارد: ارز (USD, EUR, AED)، طلا (G18, G24, GOLD_20, GOLD_21, GOLD_OUNCE, GOLD_LIQUID)، نقره (SILVER, SILVER_OUNCE) و سکه (COIN_AZADI, COIN_EMAMI, COIN_AZADI_HALF, COIN_AZADI_QUARTER, COIN_GERAMI).
{
"success": true,
"data": [
{
"source": "abantether",
"source_label": "آبان تتر",
"symbol": "BTC",
"display_name": "Bitcoin (آبان تتر)",
"icon": "https://price.aryagostaran.com/media/price-images/gateio_btc.png",
"price_toman": 12188683776,
"updated_at": "2026-07-15 14:55:39"
}
],
"pagination": { ... }
}
آبان تتر بزرگترین منبع بعد از Gate.io است (~۹۹۴ رمزارز، فقط قیمت خرید = buy_price از API آبان تتر). نمادهایی که هم روی Gate.io لیست شده باشند، آیکون خودشان را از Gate.io قرض میگیرند؛ بقیه آیکون تولیدشده خودکار دارند.
curl -X GET "https://price.aryagostaran.com/api/v1/prices?page=1&per_page=100" \
-H "Authorization: Bearer YOUR_API_TOKEN"
نرخ تبدیل USDT به تومان. منبع اصلی nobitex است؛ اگر در دسترس نباشد بهترتیب از gateio، bonbast یا arya استفاده میشود.
{
"success": true,
"data": {
"source": "gateio",
"rate_toman": 178400,
"rate_rial": 1784000,
"fetched_at": "2026-07-15 14:55:52"
}
}
curl -X GET "https://price.aryagostaran.com/api/v1/usdt-rate" \
-H "Authorization: Bearer YOUR_API_TOKEN"
در صورت خطا، فیلد success برابر false و ساختار error بازگردانده میشود:
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Price not found."
}
}
| HTTP | Code | توضیح |
|---|---|---|
| 401 | UNAUTHORIZED | توکن ارسال نشده |
| 401 | INVALID_TOKEN | توکن نامعتبر یا غیرفعال |
| 404 | NOT_FOUND | قیمت یا نرخ USDT یافت نشد |
| 422 | INVALID_SOURCE | پارامتر نامعتبر در درخواست |
| 429 | RATE_LIMIT_EXCEEDED | تعداد درخواست بیش از حد مجاز |
| فیلد | نوع | توضیح |
|---|---|---|
source | string | کد منبع |
source_label | string | برچسب فارسی منبع |
symbol | string | نماد ارز |
name | string | نام انگلیسی |
display_name | string | نام نمایشی — انگلیسی برای gateio، فارسی برای bonbast/arya/abantether |
icon | string | URL آیکون — در صورت وجود |
updated_at | string | زمان آخرین بروزرسانی |