investpy
v1.0.8
إذا كنت ترغب في دعم المشروع ، فيمكنك شراء القهوة للمطور. مزيد من المعلومات في: buy-me-a-coffee
للحصول على هذه الحزمة ، ستحتاج إلى تثبيتها عبر PIP (مع إصدار Python 3.6 أو أعلى) على المحطة عن طريق الكتابة:
$ pip install investpy
بالإضافة إلى ذلك ، إذا كنت ترغب في استخدام أحدث إصدار من InvestPy بدلاً من الإصدار المستقر ، فيمكنك تثبيته من المصدر مع الأمر التالي:
$ pip install git+https://github.com/alvarobartt/investpy.git@master
يضمن الفرع الرئيسي للمستخدم أن يكون الإصدار الأكثر تحديثًا يعمل دائمًا وعمليات التشغيل بالكامل حتى لا ينتظر حتى يخرج الإصدار المستقر (والذي قد يستغرق في النهاية بعض الوقت اعتمادًا على عدد المشكلات التي يجب حلها).
على الرغم من أن بعض أمثلة استخدام الاستثمار يتم تقديمها على المستندات ، إلا أنه سيتم حل بعض الوظائف الأساسية باستخدام كتل رمز Python. بالإضافة إلى ذلك ، يمكن العثور على المزيد من أمثلة الاستخدام تحت أمثلة/ دليل ، والذي يحتوي على مجموعة من أجهزة الكمبيوتر المحمولة Jupyter حول كيفية استخدام InvestPy والتعامل مع بياناتها.
؟ لاحظ أن investpy.search_quotes هي الوظيفة الوحيدة التي تضمن تحديث البيانات وتوافقها 1: 1 مع البيانات المقدمة من قبل Investing.com!
يسمح InvestPy للمستخدم بتنزيل كل من البيانات الحديثة والتاريخية من أي منتج مالي مفهرس (الأسهم ، الأموال ، صناديق الاستثمار المتداولة ، الصلبان ، الشهادات ، السندات ، السلع ، المؤشرات ، والتشفير). في المثال الواردة أدناه ، يتم استرداد البيانات التاريخية من السنوات الماضية من الأسهم.
import investpy
df = investpy . get_stock_historical_data ( stock = 'AAPL' ,
country = 'United States' ,
from_date = '01/01/2010' ,
to_date = '01/01/2020' )
print ( df . head ()) Open High Low Close Volume Currency
Date
2010-01-04 30.49 30.64 30.34 30.57 123432176 USD
2010-01-05 30.66 30.80 30.46 30.63 150476160 USD
2010-01-06 30.63 30.75 30.11 30.14 138039728 USD
2010-01-07 30.25 30.29 29.86 30.08 119282440 USD
2010-01-08 30.04 30.29 29.87 30.28 111969192 USD
للتعرف على جميع وظائف استخراج البيانات الحديثة والتاريخية المتاحة التي توفرها InvestPy ، وأيضًا ضبط المعلمات ، يرجى قراءة المستندات.
تم دمج محرك بحث Investing.com تمامًا مع InvestPy ، مما يعني أنه يمكن بسهولة العثور على أي منتج مالي متاح (اقتباس). تتيح وظيفة البحث للمستخدم ضبط المعلمات لضبط نتائج البحث على احتياجاتهم ، حيث يمكن تحديد كل من أنواع المنتجات والبلدان من حيث المنتجات. يمكن استخدام جميع وظائف البحث بسهولة ، على سبيل المثال ، كما هو موضح في الجزء التالي من الكود:
import investpy
search_result = investpy . search_quotes ( text = 'apple' , products = [ 'stocks' ],
countries = [ 'united states' ], n_results = 1 )
print ( search_result ){ "id_" : 6408 , "name" : " Apple Inc " , "symbol" : " AAPL " , "country" : " united states " , "tag" : " /equities/apple-computer-inc " , "pair_type" : " stocks " , "exchange" : " NASDAQ " } ستكون نتائج البحث التي تم استرجاعها list بـ investpy.utils.search_obj.SearchObj مثيلات فئة ، ما لم يتم تعيين n_results على 1 ، عندما يتم إرجاع مثيل فئة investpy.utils.search_obj.SearchObj . للتعرف على الوظائف والسمات المتاحة لنتائج البحث التي تم إرجاعها ، يرجى قراءة الوثائق ذات الصلة في وثائق محرك البحث. لذلك ، تتيح نتائج البحث هذه أن يسترجع المستخدمين على حد سواء للبيانات الحديثة والتاريخية ، ومعلوماته ، والمؤشرات الفنية ، والعملة الافتراضية ، وما إلى ذلك ، كما هو موضح في الكود أدناه:
recent_data = search_result . retrieve_recent_data ()
historical_data = search_result . retrieve_historical_data ( from_date = '01/01/2019' , to_date = '01/01/2020' )
information = search_result . retrieve_information ()
default_currency = search_result . retrieve_currency ()
technical_indicators = search_result . retrieve_technical_indicators ( interval = 'daily' )تم تضمين دعم Cryptocurrencies مؤخرًا ، للسماح للمستخدم باسترداد البيانات والمعلومات من أي تشفير متاح في Investing.com. يرجى ملاحظة أن بعض العملات المشفرة لا تحتوي على بيانات متوفرة مفهرسة على موقع Investing.com بحيث لا يمكن استردادها باستخدام InvestPy أيضًا ، على الرغم من أنها مجرد عدد قليل ، فكر فيها.
كما سبق تقديمه سابقًا ، فإن استرجاع البيانات التاريخي باستخدام InvestPy سهل حقًا . يوضح قطعة الكود الواردة أدناه كيفية استرداد السنوات الماضية من البيانات التاريخية من Bitcoin (BTC).
import investpy
data = investpy . get_crypto_historical_data ( crypto = 'bitcoin' ,
from_date = '01/01/2014' ,
to_date = '01/01/2019' )
print ( data . head ()) Open High Low Close Volume Currency
Date
2014-01-01 805.9 829.9 771.0 815.9 10757 USD
2014-01-02 815.9 886.2 810.5 856.9 12812 USD
2014-01-03 856.9 888.2 839.4 884.3 9709 USD
2014-01-04 884.3 932.2 848.3 924.7 14239 USD
2014-01-05 924.7 1029.9 911.4 1014.7 21374 USD
يمكنك العثور على وثائق InvestPy الكاملة في الوثائق.
نظرًا لأن هذا مشروع مفتوح المصدر ، فهو مفتوح للمساهمات وتقارير الأخطاء وإصلاحات الأخطاء وتحسين الوثائق والتحسينات والأفكار . هناك علامة تبويب مفتوحة للمشكلات حيث يمكن لأي شخص فتح مشكلات جديدة إذا لزم الأمر أو التنقل من خلالها لحلها أو المساهمة في حلها. تذكر أن المشكلات ليست مؤشرات ترابط لوصف مشاكل متعددة ، وهذا لا يعني أنه لا يمكن مناقشة المشكلات ، ولكن حتى الحفاظ على إدارة المشاريع منظمة ، يجب ألا تصف نفس المشكلة مشكلات مختلفة ، فقط الأخطاء المتداخلة/ذات الصلة التي يمكن العثور عليها.
أصدرت Github مؤخرًا ميزة جديدة تدعى GitHub مناقشات (لا تزال في بيتا). مناقشات GitHub هي منتدى اتصال تعاوني للمجتمع حول مشروع مفتوح المصدر.
تحقق من صفحة مناقشات Investpy Github في المناقشات ، ولا تتردد في سؤالني (أي مطور) أي شيء ، ومشاركة التحديثات ، ومحادثات مفتوحة ، ومتابعة القرارات التي تؤثر على طريقة العمل في المجتمع.
؟ ملحوظة . عادة لا أجيب على رسائل البريد الإلكتروني التي أطرحني على أسئلة حول InvestPy ، حيث لدينا حاليًا علامة التبويب GitHub مناقشات ، وأشجعك على استخدامها. مناقشات GitHub هي أسهل طريقة للاتصال بي حول InvestPy ، حتى لا أجيب على نفس الأشياء أكثر من مرة عبر البريد الإلكتروني ، حيث يمكن لأي شخص رؤية المناقشات المفتوحة/الإجابة.
نظرًا لأن InvestPy يهدف إلى استرداد البيانات من منتجات مالية مختلفة كما هو موضح في Investing.com ، يتم تقديم تطوير بعض وحدات الدعم التي تنفذ وظيفة إضافية تعتمد على بيانات InvestPy . لاحظ أنه يمكن لأي شخص المساهمة في هذا القسم من خلال إنشاء أي حزمة أو وحدة أو أداة تستخدم InvestPy. لذلك ، سيتم تقديم تلك التي تم إنشاؤها بالفعل ، حيث يتم استخدامها إلى استخدامها مع InvestPy:
إذا طورت مشروعًا مثيرًا للاهتمام/مفيدًا يعتمد على بيانات InvestPy ، فيرجى فتح مشكلة لإعلامها بتضمينه في هذا القسم.
عند ذكر هذا المستودع في منشوراتك العلمية ، يرجى استخدام اقتباس bibtex التالي:
@misc { investpy ,
author = { Alvaro Bartolome del Canto } ,
title = { investpy - Financial Data Extraction from Investing.com with Python } ,
year = { 2018-2021 } ,
publisher = { GitHub } ,
journal = { GitHub Repository } ,
howpublished = { url{https://github.com/alvarobartt/investpy} } ,
}عند ذكر هذا المستودع على أي وسائل التواصل الاجتماعي الأخرى ، يرجى استخدام الاقتباس التالي:
investpy - Financial Data Extraction from Investing.com with Python developed by Alvaro Bartolome del Canto
يجب أن تذكر أيضًا المصدر من حيث يتم استرداد البيانات ، investing.com ؛ على الرغم من أنه تم تضمينه بالفعل في عنوان الوصف القصير الحزمة.
يمكنك الاتصال بي في أي من ملفات تعريف الشبكة الاجتماعية الخاصة بي:
أو عبر البريد الإلكتروني على [email protected].
تم تقديم حزمة Python هذه لأغراض بحثية لتناسب الاحتياجات التي لا يغطيها Investing.com ، لذلك تعمل هذه الحزمة مثل واجهة برمجة التطبيقات (API) من Investing.com تم تطويرها بطريقة إيثار .
استنتج أن InvestPy لا يتم تمييزه بأي طريقة إلى Investing.com أو أي شركة تابعة ، فإن الشرط الوحيد المحدد من قبل Investing.com لتطوير هذه الحزمة هو "ذكر المصدر الذي يتم فيه استرداد البيانات من".
