REST API · MCP

API بورس و فرابورس،
برای کسانی که کد می‌نویسند.

دادهٔ تمیز بورس تهران، فرابورس ایران و صندوق‌های سرمایه‌گذاری، از سال ۱۳۸۰ تا امروز. یک درخواست بفرستید و JSON مرتب بگیرید؛ دیگر لازم نیست TSETMC را اسکرپ کنید.

  • ۲۶٬۳۷۲ نماد با سابقهٔ روزانه
  • ۵۹۵ صندوق سرمایه‌گذاری
  • ۶٬۱۷۴ روز معاملاتی

آمار تا ۲۳ آبان ۱۴۰۵. کلید رایگان: دادهٔ پایان روز، بدون کارت بانکی.

$ curl "https://poolick.ir/v1/instruments/فولاد/daily?limit=5" \
    -H "Authorization: Bearer $ROSHA_KEY"
{
  "ins_code": "46348559193224090",
  "ticker": "فولاد",
  "adjusted": false,
  "rows": [
    {"d": "2026-11-08", "open": 4540, "high": 4540, "low": 4430, "close": 4540, "last": 4540, "prev_close": 4410, "volume": 4125352226, "value": 18716642143750, "trades": 40440, "jdate": "1405-08-17"},
    {"d": "2026-11-09", "open": 4600, "high": 4670, "low": 4590, "close": 4670, "last": 4670, "prev_close": 4540, "volume": 896903152, "value": 4184289767010, "trades": 8793, "jdate": "1405-08-18"},
    {"d": "2026-11-10", "open": 4810, "high": 4810, "low": 4810, "close": 4810, "last": 4810, "prev_close": 4670, "volume": 1031669812, "value": 4962331795720, "trades": 7941, "jdate": "1405-08-19"},
    {"d": "2026-11-11", "open": 4950, "high": 4950, "low": 4950, "close": 4950, "last": 4950, "prev_close": 4810, "volume": 1142422228, "value": 5654990028600, "trades": 9998, "jdate": "1405-08-20"},
    {"d": "2026-11-14", "open": 4860, "high": 5090, "low": 4810, "close": 5020, "last": 5090, "prev_close": 4950, "volume": 4097617753, "value": 20568684791350, "trades": 40406, "jdate": "1405-08-23"}
  ]
}

پاسخ واقعی · دادهٔ پایانی تا ۲۳ آبان ۱۴۰۵

پایانی ۲۳ آبان ۱۴۰۵

pipeline

از تابلوی بورس تا دیتافریم شما

کاری که هر تیم داده یک بار برای خودش می‌سازد و هر بار که TSETMC تغییر می‌کند، دوباره تعمیرش می‌کند. ما یک بار ساخته‌ایم و هر روز نگهش می‌داریم.

  1. 01

    منبع

    TSETMC · FIPIran

    دادهٔ خام از سامانهٔ مدیریت فناوری بورس و فیپیران، همان منبعی که خودتان اسکرپ می‌کردید.

  2. 02

    دریافت

    ingestion

    نمای بازار هر ۳۰ ثانیه در ساعت معامله؛ پایان روز ساعت ۱۸:۱۵ با بازتلاش خودکار و نوشتن بدون تکرار.

  3. 03

    پاک‌سازی و تعدیل

    validation

    یکسان‌سازی ي/ك، تقویم معاملاتی واقعی، و تعدیل قیمت برای افزایش سرمایه و سود نقدی از روی رویدادهای ثبت‌شده.

  4. 04

    ذخیره

    TimescaleDB

    سری‌های زمانی از سال ۱۳۸۰؛ کد نماد (insCode) کلید ثابت است، حتی وقتی نماد تغییر نام می‌دهد.

  5. 05

    تحویل

    REST /v1 · MCP

    JSON یکدست با تاریخ میلادی و شمسی، قیمت به ریال، و همان داده برای دستیار هوش مصنوعی شما.

MCP

از دستیارتان بپرسید؛ جواب از دادهٔ واقعی می‌آید

سرور MCP روشا را یک بار به Claude، ChatGPT، Gemini یا Cursor وصل کنید. دستیار خودش نماد را پیدا می‌کند، داده را می‌گیرد و حساب می‌کند.

راه‌اندازی در یک خط

