API رایگان صندوق‌های سرمایه‌گذاری؛ قیمت و NAV صندوق‌ها

قیمت معاملاتی صندوق‌های قابل معامله در بورس و فرابورس (درآمد ثابت، سهامی، طلا، مختلط و …) به‌همراه NAV، یعنی ارزش خالص دارایی هر واحد، برای صندوق‌هایی که بورس آن را منتشر می‌کند؛ با همان قالب سهام.

دریافت رایگان API key مرجع کامل API

قیمت معاملاتی و NAV

صندوق‌ها نوع fund دارند. referencePrice قیمت پایانی تابلوی صندوق است و NAV جدا در fund.nav می‌آید، همراه با زمانی که خوانده شده (fund.navObservedAt). NAV در ساعت معاملات هر چند دقیقه به‌روز می‌شود. برای صندوقی که بورس NAV آن را منتشر نکرده، fund.nav برابر null است.

GET/v1/quotes?symbols=آتیه ملت200 OK

{
  "data": [
    {
      "id": "tse:IRT1ATML0001",
      "market": "tse",
      "type": "fund",
      "symbol": "آتیه ملت",
      "name": {
        "fa": "صندوق س آتیه ملت-ثابت",
        "en": null
      },
      "currency": "IRR",
      "unit": "unit",
      "status": "active",
      "referencePrice": 20275,
      "price": {
        "last": 20275,
        "close": 20275,
        "open": 20274,
        "high": 20275,
        "low": 20274,
        "previousClose": 20243
      },
      "change": {
        "amount": 32,
        "percent": 0.16
      },
      "limits": {
        "upper": 20850,
        "lower": 19636
      },
      "orderBook": {
        "bestBid": 20274,
        "bestAsk": 20275
      },
      "trading": {
        "volume": 56548496,
        "value": 1146495250338,
        "count": 360
      },
      "fund": {
        "nav": 20201,
        "navObservedAt": "2026-10-22T10:36:22.567Z"
      },
      "fundamentals": {
        "eps": null,
        "pe": null,
        "sharesOutstanding": "10000000000",
        "marketCap": "202750000000000"
      },
      "tradeDate": "2026-10-21",
      "lastTradeAt": "2026-10-21T17:59:55+03:30",
      "observedAt": "2026-10-22T10:36:22.567Z",
      "stale": false,
      "source": "tsetmc"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 100,
    "offset": 0
  }
}

نمونه‌ی پاسخ با مقادیر یک روز مشخص؛ قیمت روز نیست.

همه‌ی صندوق‌ها در یک درخواست

curl -H "x-api-key: YOUR_API_KEY" \
  "https://nerkhy.ir/v1/quotes?market=tse&type=fund&limit=1000"

const url = new URL("https://nerkhy.ir/v1/quotes");
url.searchParams.set("market", "tse");
url.searchParams.set("type", "fund");
url.searchParams.set("limit", "1000");

const res = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" } });
const { data, meta } = await res.json();

import requests

res = requests.get(
    "https://nerkhy.ir/v1/quotes",
    params={"market": "tse", "type": "fund", "limit": "1000"},
    headers={"x-api-key": "YOUR_API_KEY"},
    timeout=10,
)
res.raise_for_status()
data = res.json()["data"]

<?php
$url = "https://nerkhy.ir/v1/quotes" . "?" . http_build_query(["market" => "tse", "type" => "fund", "limit" => "1000"]);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$data = $body["data"];

اگر تعداد از ۱۰۰۰ بیشتر شد، با offset صفحه‌ی بعد را بگیرید (meta.total تعداد کل است). برای چند صندوق مشخص، نمادها را در symbols یا شناسه‌ها را در ids بفرستید.

محاسبه‌ی حباب صندوق

حباب (یا تخفیف) صندوق اختلاف قیمت تابلو با NAV است: (قیمت پایانی − NAV) ÷ NAV. با داده‌ی نمونه‌ی بالا: (۲۰٬۲۷۵ − ۲۰٬۲۰۱) ÷ ۲۰٬۲۰۱ ≈ ۰٫۳۷٪ حباب مثبت.

const res = await fetch("https://nerkhy.ir/v1/quotes?market=tse&type=fund&limit=1000", {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const { data } = await res.json();

const premiums = data
  .filter((q) => q.fund?.nav && q.referencePrice)
  .map((q) => ({
    symbol: q.symbol,
    premiumPercent: ((q.referencePrice - q.fund.nav) / q.fund.nav) * 100,
  }))
  .sort((a, b) => b.premiumPercent - a.premiumPercent);

import requests

res = requests.get(
    "https://nerkhy.ir/v1/quotes",
    params={"market": "tse", "type": "fund", "limit": 1000},
    headers={"x-api-key": "YOUR_API_KEY"},
    timeout=30,
)
funds = [q for q in res.json()["data"] if (q["fund"] or {}).get("nav") and q["referencePrice"]]

premiums = sorted(
    ((q["symbol"], (q["referencePrice"] - q["fund"]["nav"]) / q["fund"]["nav"] * 100) for q in funds),
    key=lambda row: row[1],
    reverse=True,
)

تاریخچه‌ی قیمت صندوق

کندل روزانه‌ی قیمت معاملاتی هر صندوق از GET /v1/instruments/{id}/candles می‌آید؛ برای بازده دوره‌ای یا نمودار. جزئیات در API تاریخچه.

NAV فقط به‌صورت آخرین مقدار در قیمت هر صندوق هست؛ تاریخچه‌ی روزانه بر اساس قیمت معاملاتی است.

همین حالا شروع کنید

ثبت‌نام و استفاده از نرخی API رایگان است. پس از تأیید حساب، کلید API را از داشبورد بسازید و اولین درخواست را بفرستید.

دریافت رایگان API key مرجع کامل API