https://github.com/sm-sokout/tse-option
بررسی و دریافت اطلاعات اختیار معاملات بورس تهران و فرابورس ایران | Options on the Tehran Stock Exchange (TSE) and IranFarabourse (IFB)
https://github.com/sm-sokout/tse-option
black-scholes-merton ifb implied-volatility iran-farabourse option option-pricing pricing tehran-stock-exchange tse
Last synced: 3 months ago
JSON representation
بررسی و دریافت اطلاعات اختیار معاملات بورس تهران و فرابورس ایران | Options on the Tehran Stock Exchange (TSE) and IranFarabourse (IFB)
- Host: GitHub
- URL: https://github.com/sm-sokout/tse-option
- Owner: sm-sokout
- License: mit
- Created: 2022-11-30T08:53:58.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2026-02-13T21:08:30.000Z (4 months ago)
- Last Synced: 2026-02-14T03:57:37.239Z (4 months ago)
- Topics: black-scholes-merton, ifb, implied-volatility, iran-farabourse, option, option-pricing, pricing, tehran-stock-exchange, tse
- Language: Jupyter Notebook
- Homepage:
- Size: 882 KB
- Stars: 26
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tse_option
این پکیج جهت بررسی و دریافت داده های اختیار معاملات بورس اوراق بهادار تهران و فرابورس ایران ایجاد شده است.
برخی از توابع این پروژه،از ماژول های [finpy_tse](https://github.com/ARahimiQuant/finpy-tse) و [tsemodule5](https://github.com/python4financeacademy/tsemodule5) اقتباس شده اند. همچنین باید تشکر کنم از آقای حمید ماهان که برای رفع مشکل دریافت دیتای فرابورس کمک کردند..
- کانال تلگرام: [@algorithm_edge](https://t.me/algorithm_edge)
----------------------------------------------
**توجه****: کلیه خروجی این ماژول از جمله قیمت گذاری و محاسبه تلاطم ضمنی و ... به جهت تسهیل در تصمیم گیری سرمایه گذاران است و هیچگونه پیشنهادی برای خرید یا فروش آن محسوب نمی شود. لذا تمامی عواقب سرمایه گذاری به عهده شخص سرمایه گذار است و توسعه دهنده هیچ مسئولیتی در قبال زیان های احتمالی ندارند.**
----------------------------------------------
**تغییرات نسخه جدید(0.1.1.0)**:
1- امکان دانلود تاریخچه قیمت سهام و اوراق اختیار معامله
2- رفع برخی مشکلات
----------------------------------------------
**تغییرات نسخه جدید(0.1.2.1)**:
1- بروزرسانی لینک های tsetmc
2- امکان دریافت همزمان تاریخچه قیمت چندین نماد(مانند yfinance)
3- بروزرسانی لینک سایت tse.ir
----------------------------------------------
**تغییرات نسخه جدید(0.1.2.3)**:
1- رفع مشکل محاسبه نرخ بهره بدون ریسک (میانگین نرخ اخزا)
2- بهبود کلی و رفع برخی مشکلات
----------------------------------------------
**تغییرات نسخه جدید(0.1.3.0)**:
1- امکان دریافت دیتای پوت آپشن های بورس تهران
2- رفع مشکل دریافت دیتای فرابورس
3- اضافه شدن ستون وجه تضمین
----------------------------------------------
**تغییرات نسخه جدید(0.1.4.0)**:
1- رفع مشکل عدم دریافت دیتای اختیار معاملات
2- دریافت دیتای موقعیت های باز هر اختیار معامله
3- در صورت خطا در محاسبه نرخ بهره، این مقدار بصورت دستی از کاربر گرفته می شود
----------------------------------------------
### بروزرسانی
```python
pip install tse-option --upgrade
```
### نصب
```python
pip install tse-option
```
### فراخوانی
```python
import tse_option as tso
```
-----------------------------------------------------------------
#### زنجیره قراردادهای یک سهم
```python
df = tso.option_chain(symbol="خودرو", trading_days=100, IV=False, leverage=True, P_BSM=False, sort="Maturity")
```
| arguments | توضیحات |
|:------------|:-----------|
| symbol | نماد دارایی پایه |
| trading_days| تعداد روز معاملاتی برای محاسبه تلاطم تاریخی |
| IV | تلاطم ضمنی (Implied Volatility) |
| leverage | محاسبه اهرم |
| P_BSM | نسبت قیمت بازار به BSM |
| sort | نحوه مرتب سازی |
(می توان از متغیرهایی چون زمان باقی مانده تا سررسید(Maturity)،قیمت اعمال(Strike Price) و موقعیت های باز(Open Interests) برای مرتب سازی استفاده کرد)
-----------------------------------------------------------------
#### اختیار خرید
```python
df = tso.call(option_symbol="ضخود1130", trading_days=100, IV=False, leverage=True, P_BSM=False)
```
| arguments | توضیحات |
|:------------|:-----------|
| option_symbol | نماد اختیار خرید |
| trading_days| تعداد روز معاملاتی برای محاسبه تلاطم تاریخی |
| IV | تلاطم ضمنی (Implied Volatility) |
| leverage | محاسبه اهرم |
| P_BSM | نسبت قیمت بازار به BSM |
-----------------------------------------------------------------
#### اختیار فروش
```python
df = tso.put(option_symbol="طخود1138", trading_days=100, IV=False, leverage=True, P_BSM=False)
```
| arguments | توضیحات |
|:------------|:-----------|
| option_symbol | نماد اختیار فروش |
| trading_days| تعداد روز معاملاتی برای محاسبه تلاطم تاریخی |
| IV | تلاطم ضمنی (Implied Volatility) |
| leverage | محاسبه اهرم |
| P_BSM | نسبت قیمت بازار به BSM |
-----------------------------------------------------------------
#### دریافت تاریخچه قیمت
```python
df = tso.download("خودرو", j_date=True, start="1402-01-01", end=None, adjust_price=True, drop_unadjusted=False)
```
```python
df = tso.download(symbols=["خودرو","فولاد","وبملت"], j_date=False, start="2023-01-01", end=None, adjust_price=False, drop_unadjusted=False)
```
| arguments | توضیحات |
|:------------|:-----------|
| symbols | نماد یا نمادها |
| j_date| تاریخ جلالی |
| start | تاریخ شروع |
| end | تاریخ پایان |
| adjust_price | قیمت تعدیل شده |
| drop_unadjusted | حذف قیمت های تعدیل نشده |
-----------------------------------------------------------------
برای مشاهده مثال های بیشتر [اینجا](https://github.com/sm-sokout/tse-option/blob/master/Example/Example.ipynb) کلیک کنید.
-----------------------------------------------------------------
My Telegram Channel: [@algorithm_edge](https://t.me/algorithm_edge)
در صورت برخورد با هرگونه خطا، ممنون میشم به من اطلاع بدین (sm.sokut@gmail.com)
This project on github [tse-option](https://github.com/sm-sokout/tse-option)