بازپخش یک گفت‌وگو؛ فراخوانی‌ها و اعداد واقعی‌اند (۲۳ آبان ۱۴۰۵).

میانگین حجم معاملات فولاد در ۳۰ روز معاملاتی گذشته در مقایسه با همین بازه در سال قبل چقدر بوده؟

search_instruments{"query":"فولاد","limit":3}
{
  "results": [
    {"ins_code": "46348559193224090", "ticker": "فولاد", "name": "فولاد مبارکه اصفهان", "flow": 1, "active": true},
    {"ins_code": "56871139881800017", "ticker": "توسکا", "name": "صندوق س توسعه فولاد- ثابت", "flow": 1, "active": true},
    {"ins_code": "25422370845365439", "ticker": "حدید", "name": "صندوق صنایع گنجینه فولاد1-بخشی", "flow": 1, "active": true}
  ]
}
get_daily_history{"ref":"46348559193224090","limit":30}
{
  "ins_code": "46348559193224090",
  "ticker": "فولاد",
  "adjusted": false,
  "rows": [
    {"d": "2026-10-04", "close": 3690, "volume": 4528850916, "value": 16703993610680, "jdate": "1405-07-12"},
    {"d": "2026-10-05", "close": 3770, "volume": 4227500464, "value": 15928799718890, "jdate": "1405-07-13"},
    "… 27 more rows",
    {"d": "2026-11-14", "close": 5020, "volume": 4097617753, "value": 20568684791350, "jdate": "1405-08-23"}
  ]
}
get_daily_history{"ref":"46348559193224090","start":"2025-10-04","end":"2025-11-14"}
{
  "ins_code": "46348559193224090",
  "ticker": "فولاد",
  "adjusted": false,
  "rows": [
    {"d": "2025-10-04", "close": 2475, "volume": 186724370, "value": 462142815750, "jdate": "1404-07-12"},
    {"d": "2025-10-05", "close": 2549, "volume": 1220875392, "value": 3111544308841, "jdate": "1404-07-13"},
    "… 27 more rows",
    {"d": "2025-11-12", "close": 3068, "volume": 371877013, "value": 1140904652788, "jdate": "1404-08-21"}
  ]
}

میانگین حجم روزانهٔ فولاد در ۳۰ روز معاملاتی اخیر ۲٫۶۶ میلیارد سهم بوده است. در همین بازه در سال قبل (۳۰ روز معاملاتی) این عدد ۸۸۸٫۵۱ میلیون سهم بود؛ یعنی حجم ۱۹۹٫۱٪ بیشتر شده است.

این یک محاسبه روی دادهٔ معاملات است، نه توصیهٔ سرمایه‌گذاری.

coverage

چه داده‌ای می‌گیرید

این‌ها عکس نیستند؛ هر کاشی از همان داده‌ای رسم شده که API به شما می‌دهد.

explorer

نماد خودتان را جست‌وجو کنید

نام یا نماد سهم، صندوق یا شاخص را بنویسید تا ببینید از چه تاریخی داده داریم. هر نتیجه یک صفحهٔ رایگان با نمودار و دانلود CSV دارد.

همهٔ پوشش داده · فهرست نمادها · صندوق‌ها · شاخص‌ها

pricing

پلن را با دو پرسش پیدا کنید

از رایگان شروع کنید. هر وقت بیشتر لازم داشتید، در پنل ارتقا بدهید. جدول کامل مقایسه

پلن‌ها

رایگان

برای شروع و آزمایش

رایگان

  • ۱٬۰۰۰ درخواست در روز
  • ۱۰ درخواست در دقیقه
  • سابقهٔ روزانه و صندوق‌ها
  • بدون دادهٔ لحظه‌ای
  • سرور MCP
  • ۱ کلید فعال
کلید رایگان بگیرید

پایه

برای تحلیلگر و پروژهٔ شخصی

۴۹۰٬۰۰۰ تومان / ماه

  • ۱۰٬۰۰۰ درخواست در روز
  • ۶۰ درخواست در دقیقه
  • سابقهٔ روزانه و صندوق‌ها
  • بدون دادهٔ لحظه‌ای
  • سرور MCP
  • ۲ کلید فعال
شروع کنید

حرفه‌ای

برای تیم‌های داده و الگوریتمی

