مستندات
شروع سریع API قیمت
در چند دقیقه کلید بگیرید و اولین قیمت طلا، سکه و ارز را با یک درخواست HTTP دریافت کنید: آدرس پایه، احراز هویت، قالب پاسخ و واحدها.
آدرس پایه
همه مسیرها زیر این آدرس‌اند و فقط با HTTPS پاسخ می‌دهند. پاسخ‌ها JSON با کدگذاری UTF-8 هستند.
https://data.zevix.ir/v1سه قدم
- حساب بسازید (موبایل و کد تایید)، حساب را با زرین‌پال شارژ کنید و یک پلن بخرید.
- در داشبورد بخش «کلیدها» یک کلید بسازید. کلید فقط همان یک‌بار نمایش داده می‌شود؛ جایی امن نگهش دارید.
- کلید را در هدر
X-API-Keyبفرستید:
GET /v1/prices
curl -H "X-API-Key: YOUR_API_KEY" \
"https://data.zevix.ir/v1/prices?symbols=gold_18,coin_emami,usd"قالب پاسخ
پاسخ موفق همیشه داده را در data می‌گذارد و پاسخ ناموفق در error با یک code ثابت (برای برنامه شما) و message فارسی (برای نمایش):
{
"data": { "at": "2026-10-02T06:11:40Z", "delay_seconds": 0, "quotes": [ ... ] }
}فهرست کامل کدها و راه‌حل هر کدام در کدهای وضعیت و خطا است.
واحدها و اعداد
| فیلد / مقدار | معنی |
|---|---|
price | قیمت هر واحد به ریال؛ عدد صحیح به‌صورت رشته (تا هیچ زبانی دقت را از دست ندهد) |
price_toman | همان قیمت به تومان |
unit: gram | برای هر گرم (طلا و نقره) |
unit: mesghal | برای هر مثقال |
unit: count | برای هر عدد (سکه) |
unit: unit | برای یک واحد ارز (یک دلار، یک یورو، ...) |
unit: usd_ounce | نمادهای ons و silver_ounce: دلار برای هر اونس |
change_pct | درصد تغییر نسبت به پایان روز قبل؛ منفی یعنی کاهش |
به‌روزرسانی و ارسال زنده
قیمت‌ها هر ۵ ثانیه از منبع خوانده می‌شوند. درخواست‌های سریع‌تر از آن فقط سهمیه را مصرف می‌کنند؛ برای قیمت آنی ارسال زنده را باز کنید.
بهترین روش
در سرور خودتان یک اتصال
/v1/stream یا درخواست هر ۵ تا ۱۰ ثانیه داشته باشید و قیمت را برای کاربرانتان کش کنید؛ هر کاربر نباید مستقیم API را صدا بزند.ابزارها
- مجموعه Postman — همه مسیرها با متغیرهای
base_urlوapi_key؛ در Postman یا Insomnia ایمپورت کنید. - OpenAPI 3.1 — برای ساختن کلاینت خودکار (openapi-generator) در هر زبانی.
- Swagger UI — امتحان مستقیم مسیرها با کلید خودتان.
مرجع مسیرها
| مسیر | کاربرد |
|---|---|
| GET /v1/prices | تابلوی کامل قیمت طلا، سکه، ارز، نقره و انس جهانی در یک درخواست. |
| GET /v1/prices/{symbol} | قیمت لحظه‌ای فقط یک نماد، مثل طلای ۱۸ عیار یا دلار. |
| GET /v1/history/{symbol} | تیک‌های امروز یا قیمت پایانی روزها برای رسم نمودار. |
| GET /v1/stream | هر تغییر قیمت همان لحظه به برنامه شما فرستاده می‌شود؛ بدون polling و بدون مصرف سهمیه. |
| GET /v1/symbols | همه نمادهایی که پلن شما به آن‌ها دسترسی دارد، با نام و واحد. |
| GET /v1/usage | پلن، پایان اشتراک، سقف‌ها و مصرف امروز همین کلید. |
| GET /v1/widget | بدون برنامه‌نویسی: تابلوی قیمت و نمودار را با یک iframe در سایت خود بگذارید. |