{
  "info": {
    "name": "API قیمت زنده زویکس",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "https://data.zevix.ir/docs"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://data.zevix.ir"
    },
    {
      "key": "api_key",
      "value": "zxp_YOUR_KEY"
    }
  ],
  "item": [
    {
      "name": "قیمت لحظه‌ای همه نمادها — /v1/prices",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/prices?symbols=gold_18,coin_emami,usd",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "prices"
          ],
          "query": [
            {
              "key": "symbols",
              "value": "gold_18,coin_emami,usd"
            }
          ]
        },
        "description": "تابلوی کامل قیمت طلا، سکه، ارز، نقره و انس جهانی در یک درخواست.\n\nپرکاربردترین مسیر API: همه نمادهای پلن شما (یا فقط نمادهایی که در `symbols` می‌خواهید) با قیمت ریالی و تومانی، درصد تغییر روز و بیشینه و کمینه امروز.\n\nقیمت‌ها هر ۵ ثانیه از منبع خوانده می‌شوند. اگر سریع‌تر از هر ۵ ثانیه درخواست می‌دهید، به‌جای آن از ارسال زنده (`/v1/stream`) استفاده کنید."
      }
    },
    {
      "name": "قیمت یک نماد — /v1/prices/{symbol}",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/prices/gold_18",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "prices",
            "gold_18"
          ],
          "query": []
        },
        "description": "قیمت لحظه‌ای فقط یک نماد، مثل طلای ۱۸ عیار یا دلار.\n\nوقتی فقط یک قیمت لازم دارید (مثلاً قیمت گرم طلا برای ماشین‌حساب فروشگاه) این مسیر پاسخ کوچک‌تری می‌دهد."
      }
    },
    {
      "name": "تاریخچه و داده نمودار — /v1/history/{symbol}",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/history/gold_18?days=7",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "history",
            "gold_18"
          ],
          "query": [
            {
              "key": "days",
              "value": "7"
            }
          ]
        },
        "description": "تیک‌های امروز یا قیمت پایانی روزها برای رسم نمودار.\n\nبا `days=1` همه تیک‌های امروز (به‌وقت تهران) برمی‌گردد؛ نقطه اول قیمت پایانی دیروز است تا نمودار امروز نقطه شروع داشته باشد.\n\nبا `days` بیشتر از ۱ قیمت پایانی هر روز معاملاتی برمی‌گردد و در کنار آن `high` و `low` (بیشترین و کمترین قیمت همان روز). برای بیشترین/کمترین بازه از `high` و `low` استفاده کنید، نه از قیمت پایانی. حداکثر بازه را پلن شما تعیین می‌کند."
      }
    },
    {
      "name": "ارسال زنده (Server-Sent Events) — /v1/stream",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/stream?symbols=gold_18,usd",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "stream"
          ],
          "query": [
            {
              "key": "symbols",
              "value": "gold_18,usd"
            }
          ]
        },
        "description": "هر تغییر قیمت همان لحظه به برنامه شما فرستاده می‌شود؛ بدون polling و بدون مصرف سهمیه.\n\nاتصال باز می‌ماند و رویداد `prices` ابتدا یک‌بار با کل تابلو و سپس بعد از هر تغییر قیمت فرستاده می‌شود. بدنه هر رویداد همان شکل پاسخ `/v1/prices` را دارد.\n\nهر ۲۰ ثانیه یک خط توضیح (`: ping`) می‌آید تا پروکسی‌ها اتصال را نبندند. اگر کلید باطل یا اشتراک تمام شود رویداد `error` می‌آید و اتصال بسته می‌شود؛ قطع شبکه را با اتصال دوباره (EventSource خودش انجام می‌دهد) جبران کنید.\n\nحداکثر ۵ اتصال هم‌زمان برای هر کلید. چون EventSource مرورگر هدر نمی‌فرستد، کلید را در `api_key` بگذارید (و آن کلید را به دامنه سایت خود محدود کنید)."
      }
    },
    {
      "name": "فهرست نمادها — /v1/symbols",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/symbols",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "symbols"
          ],
          "query": []
        },
        "description": "همه نمادهایی که پلن شما به آن‌ها دسترسی دارد، با نام و واحد.\n\nبرای ساختن منو یا اعتبارسنجی ورودی کاربر. فهرست کامل نمادها را در صفحه نمادهای همین مستندات هم می‌بینید."
      }
    },
    {
      "name": "مصرف و وضعیت پلن — /v1/usage",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/usage",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "usage"
          ],
          "query": []
        },
        "description": "پلن، پایان اشتراک، سقف‌ها و مصرف امروز همین کلید.\n\nبرای نمایش وضعیت در پنل خودتان یا هشدار پیش از تمام شدن سهمیه. این درخواست هم یک درخواست حساب می‌شود."
      }
    }
  ]
}