۱٬۹۰۰٬۰۰۰ تومان / ماه

  • ۵۰٬۰۰۰ درخواست در روز
  • ۱۲۰ درخواست در دقیقه
  • سابقهٔ روزانه و صندوق‌ها
  • دادهٔ لحظه‌ای
  • سرور MCP
  • ۳ کلید فعال
شروع کنید

سازمانی

برای کارگزاری‌ها، صندوق‌ها و فین‌تک‌ها

تماس بگیرید

  • بدون سقف درخواست در روز
  • ۶۰۰ درخواست در دقیقه
  • سابقهٔ روزانه و صندوق‌ها
  • دادهٔ لحظه‌ای
  • سرور MCP
  • ۱۰ کلید فعال
با ما صحبت کنید
limits.json
 

قیمت‌ها به تومان و بدون مالیات بر ارزش افزوده (۱۰٪) است؛ مبلغ نهایی پیش از پرداخت نشان داده می‌شود. سقف‌ها برای هر کلید است. دانشجو یا پژوهشگر هستید؟ پلن دانشگاهی رایگان.

trust

چیزهایی که پیش از اعتماد باید بدانید

یک سرویس با صفحهٔ وضعیت عمومی، صورت‌حساب با مالیات بر ارزش افزوده و پاسخ روشن دربارهٔ آنچه نداریم.

پرسش‌های پرتکرار، پاسخ‌های صریح

داده‌ها لحظه‌ای است یا با تأخیر؟

در پلن رایگان و صفحه‌های عمومی سایت فقط دادهٔ پایان روز است که ساعت ۱۸:۱۵ هر روز معاملاتی به‌روز می‌شود. دادهٔ لحظه‌ای (قیمت زنده هر ۳۰ ثانیه، دفتر سفارش و ریز معاملات) در پلن‌های دارای خانوادهٔ intraday در دسترس است.

چه چیزهایی را پوشش نمی‌دهید؟

صورت‌های مالی و اطلاعیه‌های کدال، دادهٔ بنیادی شرکت‌ها، بورس‌های خارج از ایران و ارز و طلا را نداریم. ریز معاملات فقط برای روزهایی وجود دارد که ثبت شده‌اند؛ پیش از تکیه بر آن، پوشش نماد را در صفحهٔ «پوشش داده» ببینید.

قیمت تعدیل‌شده را چطور حساب می‌کنید؟

با adjusted=true قیمت‌های پیش از هر افزایش سرمایه یا سود نقدی با ضریب همان رویداد (نسبت قیمت پایانی تعدیل‌شده به تعدیل‌نشده در TSETMC) اصلاح می‌شود. ضریب‌ها روی هم ضرب می‌شوند و حجم تغییر نمی‌کند. فهرست رویدادها را از نقطهٔ پایانی adjustments می‌گیرید و می‌توانید محاسبه را خودتان بازبینی کنید.

قیمت‌ها به ریال است یا تومان؟

همهٔ قیمت‌ها و ارزش‌ها در API به ریال است، همان‌طور که TSETMC و فیپیران منتشر می‌کنند. فقط قیمت اشتراک‌ها در سایت به تومان نوشته شده است.

اگر به سقف پلن برسم چه می‌شود؟

پاسخ 429 می‌گیرید با سرآیند Retry-After که می‌گوید چند ثانیه صبر کنید. سقف دقیقه‌ای در ابتدای هر دقیقه و سهمیهٔ روزانه در نیمه‌شب تهران صفر می‌شود. هزینهٔ اضافه‌ای حساب نمی‌شود.

می‌توانم داده را در محصول خودم به کاربرانم نشان بدهم؟

استفاده در تحلیل، مدل و داشبورد داخلی آزاد است. بازنشر دادهٔ خام به اشخاص ثالث یا فروش دوبارهٔ آن به مجوز سازمانی نیاز دارد؛ برای این کار با ما تماس بگیرید.

کلید رایگان بگیرید و اولین درخواست را بفرستید.

کلید رایگان بگیرید

ثبت‌نام با موبایل یا ایمیل · بدون کارت بانکی · کمتر از دو دقیقه تا اولین پاسخ

Esc

نمونه: «فولاد»، «شاخص کل»، «عیار»، «rate limit»