وب‌سرویس (API) کدال بورس برای دریافت لحظه‌ای اطلاعیه‌ها و گزارش‌ها

سامانه کدال، به عنوان مرجع رسمی انتشار گزارش‌ها و اطلاعیه‌های مالی شرکت‌های پذیرفته‌شده در بورس، یکی از مهم‌ترین ابزارها برای تحلیل‌گران و سرمایه‌گذاران است. با استفاده از وب‌سرویس کدال بورس در پلتفرم BrsApi.ir شما می‌توانید به‌صورت لحظه‌ای به گزارش‌ها، اطلاعیه‌ها و داده‌های مالی منتشرشده دسترسی پیدا کنید و از این اطلاعات در تحلیل‌های مالی و تصمیم‌گیری‌های خود استفاده کنید.

ویژگی‌های وب‌سرویس کدال بورس

✅ دسترسی به گزارش‌های مالی و اطلاعیه‌ها: این API شامل اطلاعاتی مانند صورت‌های مالی، گزارش‌های تفسیری مدیریت، اطلاعیه‌های تقسیم سود، افزایش سرمایه و سایر داده‌های منتشرشده در سامانه کدال است.

✅ به‌روزرسانی لحظه‌ای: با استفاده از این وب‌سرویس، شما همیشه به آخرین گزارش‌ها و اطلاعیه‌های شرکتی دسترسی خواهید داشت.

✅ سهولت یکپارچه‌سازی: با خروجی دیتا در قالب استاندارد JSON، به راحتی در سیستم‌های مالی، نرم‌افزارهای تحلیل بورس و ابزارهای مدیریت سرمایه‌گذاری قابل پیاده‌سازی است.

کاربردهای وب‌سرویس کدال بورس

تحلیل صورت‌های مالی شرکت‌ها: تحلیل‌گران می‌توانند از داده‌های دقیق این وب‌سرویس برای بررسی عملکرد شرکت‌ها و ارزیابی سودآوری استفاده کنند.
پیاده‌سازی ابزارهای هوشمند مالی: توسعه‌دهندگان می‌توانند با استفاده از این API، ابزارهایی مانند ردیاب اطلاعیه‌ها یا سیستم‌های هشداردهنده مالی بسازند.
مدیریت پورتفولیو سرمایه‌گذاری: سرمایه‌گذاران می‌توانند از این اطلاعات برای بهینه‌سازی پورتفولیوی خود استفاده کنند.

راهنمای دریافت اطلاعیه‌های کدال:

https://Api.BrsApi.ir/Codal/Announcement.php?key=YourApiKey&l18=Symbol&category=Number&audited=true|false&unaudited=true|false&only_main_company=true|false&only_subsidiaries=true|false&date_start=YYYY-MM-DD&date_end=YYYY-MM-DD&page=Number

مثال:

https://Api.BrsApi.ir/Codal/Announcement.php?key=FreeSV0E1LSgB9RDjuf0QorSLViX8pPG&l18=وبملت&category=1&audited=true&unaudited=true&only_main_company=true&only_subsidiaries=true&date_start=1403-01-01&date_end=1403-10-30&page=1

جدول راهنمای Api کدال بورس Tsetmc - پارامترهای ورودی

متغیر	ضرورت	توضیح	مثال
key	دارد	کلید وب‌سرویس	FreeSV0E1LSgB9RDjuf0QorSLViX8pPG
l18	ندارد	نماد	وبملت
category	ندارد	آیدی گروه اطلاعیه: 1 = اطلاعات و صورت مالی سالانه 2 = افشای اطلاعات بااهمیت و شفاف سازی 3 = گزارش عملکرد ماهانه 4 = اساسنامه/امیدنامه 5 = اطلاعات هیئت مدیره و کمیته حسابرسی 6 = آگهی دعوت به مجامع و تصمیمات 7 = افزایش سرمایه 8 = شفاف سازی مربوط به بورس/فرابورس 9 = شفاف سازی مربوط به سازمان 10 = سایر 11 = اوراق بدهی	1
period	ندارد	طول دوره (مقادیر عددی 1 تا 12) ماه	3
audited	ندارد	حسابرسی شده	true
unaudited	ندارد	حسابرسی نشده	true
only_main_company	ندارد	فقط شرکت اصلی	true
only_subsidiaries	ندارد	فقط زیرمجموعه ها	false
date_start	ندارد	بازه تاریخی اطلاعیه - تاریخ آغاز	1403-01-01
date_end	ندارد	بازه تاریخی اطلاعیه - تاریخ پایان	1403-10-30
page	ندارد	شماره صفحه	1

* تمامی پارامترهای ورودی به‌استثناء key اختیاری هستند و درصورتیکه هر یک از آنها ارسال نشود، آن پارامتر فیلتر نخواهد شد. پارامترهای audited ، unaudited ، only_main_company ، only_subsidiaries در صورت عدم ارسال دارای مقدار پیش‌فرض true خواهند بود. پارامتر page نیز اگر ارسال نشود دارای مقدار پیش‌فرض 1 خواهد بود. در ادامه چند مثال برای درک بهتر آورده می‌شود.

مثال 1) ارسال ریکوئست برای دریافت گزارش عملکرد ماهانه تمام نمادها در دی ماه 1403 :

در این مثال چون اطلاعیه‌های تمامی نمادها را میخواهیم، نباید پارامتر l18 را ارسال کنیم.

https://Api.BrsApi.ir/Codal/Announcement.php?key=FreeSV0E1LSgB9RDjuf0QorSLViX8pPG&category=3&date_start=1403-10-01&date_end=1403-10-30&page=1

مثال 2) ارسال ریکوئست برای دریافت تمامی گزارش‌ها :

در این مثال نیاز به ارسال هیچ پارامتری بجز key نیست. پارامتر page هم که ارسال نمی‌شود بطور پیش‌فرض مقدار 1 را می‌گیرد.

https://Api.BrsApi.ir/Codal/Announcement.php?key=FreeSV0E1LSgB9RDjuf0QorSLViX8pPG

مثال 3) ارسال ریکوئست برای دریافت صفحه 3 از تمامی گزارش‌های نماد وبملت از تاریخ 1 مهر 1400 تاکنون :

در این مثال چون تمامی گروه‌های اطلاعیه را می‌خواهیم، پارامتر category را ارسال نمی‌کنیم. همچنین چون اطلاعیه‌ها را تا روز جاری میخواهیم، نیازی به ارسال پارامتر date_end نیست.

https://Api.BrsApi.ir/Codal/Announcement.php?key=FreeSV0E1LSgB9RDjuf0QorSLViX8pPG&l18=وبملت&date_start=1400-07-01&page=3

مثال 4) ارسال ریکوئست برای دریافت از تمامی گزارش‌های حسابرسی شده نماد وبملت :

در این مثال چون میخواهیم فقط گزارش‌های حسابرسی شده را دریافت کنیم باید پارامتر audited با مقدار true و پارامتر unaudited را با مقدار false ارسال کنیم. پارامترهای only_main_company و only_subsidiaries اگر ارسال نشوند، مقدار پیش‌فرض true را می‌گیرند.

https://Api.BrsApi.ir/Codal/Announcement.php?key=FreeSV0E1LSgB9RDjuf0QorSLViX8pPG&l18=وبملت&audited=true&unaudited=false

جدول راهنمای Api کدال بورس Tsetmc