حقیقی و حقوقی چیست؟

در API روشا: /v1/instruments/{ref}/client-type

در بازار سرمایهٔ ایران هر کد معاملاتی یا به یک شخص حقیقی تعلق دارد یا به یک شخص حقوقی. شخص حقیقی یک فرد است. شخص حقوقی یک شرکت، صندوق سرمایه‌گذاری، بانک یا نهاد است. TSETMC برای هر نماد در هر روز، خرید و فروش این دو گروه را جدا منتشر می‌کند: تعداد معامله‌گران، حجم و ارزش.

در دادهٔ بازار چطور دیده می‌شود؟

هر روز ۱۲ عدد دارد: برای خرید و فروش، برای حقیقی و حقوقی، سه عدد تعداد، حجم و ارزش. در روشا پسوند _i_ یعنی حقیقی (individual) و _n_ یعنی حقوقی. فولاد در ۲۰ آبان ۱۴۰۵:

{"d":"2026-11-11","buy_i_volume":897812127.0,"buy_n_volume":244610101.0,
 "buy_i_count":1279,"buy_n_count":78,"sell_i_volume":157756362.0,
 "sell_n_volume":984665866.0,"sell_i_count":1866,"sell_n_count":19}

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

count تعداد کدهای معاملاتی است، نه تعداد معاملات.

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

curl "https://poolick.ir/v1/instruments/46348559193224090/client-type?limit=30" \
  -H "Authorization: Bearer $ROSHA_KEY"

ردیف‌ها از قدیم به جدید هستند و start، end و limit مثل سابقهٔ روزانه کار می‌کنند. این داده در خانوادهٔ history است و با کلید رایگان در دسترس است. در MCP ابزار get_client_type_history همین داده را می‌دهد. مرجع فیلدها در حقیقی و حقوقی است.