OHLCV چیست؟

در API روشا: open, high, low, close, volume

OHLCV کوتاه‌شدهٔ Open، High، Low، Close و Volume است. هر ردیف آن معاملات یک بازهٔ زمانی را در پنج عدد خلاصه می‌کند. بازه می‌تواند یک روز، یک ساعت یا یک دقیقه باشد. نمودار کندلی (شمعی) همین پنج عدد را رسم می‌کند و به هر ردیف «کندل» می‌گویند.

Close در بازار ایران دو معنا دارد

در بیشتر بازارهای جهان، Close قیمت آخرین معاملهٔ بازه است. در بورس تهران و فرابورس، قیمت رسمی پایان روز قیمت پایانی است که میانگین وزنی معاملات روز است. قیمت آخرین معامله عدد جدایی است. هنگام مقایسهٔ دو منبع داده یا دو نرم‌افزار نمودار، اول بررسی کنید Close کدام‌یک است.

چطور از روشا بگیرم؟

روزانه. سابقهٔ روزانه هر ردیف را با open، high، low، close، last، prev_close، volume، value و trades می‌دهد. close قیمت پایانی رسمی و last قیمت آخرین معامله است:

{"d":"2026-11-09","open":4600.0,"high":4670.0,"low":4590.0,"close":4670.0,
 "last":4670.0,"prev_close":4540.0,"volume":896903152.0,
 "value":4184289767010.0,"trades":8793,"jdate":"1405-08-18"}

درون‌روزی. /v1/instruments/{ref}/bars?date=&minutes= کندل‌های ۱ تا ۲۴۰ دقیقه‌ای یک روز را از ریز معاملات می‌سازد. در این کندل‌ها close قیمت آخرین معاملهٔ همان بازه است. این نقطهٔ پایانی به پلن دارای خانوادهٔ intraday نیاز دارد:

{"t":"2026-11-11T09:00:00+03:30","open":4950.0,"high":4950.0,"low":4950.0,
 "close":4950.0,"volume":324011903.0,"trades":2890}

نکته‌های کار با داده

• روز بدون معامله. open، high و low تهی هستند و volume صفر است. پیش از رسم نمودار یا محاسبهٔ اندیکاتور، این ردیف‌ها را کنار بگذارید.
• تعدیل. با adjusted=true ستون‌های قیمت تعدیل می‌شوند و حجم خام می‌ماند.
• ترتیب. ردیف‌ها از قدیم به جدید هستند و limit جدیدترین ردیف‌ها را نگه می‌دارد.
• واحد. قیمت‌ها به ریال است.
• شاخص‌ها فقط close، high و low دارند.

تبدیل پاسخ به DataFrame در دریافت دیتای بورس با پایتون آمده است.