API قیمت لحظه‌ای

قیمت و تاریخچه‌ی ارز، طلا و سکه، نفت و گاز، رمزارز و شاخص‌ها — JSON، با کلید شخصی.

احراز هویت

کلید را از حساب من ← کلیدهای API بسازید و در سرآیند X-API-Key (یا Authorization: Bearer) بفرستید. کلید را در کد سمت مرورگر نگذارید.

curl -H "X-API-Key: mk_live_…" "https://mkinvesting.ir/api/v1/quotes?symbols=USD_IRR,GOLD_18K,BRENT"

مشخصات ماشین‌خوان OpenAPI: /api/v1/openapi.json (برای Postman یا تولید کلاینت).

نقطه‌های دسترسی

مسیر	پارامترها	توضیح	از طرح
`GET /api/v1/quotes`	`symbols=USD_IRR,BRENT · group=fx\|metals\|energy\|crypto\|indices\|tse`	آخرین قیمت و تغییر روزانه (همان منبع اصلی سایت)؛ بدون symbols همه‌ی نمادها.	رایگان
`GET /api/v1/history/{symbol}`	`period=daily\|weekly\|monthly · range=1M…MAX`	باز/سقف/کف/بسته و درصد تغییر هر دوره؛ هفته شنبه‌-آغاز، ماه شمسی. رایگان تا یک سال، پایه به بالا از ۲۰۱۱.	رایگان
`GET /api/v1/history/{symbol}?interval=hour`	`range=1D\|5D\|1M\|3M`	کندل ساعتی درون‌روزی.	حرفه‌ای
`GET /api/v1/symbols`	`—`	فهرست نمادها با نام فارسی و انگلیسی، گروه، واحد و ارز.	رایگان
`GET /api/v1/calendar`	`range=today\|tomorrow\|week · impact=medium\|high · country=USD,EUR`	تقویم اقتصادی با پیش‌بینی، قبلی و مقدار واقعی (EIA، BLS، MQL5).	پایه
`GET /api/v1/moves`	`hours=48 · symbol=BRENT · kind=intraday\|daily`	حرکت‌های غیرعادی قیمت با خبرها و رویدادهای هم‌زمان و دارایی‌های هم‌حرکت.	حرفه‌ای
`GET /api/v1/news`	`category=energy · symbol=BRENT · lang=fa\|en`	سرخط اخبار با دسته و نمادهای مرتبط (پیوند به منبع؛ بدون متن خبر).	حرفه‌ای

نمونه‌ی پاسخ

{
  "data": [
    {
      "symbol": "USD_IRR",
      "name_fa": "دلار آمریکا (بازار آزاد)",
      "name_en": "US Dollar (open market)",
      "group": "fx",
      "price": 258465,
      "change_percent": 0.18,
      "unit": "تومان",
      "currency": "IRR",
      "observed_at": "2026-10-02T09:41:00.000Z",
      "source": "TGJU"
    }
  ],
  "count": 1,
  "generated_at": "2026-10-02T09:41:12.000Z"
}

JavaScript

const res = await fetch("https://mkinvesting.ir/api/v1/quotes?symbols=USD_IRR,BRENT", {
  headers: { "X-API-Key": process.env.MK_API_KEY },
});
const { data } = await res.json();
console.log(data[0].price, data[0].change_percent);

Python

import requests

r = requests.get(
    "https://mkinvesting.ir/api/v1/history/BRENT",
    params={"period": "daily", "range": "3M"},
    headers={"X-API-Key": "mk_live_…"},
)
for row in r.json()["data"]:
    print(row["date"], row["close"])

طرح‌ها و قیمت

	رایگان	پایه	حرفه‌ای	سازمانی
قیمت ماهانه	رایگان	۴۹۰٬۰۰۰ تومان	۱٬۴۹۰٬۰۰۰ تومان	توافقی
درخواست در روز	۱٬۰۰۰	۱۰٬۰۰۰	۵۰٬۰۰۰	۵۰۰٬۰۰۰
درخواست در دقیقه	۲۰	۶۰	۳۰۰	۱٬۵۰۰
تاریخچه‌ی روزانه	یک سال	کامل (از ۲۰۱۱)	کامل (از ۲۰۱۱)	کامل (از ۲۰۱۱)
تقویم اقتصادی با مقدار واقعی	—	✓	✓	✓
حرکت‌های غیرعادی قیمت	—	—	✓	✓
سرخط اخبار دسته‌بندی‌شده	—	—	✓	✓
کندل ساعتی (درون‌روزی)	—	—	✓	✓
استفاده‌ی تجاری	—	✓	✓	✓
ذکر منبع لازم	بله	بله	خیر	خیر
پشتیبانی	مستندات	تیکت	تیکت با اولویت	پشتیبانی اختصاصی و SLA
	دریافت کلید	درخواست طرح	درخواست طرح	تماس بگیرید

پرداخت ریالی؛ طرح سالانه با دو ماه رایگان. فعال‌سازی پس از درخواست (پرداخت آنلاین به‌زودی). هر پاسخ سرآیندهای X-RateLimit-Limit، X-RateLimit-Remaining، X-RateLimit-Reset و X-API-Plan دارد؛ شمارش روزانه نیمه‌شب UTC صفر می‌شود.

خطاها

401 missing_key — کلید فرستاده نشده یا قالبش نادرست است.
401 invalid_key — کلید ناشناخته یا باطل‌شده.
404 unknown_symbol(s) — نماد(ها) یافت نشد — از /api/v1/symbols فهرست را بگیرید.
403 plan_required — قابلیت یا عمق تاریخچه خارج از طرح فعلی؛ پیام، کمترین طرح لازم را می‌گوید.
429 rate_limited — بیش از سقف درخواست در دقیقه؛ Retry-After ثانیه‌های باقی‌مانده را می‌گوید.
429 quota_exceeded — سقف روزانه پر شد؛ سرآیند Retry-After زمان بازنشانی را می‌گوید (نیمه‌شب UTC).

داده‌ها از منابع عمومی جمع‌آوری می‌شوند و برای معامله‌ی رسمی مرجع نیستند؛ ذکر منبع «mkinvesting.ir» در نمایش عمومی الزامی است.

ویجت برای سایت شما

بدون برنامه‌نویسی: تیکر یا جدول قیمت زنده را با یک خط کد در سایتتان بگذارید — سازنده‌ی ویجت.