گرفتن داده از وبسایت‌هایِ tsetmc, tgju, rahavard365 برای تحلیل بازارِ بورسِ ایران.


License
MIT
Install
pip install oxtapus==0.2.6

Documentation

metafid

oxtapus

PyPI - Python Version PyPI - Version PyPI - Downloads GitHub

اُختاپوس برایِ پوششِ بخشی از داده‌هایِ موردِ نیاز در مدل-سازی‌هایِ مالی-اقتصادی توسعه داده شده است. برایِ یاد-گیریِ بیشتر، راهنمایِ بهره-گیران رو بخونید.
حمایت از من لینک
دارمت یه ☕🧸🍪 مهمونم کن

|

install

mac , linux

python3 -m pip install oxtapus

windows

python -m pip install oxtapus

TSETMC (tsetmc.com)

تقریبن همه‌یِ داده‌هایِ وب-سایتِ tsetmc.com رو پوشش می‌ده.

نمونه (برای راهنمایِ کامل راهنمایِ بهره-گیران رو بخونید) :
>>> from oxtapus import TSETMC

>>> tsetmc = TSETMC()
>>> tsetmc.intraday_trades("دکپسول")
shape: (190, 4)
┌─────────────────────┬───────────┬─────────┬────────┐
│ datetimetrade_nbrpricevolume │
│ ------------    │
│ datetime[μs]        ┆ i64f64i64    │
╞═════════════════════╪═══════════╪═════════╪════════╡
│ 2023-11-01 09:10:01175100.0250    │
│ 2023-11-01 09:10:05275100.0625    │
│ 2023-11-01 09:10:05375100.048     │
│ 2023-11-01 09:11:57475150.0100    │
│ …                   ┆ …         ┆ …       ┆ …      │
│ 2023-11-01 12:28:4718777000.0510    │
│ 2023-11-01 12:28:4718877000.089     │
│ 2023-11-01 12:29:0618977000.0411    │
│ 2023-11-01 12:29:0619077000.0500    │
└─────────────────────┴───────────┴─────────┴────────┘
لیستِ داده‌هایِ قابلِ دریافت:
  • دیدبانِ بازار(mw): با واردکردنِ بازار(هایِ) موردِ نیاز آخرین داده‌یِ صفحه‌یِ ِدیدبانِ بازار رو به همراهِ 5 سفارشِ برتر بهت می‌ده.
  • دیدبانِ بازارِ اخیتارِ-معامله(option-mw): آخرین داده‌یِ صفحه‌یِ ِدیدبانِ بازار رو به همراهِ 5 سفارشِ برتر، داده‌هایِ داراییِ پایه، قیمتِ اعمال، تاریخِ اعمال، و روز تا سر-رسید بهت می‌ده.
  • داده‌هایِ نماد/ابزار (ins-info): داده‌هایِ پایه‌یِ نماد رو بهت می‌ده.
  • داده‌هایِ خاصِ اختیارِ-معامله (specific-option-data): داده‌هایی که خاصِ نماد‌هایِ اختیارِ-معامله‌ان، مانندِِ موقعیت‌هایِ بازِ و برخی داده‌هایِ دیگه رو بهت می‌ده.
  • تاریخچه‌یِ معامله‌یِ نماد (hist-price): داده‌هایِ مربوط به معامله‌یِ گذشته‌یِ نماد رو بهت میده.
  • تاریخچه‌یِ معامله‌یِ نماد (adj-hist-price): داده‌هایِ مربوط به معامله‌یِ گذشته‌یِ نماد رو به صورتِ تعدیلی و غیرِ-تعدیلی بهت میده.
  • داده‌هایِ درون-روزیِ معامله (intraday-trades): داده‌هایِ مربوط به ریزِ معامله‌یِ آخرین روزِ معامله رو بهت می‌ده.
  • داده‌هایِ درون-روزیِ معامله بر مبنایِ فاصله‌یِ زمانی (intraday-trades-based-on-timeframe): داده‌هایِ مربوط به ریزِ معامله‌یِ آخرین روزِ معامله رو بر مبنایِ تایم-فریمِ وارده شده بهت می‌ده.
  • آخرین داده‌یِ نماد (last-ins-data): برخی از داده‌هایِ صفحه‌یِ اصلیِ نماد- مانندِ وضعیتِ نماد و ... - رو بهت می‌ده.
  • حقیقی-حقوقی (client-type): داده‌هایِ گذشته‌یِ مربوط به معامله‌هایِ حقیقی-حقوقی رو بهت می‌ده.
  • تغییرِ سرمایه (share-change): داده‌هایِ مربوط به تغییرِ سرمایه‌یِ نماد رو بهت می‌ده.
  • شاخص‌ها (indexes): لیستِ همه‌یِ شاخص‌ها و مقدار و تغییرِ مربوط به آخرین روزِ معاملاتی رو بهت می‌ده.
  • نماد‌هایی که شاخص دنبال‌ می‌کنه (symbols-that-index-tracks): نمادهایی که هر شاخص دنبال می‌کنه رو بهت می‌ده.
  • تاریخچه‌یِ شاخص (index-hist): داده‌هایِ مربوط به مقدارِ شاخص‌ها رو بهت می‌ده.
  • تاریخ و زمانِ رو بر مبنایِ آخرین رویدادِ بازار (last-market-activity-datetime): تاریخ و زمانِ رو بر مبنایِ آخرین رویدادِ بازار رو بهت می‌ده.
  • داده‌هایِ مربوط به سهامدارهایِ درصدی (shareholder_list): داده‌هایِ مربوط به سهامدارهایِ عمده رو استخراج و پالایش می‌کنه.
  • تعدیلِ قیمت (adjust_price_flow): قیمتِ تعدیلی و قبلِ تعدیل نمادهایی که قیمتشون تعدیل شده رو بهت می‌ده.
  • افزایشِ سرمایه (ins_share_change_flow): افزایش/تغییرِ سرمایه‌یِ همه‌یِ شرکت‌ها رو بهت می‌ده.
  • لیستِ داده‌هایی در آینده می‌تونی دریافت کنی:
  • داده‌هایِ گذشته‌یِ معامله‌هایِ درون-روزی.
  • داده‌هایِ گذشته‌یِ سفارش‌ها-5 مظنه-
  • TGJU (tgju.org)

    داده‌هایِ طلا و دلارِ وب-سایتِ tsetmc.com رو پوشش می‌ده. و در آینده کالاهایی که به بورسِ ایران مربوطه و از آنجا قابلِ دریافته رو پوشش خواهد داد.

    نمونه (برای راهنمایِ کامل راهنمایِ بهره-گیران رو بخونید) :
    >>> from oxtapus import TGJU
    
    >>> tgju = TGJU()
    >>> tgju.usd_irr()
    shape: (3_688, 6)
    ┌────────────┬────────────┬──────────┬──────────┬──────────┬──────────┐
    │ datejdateopenhighlowclose    │
    │ ------------------      │
    │ datestrf64f64f64f64      │
    ╞════════════╪════════════╪══════════╪══════════╪══════════╪══════════╡
    │ 2023-11-011402-08-10514870.0517900.0513380.0516830.0 │
    │ 2023-10-311402-08-09516770.0518060.0515370.0516600.0 │
    │ 2023-10-301402-08-08511950.0514600.0510650.0514500.0 │
    │ 2023-10-291402-08-07519550.0519560.0513350.0513560.0 │
    │ …          ┆ …          ┆ …        ┆ …        ┆ …        ┆ …        │
    │ 2011-11-291390-09-0813400.013400.013400.013400.0  │
    │ 2011-11-281390-09-0713350.013350.013350.013350.0  │
    │ 2011-11-271390-09-0613440.013440.013440.013440.0  │
    │ 2011-11-261390-09-0513700.013700.013700.013700.0  │
    └────────────┴────────────┴──────────┴──────────┴──────────┴──────────┘
    لیستِ داده‌هایِ قابلِ دریافت:
  • دلار/ریال (usd/irr)
  • سکه‌یِ امامی (sekke-emami)
  • نیم-سکه (nim-sekke)
  • ربعِ-سکه (rob-sekke)
  • اونسِ طلا (ons)
  • Rahavard365 (rahavard365.com)

    فعلن داده‌هایِ صورت‌هایِ مالی رو پوشش می‌ده.

    نمونه (برای راهنمایِ کامل راهنمایِ بهره-گیران رو بخونید) :
    >>> from oxtapus import Rahavard
    >>> rah = Rahavard()
    >>> bsh = rah.balance_sheet("آسیا")
    >>> bsh.data
    shape: (5, 48)
    ┌───────────┬───────────┬───────────┬───────────┬───┬───────────┬───────────┬───────────┬──────────┐
    │ datefiscal_ye12         ┆ … ┆ 12081025       │
    │ ---ar------       ┆   ┆ ------------      │
    │ date---f64f64       ┆   ┆ f64f64f64f64      │
    │           ┆ date      ┆           ┆           ┆   ┆           ┆           ┆           ┆          │
    ╞═══════════╪═══════════╪═══════════╪═══════════╪═══╪═══════════╪═══════════╪═══════════╪══════════╡
    │ 2023-07-12023-03-21.6475e129.4735e13 ┆ … ┆ 0.00.00.00.0      │
    │ 70         ┆           ┆           ┆   ┆           ┆           ┆           ┆          │
    │ 2022-07-12022-03-29.7369e116.8886e13 ┆ … ┆ 1.3831e130.00.00.0      │
    │ 30         ┆           ┆           ┆   ┆           ┆           ┆           ┆          │
    │ 2021-07-02021-03-11.4242e125.8496e13 ┆ … ┆ 0.00.00.00.0      │
    │ 59         ┆           ┆           ┆   ┆           ┆           ┆           ┆          │
    │ 2020-07-12020-03-17.1692e110.0       ┆ … ┆ 0.09.7560e113.2546e130.0      │
    │ 89         ┆           ┆           ┆   ┆           ┆           ┆           ┆          │
    │ 2019-07-12019-03-26.4080e111.0119e13 ┆ … ┆ 0.00.09.8519e121.5801e1 │
    │ 60         ┆           ┆           ┆   ┆           ┆           ┆           ┆ 2        │
    └───────────┴───────────┴───────────┴───────────┴───┴───────────┴───────────┴───────────┴──────────┘
    
    >>> bsh.base_info
    BaseInfo(announcement_type='1', financial_view_type='3')
    
    >>> bsh.field_info
    shape: (46, 10)
    ┌─────┬─────────────┬─────────────┬────────────┬───┬────────────┬──────────┬──────────┬────────────┐
    │ idtitleenglish_titaccount    ┆ … ┆ index_viewsign_negsign_posneg_nature │
    │ ------le---        ┆   ┆ ------------        │
    │ strstr---str        ┆   ┆ i64boolboolbool       │
    │     ┆             ┆ str         ┆            ┆   ┆            ┆          ┆          ┆            │
    ╞═════╪═════════════╪═════════════╪════════════╪═══╪════════════╪══════════╪══════════╪════════════╡
    │ 120تسهیلاتLoanCurrentLia ┆ … ┆ 4000falsefalsefalse      │
    │     ┆ مالیPayablesbilities:L ┆   ┆            ┆          ┆          ┆            │
    │     ┆ دریافتی     ┆             ┆ oanPayable ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆             ┆ s          ┆   ┆            ┆          ┆          ┆            │
    │ 89سایر ذخائرOtherCurrentLia ┆ … ┆ 3800falsefalsefalse      │
    │     ┆ فنیTechnicalbilities:O ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆ ReservestherTechni ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆             ┆ ca…        ┆   ┆            ┆          ┆          ┆            │
    │ 17سایرOtherNonCurrent ┆ … ┆ 2200falsefalsefalse      │
    │     ┆ داراییهاAssetsAssets:Oth ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆             ┆ erAssets   ┆   ┆            ┆          ┆          ┆            │
    │ 18اموال ماشینEquipmentNonCurrent ┆ … ┆ 2300falsefalsefalse      │
    │     ┆ آلات و      ┆             ┆ Assets:Fix ┆   ┆            ┆          ┆          ┆            │
    │     ┆ تجهیزات     ┆             ┆ edAssets:E ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆             ┆ qu…        ┆   ┆            ┆          ┆          ┆            │
    │ 78مطالبات ازReceivablesCurrentAss ┆ … ┆ 300falsefalsefalse      │
    │     ┆ بیمهگذارانfromets:Receiv ┆   ┆            ┆          ┆          ┆            │
    │     ┆ و نمایندگ…  ┆ Insured andablesfromI ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆ Rep…        ┆ ns…        ┆   ┆            ┆          ┆          ┆            │
    │ …   ┆ …           ┆ …           ┆ …          ┆ … ┆ …          ┆ …        ┆ …        ┆ …          │
    │ 35سرمایهCommonEquity:Com ┆ … ┆ 4900falsefalsefalse      │
    │     ┆             ┆ StockmonStock   ┆   ┆            ┆          ┆          ┆            │
    │ 46جمع کلTotalLiabilitie ┆ … ┆ 6500falsefalsefalse      │
    │     ┆ بدهیها وLiabilitiessAndEquity ┆   ┆            ┆          ┆          ┆            │
    │     ┆ حقوق صاحبانand Equity  ┆            ┆   ┆            ┆          ┆          ┆            │
    │     ┆ سها…        ┆             ┆            ┆   ┆            ┆          ┆          ┆            │
    │ 33ذخیرهPensionNonCurrent ┆ … ┆ 4500falsefalsefalse      │
    │     ┆ مزایایReservesLiabilitie ┆   ┆            ┆          ┆          ┆            │
    │     ┆ پایان خدمت  ┆             ┆ s:PensionR ┆   ┆            ┆          ┆          ┆            │
    │     ┆ کارکنان     ┆             ┆ es…        ┆   ┆            ┆          ┆          ┆            │
    │ 84بدهی بهReinsuranceCurrentLia ┆ … ┆ 2700falsefalsefalse      │
    │     ┆ بیمهگذارانIssuersbilities:R ┆   ┆            ┆          ┆          ┆            │
    │     ┆ اتکاییPayableseinsurance ┆   ┆            ┆          ┆          ┆            │
    │     ┆             ┆             ┆ Is…        ┆   ┆            ┆          ┆          ┆            │
    │ 9جمعTotalCurrentAss ┆ … ┆ 1400falsefalsefalse      │
    │     ┆ داراییهایCurrentets        ┆   ┆            ┆          ┆          ┆            │
    │     ┆ جاریAsset       ┆            ┆   ┆            ┆          ┆          ┆            │
    └─────┴─────────────┴─────────────┴────────────┴───┴────────────┴──────────┴──────────┴────────────┘