/api/v1/marketsGETفهرست بازارها
همهی داراییها (یا فیلترشده) را با قیمت لحظهای برمیگرداند. با symbols فقط چند دارایی بخواهید، با perCategory چند مورد اول هر دسته، و با sparkline=true نمودار ۷ روزهی کوچک هر دارایی را هم بگیرید.
https://nabz.yashar.cloud/api/v1/marketsپارامترها
| نام | محل | نوع | الزامی | توضیح |
|---|---|---|---|---|
Authorization | هدر | string | بله | Bearer YOUR_API_KEY (کلید API یا توکن ورود) |
category | کوئری | string | خیر | فیلتر دسته |
symbols | کوئری | string | خیر | نماد یا نامکها با ویرگول؛ حداکثر ۱۰۰ مورد |
sparkline | کوئری | boolean | خیر | نمودار ۷ روزه (آرایهای از قیمتها) |
perCategory | کوئری | integer | خیر | فقط N مورد اول هر دسته (۱ تا ۵۰) |
limit / page | کوئری | integer | خیر | صفحهبندی؛ limit تا ۱۰۰۰ (پیشفرض ۱۰۰) |
نمونه درخواست
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://nabz.yashar.cloud/api/v1/markets?symbols=usd,eur,btc&limit=20"
امتحان کنید
GET /api/v1/markets?symbols=usd,eur,btc&limit=20برای ارسال، ابتدا کلید API را وارد کنید.
نمونه پاسخ
{
"success": true,
"data": [
{
"symbol": "USD",
"slug": "usd",
"name": "دلار آمریکا",
"nameEn": "US Dollar",
"category": "currency",
"currency": "IRT",
"unit": "toman",
"price": 268820,
"change": 120,
"changePercent": 0.0447,
"high": 270520,
"low": 267760,
"open": null,
"previousClose": 268700,
"volume": null,
"marketCap": null,
"priceIrt": null,
"intrinsic": null,
"bubble": null,
"bubblePercent": null,
"source": null,
"updatedAt": "2026-10-07T00:25:30.877Z",
"dataStatus": "fresh",
"providerStatus": "healthy",
"marketStatus": "CLOSED",
"suspicious": false
}
],
"meta": {
"total": 543,
"page": 1,
"limit": 100,
"counts": {
"currency": 128,
"gold": 12,
"crypto": 59
}
}
}