API رایگان تاریخچه‌ی قیمت؛ کندل روزانه‌ی سهام، دلار، طلا و سکه

قیمت روزانه‌ی باز، بیشینه، کمینه و پایانی (OHLC) برای سهام، حق‌تقدم‌ها، صندوق‌ها، گواهی‌های کالایی و شاخص‌های بورس، و همه‌ی قیمت‌های بازار آزاد؛ برای نمادهای قدیمی‌تر بیش از ده سال. برای نمودار، بک‌تست و محاسبه‌ی بازده.

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

درخواست

GET /v1/instruments/{id}/candles برای هر روز معاملاتی یک کندل برمی‌گرداند.

پارامتر	معنا
`from`	اولین روز بازه، میلادی و به شکل YYYY-MM-DD (اختیاری)
`to`	آخرین روز بازه (اختیاری)
`limit`	تعداد روز؛ پیش‌فرض ۳۶۵ و حداکثر ۱۰٬۰۰۰. از داخل بازه جدیدترین روزها برمی‌گردند
`order`	`asc` (پیش‌فرض، قدیم به جدید) یا `desc`؛ فقط ترتیب نمایش را عوض می‌کند

curl -H "x-api-key: YOUR_API_KEY" \
  "https://nerkhy.ir/v1/instruments/spot:USD/candles?from=2025-03-21&to=2026-03-20"

const url = new URL("https://nerkhy.ir/v1/instruments/spot:USD/candles");
url.searchParams.set("from", "2025-03-21");
url.searchParams.set("to", "2026-03-20");

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/instruments/spot:USD/candles",
    params={"from": "2025-03-21", "to": "2026-03-20"},
    headers={"x-api-key": "YOUR_API_KEY"},
    timeout=10,
)
res.raise_for_status()
data = res.json()["data"]

<?php
$url = "https://nerkhy.ir/v1/instruments/spot:USD/candles" . "?" . http_build_query(["from" => "2025-03-21", "to" => "2026-03-20"]);
$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"];

GET/v1/instruments/spot:USD/candles?limit=2200 OK

{
  "data": [
    {
      "date": "2026-10-20",
      "open": 2658000,
      "high": 2668000,
      "low": 2638000,
      "close": 2648000,
      "last": null,
      "previousClose": null,
      "volume": null,
      "value": null,
      "tradeCount": null,
      "source": "tgju"
    },
    {
      "date": "2026-10-21",
      "open": 2645650,
      "high": 2704000,
      "low": 2645600,
      "close": 2694000,
      "last": null,
      "previousClose": null,
      "volume": null,
      "value": null,
      "tradeCount": null,
      "source": "tgju"
    }
  ],
  "meta": {
    "id": "spot:USD",
    "count": 2,
    "currency": "IRR",
    "unit": "unit"
  }
}

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

فیلدهای کندل

فیلد	معنا
`date`	روز معاملاتی، میلادی (روز تقویم تهران)
`open · high · low · close`	قیمت باز، بیشینه، کمینه و پایانی روز
`last`	قیمت آخرین معامله‌ی روز (بورس)
`previousClose`	قیمت پایانی روز قبل (بورس)
`volume · value · tradeCount`	حجم، ارزش و تعداد معاملات روز (بورس)

برای بازار آزاد فقط قیمت‌ها هست و فیلدهای معاملاتی null هستند. واحد پول و واحد قیمت در meta.currency و meta.unit می‌آید.

GET/v1/instruments/tse:IRO1FOLD0001/candles?limit=1&order=desc200 OK

{
  "data": [
    {
      "date": "2026-10-21",
      "open": 4340,
      "high": 4340,
      "low": 4210,
      "close": 4220,
      "last": 4230,
      "previousClose": 4340,
      "volume": 4864252101,
      "value": 20519267355350,
      "tradeCount": 48279,
      "source": "tsetmc"
    }
  ],
  "meta": {
    "id": "tse:IRO1FOLD0001",
    "count": 1,
    "currency": "IRR",
    "unit": "share"
  }
}

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

تاریخچه‌ی کدام نمادها هست

بازار	نمادهای دارای تاریخچه
بورس و فرابورس	سهام، حق‌تقدم، صندوق‌ها، گواهی‌های سپرده‌ی کالایی و شاخص‌ها
بازار آزاد	همه‌ی قیمت‌های بازار آزاد: ارز، طلا، سکه، رمزارز و فلزات

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

تاریخ شمسی و تحلیل داده

تاریخ‌ها میلادی‌اند تا مرتب‌سازی و محاسبه ساده باشد. برای نمایش شمسی در JavaScript از Intl و در Python از کتابخانه‌ی jdatetime استفاده کنید. نمونه‌ی Python زیر تاریخچه را در یک DataFrame می‌ریزد.

import pandas as pd
import requests

res = requests.get(
    "https://nerkhy.ir/v1/instruments/tse:IRO1FOLD0001/candles",
    params={"from": "2025-03-21", "limit": 10000},
    headers={"x-api-key": "YOUR_API_KEY"},
    timeout=30,
)
df = pd.DataFrame(res.json()["data"]).set_index("date")
df["return"] = df["close"].pct_change()
print(df[["open", "high", "low", "close", "volume"]].tail())

const jalali = new Intl.DateTimeFormat("fa-IR-u-ca-persian", { dateStyle: "medium" });

for (const candle of data) {
  console.log(jalali.format(new Date(candle.date)), candle.close);
}

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

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

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