{"id":34055102,"url":"https://github.com/sm-sokout/tse-option","last_synced_at":"2026-03-27T04:31:12.643Z","repository":{"id":65529482,"uuid":"572428025","full_name":"sm-sokout/tse-option","owner":"sm-sokout","description":"بررسی و دریافت اطلاعات اختیار معاملات بورس تهران و فرابورس ایران | Options on the Tehran Stock Exchange (TSE) and IranFarabourse (IFB)","archived":false,"fork":false,"pushed_at":"2026-02-13T21:08:30.000Z","size":903,"stargazers_count":26,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-14T03:57:37.239Z","etag":null,"topics":["black-scholes-merton","ifb","implied-volatility","iran-farabourse","option","option-pricing","pricing","tehran-stock-exchange","tse"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sm-sokout.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-11-30T08:53:58.000Z","updated_at":"2026-02-13T21:08:33.000Z","dependencies_parsed_at":"2025-01-23T11:32:04.609Z","dependency_job_id":null,"html_url":"https://github.com/sm-sokout/tse-option","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sm-sokout/tse-option","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sm-sokout%2Ftse-option","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sm-sokout%2Ftse-option/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sm-sokout%2Ftse-option/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sm-sokout%2Ftse-option/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sm-sokout","download_url":"https://codeload.github.com/sm-sokout/tse-option/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sm-sokout%2Ftse-option/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31019340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T03:51:26.850Z","status":"ssl_error","status_checked_at":"2026-03-27T03:51:09.693Z","response_time":164,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["black-scholes-merton","ifb","implied-volatility","iran-farabourse","option","option-pricing","pricing","tehran-stock-exchange","tse"],"created_at":"2025-12-14T02:41:18.179Z","updated_at":"2026-03-27T04:31:12.634Z","avatar_url":"https://github.com/sm-sokout.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tse_option\r\n\r\n\r\n\r\nاین پکیج جهت بررسی و دریافت داده های اختیار معاملات بورس اوراق بهادار تهران و فرابورس ایران ایجاد شده است. \r\n\r\nبرخی از توابع این پروژه،از ماژول های [finpy_tse](https://github.com/ARahimiQuant/finpy-tse) و [tsemodule5](https://github.com/python4financeacademy/tsemodule5) اقتباس شده اند. همچنین باید تشکر کنم از آقای حمید ماهان که برای رفع مشکل دریافت دیتای فرابورس کمک کردند..\r\n\r\n- کانال تلگرام: [@algorithm_edge](https://t.me/algorithm_edge)\r\n\r\n----------------------------------------------\r\n\r\n**توجه****: کلیه خروجی این ماژول از جمله قیمت گذاری و محاسبه تلاطم ضمنی و ... به جهت تسهیل در تصمیم گیری سرمایه گذاران است و هیچگونه پیشنهادی برای خرید یا فروش آن محسوب نمی شود. لذا تمامی عواقب سرمایه گذاری به عهده شخص سرمایه گذار است و توسعه دهنده هیچ مسئولیتی در قبال زیان های احتمالی ندارند.** \r\n\r\n----------------------------------------------\r\n\r\n\r\n**تغییرات نسخه جدید(0.1.1.0)**: \r\n\r\n\r\n1- امکان دانلود تاریخچه قیمت سهام و اوراق اختیار معامله\r\n\r\n\r\n2- رفع برخی مشکلات\r\n\r\n\r\n----------------------------------------------\r\n\r\n\r\n**تغییرات نسخه جدید(0.1.2.1)**: \r\n\r\n\r\n1- بروزرسانی لینک های tsetmc\r\n\r\n\r\n2- امکان دریافت همزمان تاریخچه قیمت چندین نماد(مانند yfinance)\r\n\r\n\r\n3- بروزرسانی لینک سایت tse.ir\r\n\r\n\r\n----------------------------------------------\r\n\r\n\r\n**تغییرات نسخه جدید(0.1.2.3)**: \r\n\r\n\r\n1- رفع مشکل محاسبه نرخ بهره بدون ریسک (میانگین نرخ اخزا)\r\n\r\n\r\n2- بهبود کلی و رفع برخی مشکلات\r\n\r\n\r\n----------------------------------------------\r\n\r\n\r\n**تغییرات نسخه جدید(0.1.3.0)**: \r\n\r\n\r\n1- امکان دریافت دیتای پوت آپشن های بورس تهران\r\n\r\n\r\n2- رفع مشکل دریافت دیتای فرابورس\r\n\r\n\r\n3- اضافه شدن ستون وجه تضمین\r\n\r\n\r\n----------------------------------------------\r\n\r\n\r\n**تغییرات نسخه جدید(0.1.4.0)**: \r\n\r\n\r\n1- رفع مشکل عدم دریافت دیتای اختیار معاملات\r\n\r\n2- دریافت دیتای موقعیت های باز هر اختیار معامله\r\n\r\n3- در صورت خطا در محاسبه نرخ بهره، این مقدار بصورت دستی از کاربر گرفته می شود\r\n\r\n\r\n----------------------------------------------\r\n\r\n\r\n### بروزرسانی\r\n```python\r\npip install tse-option --upgrade\r\n```\r\n\r\n### نصب\r\n```python\r\npip install tse-option\r\n```\r\n\r\n### فراخوانی\r\n```python\r\nimport tse_option as tso\r\n```\r\n\r\n-----------------------------------------------------------------\r\n\r\n\r\n#### زنجیره قراردادهای یک سهم\r\n```python\r\ndf = tso.option_chain(symbol=\"خودرو\", trading_days=100, IV=False, leverage=True, P_BSM=False, sort=\"Maturity\")\r\n```\r\n\r\n| arguments   |    توضیحات |\r\n|:------------|:-----------|\r\n| symbol      | نماد دارایی پایه |\r\n| trading_days| تعداد روز معاملاتی برای محاسبه تلاطم تاریخی |\r\n| IV          | تلاطم ضمنی (Implied Volatility) |\r\n| leverage       | محاسبه اهرم |\r\n| P_BSM       | نسبت قیمت بازار به BSM |\r\n| sort        | نحوه مرتب سازی |\r\n\r\n\r\n(می توان از متغیرهایی چون زمان باقی مانده تا سررسید(Maturity)،قیمت اعمال(Strike Price) و موقعیت های باز(Open Interests) برای مرتب سازی استفاده کرد)\r\n\r\n\r\n-----------------------------------------------------------------\r\n\r\n#### اختیار خرید\r\n```python\r\ndf = tso.call(option_symbol=\"ضخود1130\", trading_days=100, IV=False, leverage=True, P_BSM=False)\r\n```\r\n\r\n\r\n| arguments   |    توضیحات |\r\n|:------------|:-----------|\r\n| option_symbol      | نماد اختیار خرید |\r\n| trading_days| تعداد روز معاملاتی برای محاسبه تلاطم تاریخی |\r\n| IV          | تلاطم ضمنی (Implied Volatility) |\r\n| leverage       | محاسبه اهرم |\r\n| P_BSM       | نسبت قیمت بازار به BSM |\r\n\r\n\r\n-----------------------------------------------------------------\r\n\r\n#### اختیار فروش\r\n```python\r\ndf = tso.put(option_symbol=\"طخود1138\", trading_days=100, IV=False, leverage=True, P_BSM=False)\r\n```\r\n\r\n\r\n| arguments   |    توضیحات |\r\n|:------------|:-----------|\r\n| option_symbol      | نماد اختیار فروش |\r\n| trading_days| تعداد روز معاملاتی برای محاسبه تلاطم تاریخی |\r\n| IV          | تلاطم ضمنی (Implied Volatility) |\r\n| leverage       | محاسبه اهرم |\r\n| P_BSM       | نسبت قیمت بازار به BSM |\r\n\r\n\r\n-----------------------------------------------------------------\r\n\r\n#### دریافت تاریخچه قیمت\r\n```python\r\ndf = tso.download(\"خودرو\", j_date=True, start=\"1402-01-01\", end=None, adjust_price=True, drop_unadjusted=False)\r\n```\r\n```python\r\ndf = tso.download(symbols=[\"خودرو\",\"فولاد\",\"وبملت\"], j_date=False, start=\"2023-01-01\", end=None, adjust_price=False, drop_unadjusted=False)\r\n```\r\n\r\n| arguments   |    توضیحات |\r\n|:------------|:-----------|\r\n| symbols      | نماد یا نمادها |\r\n| j_date| تاریخ جلالی |\r\n| start          | تاریخ شروع |\r\n| end       | تاریخ پایان |\r\n| adjust_price       | قیمت تعدیل شده |\r\n| drop_unadjusted       | حذف قیمت های تعدیل نشده |\r\n\r\n\r\n-----------------------------------------------------------------\r\n\r\n\r\nبرای مشاهده مثال های بیشتر [اینجا](https://github.com/sm-sokout/tse-option/blob/master/Example/Example.ipynb) کلیک کنید.\r\n\r\n-----------------------------------------------------------------\r\n\r\n\r\nMy Telegram Channel: [@algorithm_edge](https://t.me/algorithm_edge)\r\n\r\n\r\nدر صورت برخورد با هرگونه خطا، ممنون میشم به من اطلاع بدین (sm.sokut@gmail.com)\r\n\r\n\r\nThis project on github [tse-option](https://github.com/sm-sokout/tse-option)\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsm-sokout%2Ftse-option","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsm-sokout%2Ftse-option","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsm-sokout%2Ftse-option/lists"}