دادهٔ روشن. اتصال ساده.

دیده‌بان عمومی (رایگان سایت)

GET /api/public/markets

{
  "mode": "live",
  "status": "ok",
  "quotes": [{
    "symbol": "USD",
    "buy": "98500",
    "sell": "99100",
    "currency": "TMN",
    "unit": "دلار",
    "source": "زرسیگنال",
    "sourceUrl": null,
    "observedAt": "2026-09-01T09:00:00.000Z",
    "fetchedAt": "2026-09-01T09:00:00.000Z"
  }]
}

این endpoint برای خود سایت است و جایگزین پلن API تجاری نیست. TMN = تومان.

API تجاری با کلید و سهمیه

GET /api/v1/quotes
Authorization: Bearer zs_<your-secret-key>

GET /api/v1/analysis
Authorization: Bearer zs_<your-secret-key>

کلید باید معتبر، منقضی‌نشده و دارای اشتراک فعال api باشد. سهمیه روزانه بر اساس UTC شمارش می‌شود.

• 401: کلید نامعتبر یا منقضی
• 403: اشتراک API فعال نیست
• 429: سهمیه روزانه تمام شده
• 503: داده آماده نیست یا فرمول متصل نشده