کد نماد (insCode) چیست؟

در API روشا: ins_code

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

چرا به‌جای نماد از این کد استفاده می‌شود؟

نماد فارسی برای آدم‌ها خواناست، اما برای برنامه پایدار نیست. نمادها تغییر نام می‌دهند، میان بازارها جابه‌جا می‌شوند و گاهی یک نماد قدیمی دوباره به کار می‌رود. insCode ثابت می‌ماند. به همین دلیل، نشانی صفحه‌های نماد در روشا هم با این کد ساخته شده است، مثل /symbols/46348559193224090/.

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

با جست‌وجو، کد هر نماد را پیدا کنید:

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

فیلد ins_code در پاسخ، همین کد است. در همهٔ مسیرهای /v1/instruments/{ref}/… می‌توانید آن را به‌جای ref بگذارید.

نکتهٔ مهم برای برنامه‌نویسان

ins_code در JSON رشته است، نه عدد. این کد از بازهٔ عدد صحیح امن جاوااسکریپت بزرگ‌تر است و اگر به عدد تبدیل شود، رقم‌های آخر آن عوض می‌شود. در پایگاه داده، pandas و اکسل هم آن را متن نگه دارید. جزئیات در قراردادها و مرجع نمادها آمده است.