مرجع API
قیمت یک نماد
GET
https://data.zevix.ir/v1/prices/{symbol}قیمت لحظه‌ای فقط یک نماد، مثل طلای ۱۸ عیار یا دلار.
وقتی فقط یک قیمت لازم دارید (مثلاً قیمت گرم طلا برای ماشین‌حساب فروشگاه) این مسیر پاسخ کوچک‌تری می‌دهد.
پارامترها
| پارامتر | محل | نوع | توضیح |
|---|---|---|---|
X-API-Keyالزامی | header | string | کلید API شما |
symbolالزامی | path | string | شناسه نماد (فهرست: /v1/symbols) — مثال: gold_18 |
فیلدهای پاسخ
| فیلد | نوع | توضیح |
|---|---|---|
data.symbol | string | شناسه نماد، مثل gold_18، coin_emami یا usd |
data.title | string | نام فارسی نماد |
data.category | string | دسته: gold، coin، currency، silver، broken_gold، global و ... |
data.unit | string | واحد قیمت: gram (گرم)، mesghal (مثقال)، count (عدد)، unit (یک واحد ارز)، usd_ounce |
data.price | string | قیمت هر واحد به ریال (عدد صحیح به‌صورت رشته تا دقت از دست نرود)؛ برای ons و silver_ounce دلار |
data.price_toman | string | همان قیمت به تومان |
data.change_pct | string | null | درصد تغییر نسبت به پایان روز قبل (منفی یعنی کاهش) |
data.high | string | null | بیشترین قیمت امروز (ریال برای هر واحد) |
data.low | string | null | کمترین قیمت امروز |
data.updated_at | string (RFC 3339) | آخرین زمان تغییر این قیمت |
پاسخ‌های خطا
| HTTP | کد | چه وقت | |
|---|---|---|---|
| 401 | api_key_required | هیچ‌کدام از X-API-Key، Authorization: Bearer یا api_key در درخواست نیست. | راه‌حل ← |
| 401 | invalid_api_key | کلید اشتباه تایپ شده، باطل شده یا وجود ندارد. | راه‌حل ← |
| 402 | subscription_expired | پلن فعالی برای حساب نیست (تمام شده یا هنوز نخریده‌اید). | راه‌حل ← |
| 403 | ip_not_allowed | برای کلید فهرست IP تعریف شده و درخواست از IP دیگری آمده. | راه‌حل ← |
| 403 | app_not_allowed | کلید به اپ‌های اندروید مشخصی محدود است و هدرهای X-Android-Package و X-Android-Cert نیامده یا با اپ ثبت‌شده نمی‌خواند. | راه‌حل ← |
| 403 | symbol_not_in_plan | پلن شما به نمادهای مشخصی محدود است. | راه‌حل ← |
| 404 | symbol_not_found | نماد اشتباه است. | راه‌حل ← |
| 429 | rate_limited | بیش از سقف پلن در یک دقیقه درخواست داده‌اید. | راه‌حل ← |
| 429 | daily_quota_exceeded | مصرف امروز (به وقت تهران) به سهمیه پلن رسیده. | راه‌حل ← |
| 503 | service_disabled | سرویس‌دهی API برای نگهداری موقتاً خاموش است. | راه‌حل ← |
همه کدها و راه‌حل‌ها: کدهای وضعیت و خطا.
درخواست
curl -H "X-API-Key: YOUR_API_KEY" \
"https://data.zevix.ir/v1/prices/gold_18"پاسخ 200
{
"data": {
"symbol": "gold_18",
"title": "طلای ۱۸ عیار",
"category": "gold",
"unit": "gram",
"price": "256944000",
"price_toman": "25694400",
"change_pct": "0.84",
"high": "257971776",
"low": "254631504",
"updated_at": "2026-10-02T09:41:12+03:30"
}
}