وب‌سرویس مزنه

این مسیرها بدون کلید در دسترس‌اند و همان چیزی را برمی‌گردانند که روی سایت می‌بینید.

GET https://api.mazaneha.com/v1/overview
GET https://api.mazaneha.com/v1/markets
GET https://api.mazaneha.com/v1/markets/{category}
GET https://api.mazaneha.com/v1/instruments/{slug}
GET https://api.mazaneha.com/v1/instruments/{slug}/quote
GET https://api.mazaneha.com/v1/instruments/{slug}/candles?interval=15m
GET https://api.mazaneha.com/v1/instruments/{slug}/history?days=30
GET https://api.mazaneha.com/v1/search?q=دلار

بازهٔ نمودار باید یکی از 1m, 5m, 15m, 1h, 4h, 1d, 1w باشد، نه نام انگلیسی enum.

مسیر /v1/pro جدا از سایت عمومی است: سهمیه ماهانه، محدودیت نرخ پلن، و تأخیر عمدی برای پلن رایگان. کلید را در سربرگ X-Api-Key بفرستید.

GET https://api.mazaneha.com/v1/pro/instruments/{slug}/quote
GET https://api.mazaneha.com/v1/pro/quotes?symbols=usd-irr,gold-18k
GET https://api.mazaneha.com/v1/pro/instruments/{slug}/candles?interval=1h
GET https://api.mazaneha.com/v1/pro/usage

درخواست دسته‌ای به‌ازای هر نماد محاسبه می‌شود. سربرگ X-Mazaneha-Data-Delay تأخیر اعمال‌شده را نشان می‌دهد تا دادهٔ تأخیری با خوراک ازکارافتاده اشتباه نشود. تاریخچه روی پلنی که آن را شامل نمی‌شود با 403 plan_upgrade_required رد می‌شود، نه با ۴۲۹.

هاب SignalR روی https://api.mazaneha.com/hubs/market است. به کانال market:{slug} یا category:{slug} مشترک شوید. هر پیام یک شمارهٔ توالی دارد؛ پیام قدیمی‌تر از آخرین شماره را دور بریزید تا تأخیر شبکه قیمت را به عقب برنگرداند.

const connection = new HubConnectionBuilder()
  .withUrl("https://api.mazaneha.com/hubs/market")
  .withAutomaticReconnect()
  .build();

connection.on("quoteUpdated", (msg) => { /* apply if msg.sequence is newer */ });
await connection.start();
await connection.invoke("Subscribe", ["market:usd-irr", "category:currency"]);

تغییر قیمت، کهنه شدن ابزار و اصلاح دستی با POST به آدرس شما می‌رسد. بدنه با HMAC-SHA256 روی {timestamp}.{body} امضا می‌شود. سربرگ‌ها:

X-Mazaneha-Signature: t=<unix>,v1=<hex>
X-Mazaneha-Event: PriceChanged
X-Mazaneha-Event-Id: <uuid>
X-Mazaneha-Attempt: 1

تحویل حداقل یک‌بار است. X-Mazaneha-Event-Id را کلید تکرارناپذیری بگیرید. زمان امضای قدیمی‌تر از چند دقیقه را رد کنید.