ریز معاملات چیست؟

در API روشا: /v1/instruments/{ref}/trades

هر بار که یک سفارش خرید با یک سفارش فروش جفت می‌شود، یک معامله ثبت می‌شود. ریز معاملات فهرست همهٔ این معامله‌ها به ترتیب زمان است. دادهٔ روزانه و کندل‌های درون‌روزی خلاصهٔ همین فهرست هستند.

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

/v1/instruments/{ref}/trades همهٔ معامله‌های یک روز را به ترتیب برمی‌گرداند، تا ۲۰٬۰۰۰ ردیف:

curl "https://poolick.ir/v1/instruments/46348559193224090/trades?date=2026-11-11" \
  -H "Authorization: Bearer $ROSHA_KEY"

ردیف واقعی از پاسخ:

{"ts":"2026-11-11T09:00:43+03:30","n_tran":1,"price":4950.0,"volume":300000.0,"canceled":false}

• ts زمان معامله به وقت تهران است.
• n_tran شمارهٔ ترتیبی معامله در آن روز است.
• price به ریال و volume تعداد سهم است.
• canceled معامله‌های ابطال‌شده را نشان می‌دهد. این ردیف‌ها حذف نمی‌شوند؛ اگر جمع می‌زنید، آن‌ها را کنار بگذارید.

برای کندل آماده، /v1/instruments/{ref}/bars را با minutes از ۱ تا ۲۴۰ به کار ببرید. کندل‌ها از همین معامله‌ها ساخته می‌شوند و معامله‌های ابطال‌شده را در بر ندارند.

محدودیت‌ها

• هر دو نقطهٔ پایانی به پلن دارای خانوادهٔ intraday نیاز دارند.
• ریز معاملات فقط برای روزهایی هست که ثبت شده‌اند. فهرست خالی یعنی برای آن روز معامله‌ای ذخیره نشده است، نه اینکه نماد معامله نشده باشد. برای تشخیص این دو، volume همان روز را در سابقهٔ روزانه ببینید.
• معامله‌های روز جاری پس از به‌روزرسانی پایان روز (ساعت ۱۸:۱۵ تهران) اضافه می‌شوند.
• برای ریز معاملات ابزار MCP وجود ندارد. در MCP فقط کندل‌ها با get_intraday_bars در دسترس‌اند.

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