نماد چیست؟

در API روشا: ticker

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

چرا نماد برای برنامه کافی نیست؟

• نماد تغییر می‌کند. شرکت‌ها تغییر نام می‌دهند یا از بازاری به بازار دیگر می‌روند.
• نماد یکتا نیست. یک نماد ممکن است چند ردیف قدیمی و جدید داشته باشد. حق تقدم یک سهم هم نماد جدا دارد که معمولاً با افزودن «ح» به نماد اصلی ساخته می‌شود.
• املای عربی و فارسی. نام‌ها در منبع با شکل عربی حروف «ی» و «ک» می‌آیند. روشا آن‌ها را به شکل فارسی یکسان می‌کند و در جست‌وجو هر دو شکل را می‌پذیرد.

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

فیلد ticker نماد فارسی و name نام کامل است. نماد دقیق را می‌توانید مستقیم به‌جای ref بگذارید:

curl "https://poolick.ir/v1/instruments/فولاد/daily?limit=1" \
  -H "Authorization: Bearer $ROSHA_KEY"

نماد در نشانی باید URL-encode شود؛ بیشتر کتابخانه‌های HTTP این کار را خودشان می‌کنند. اگر نماد به چند ابزار بخورد، روشا بهترین گزینه را برمی‌گزیند. وقتی پاسخ برایتان مهم است، یک بار با /v1/instruments?q= جست‌وجو کنید و از آن پس ins_code را به کار ببرید. جزئیات در مرجع نمادها است.