توفر حزمة R هذه بعض الوظائف البسيطة لتمكين التفاعل مع خدمة Matchbook.com RESTful API. يرجى قراءة الوثائق بعناية لكل وظيفة على حدة قبل الاستخدام. مطلوب حساب Matchbook.com مسجل لاستخدام هذه الحزمة. يرجى قراءة الوثائق بالكامل قبل الاستخدام.
لتثبيت الحزمة يتطلب مكتبة devtools:
library(devtools)
install_github("xanadunf/matchbook")
تساعد الوظيفتان التاليتان في التحقق من جلسة الحساب
توفر الوظائف التالية القدرة على الحصول على معلومات حول الألعاب الرياضية المتوفرة. يوفر هذا المعرفات التي يستخدمها Matchbook لكل رياضة. باستخدام هذه، يمكنك الحصول على جميع الأحداث الخاصة بالرياضات التي تهتم بها. وبعد ذلك، يمكنك الحصول على معرفات السوق ومعرفات المتسابق لأي قائمة من معرفات الأحداث. راجع وثائق R لمزيد من التفاصيل حول هذا.
يمكن استخدام الوظيفة التالية للحصول على تفاصيل أي رهانات تم وضعها ولكن لم تتم تسويتها بعد. يمكن الحصول على تفاصيل الرهانات غير المتطابقة والمتطابقة. راجع وثائق R لمزيد من التفاصيل (على سبيل المثال؟ mb_get_bets)
توفر الوظائف التالية وظيفة الرهان الأساسية.
من أجل الحصول على تفاصيل حول الرهانات التي تم تسويتها يمكن استخدام الوظيفة التالية. مرة أخرى، يمكن رؤية معلمات الوظيفة الكاملة في وثائق R (؟mb_get_settled)
من المفترض أن يساعدك هذا على البدء والتشغيل في وقت قصير جدًا، على افتراض أنك قد استوفيت المتطلبات المسبقة. دعونا نحدد هدفًا في هذا البرنامج التعليمي لوضع رهان على أول مباراة كرة قدم نجدها تحتوي على اسم "رجل". سنشرع في وضع رهان خلفي بقيمة 5 يورو (أو أيًا كانت عملة حسابك) على الفريق المضيف للفوز بالمباراة بشكل مباشر بمعامل 1.10.
للبدء، تحتاج إلى تسجيل الدخول باستخدام بيانات اعتماد حساب Matchbook.com الخاص بك.
library(devtools)
install_github("xanadunf/matchbook")
library(matchbook)
username <- "my_user_name" ### replace with your username
password <- "verysafepassword" ### replace with your password
session_details <- mb_login(username,password)
وبما أننا نراهن على كرة القدم، فنحن بحاجة إلى معرفة هوية تلك الرياضة.
sport_id_data <- mb_get_sports(session_details)
sport_id_data
football_sport_id <- sport_id_data$id[which(sport_id_data$name=="Soccer")]
football_sport_id
ومن النتائج يمكننا أن نرى أن كرة القدم لها معرف رياضي = 15. يمكننا استخدام هذا للحصول على أي أحداث كرة قدم مع فريق يحتوي على سلسلة "الرجل".
event_data <- mb_get_events(session_data=session_details,sport_ids=football_sport_id)
event_data[grep(tolower("man"), tolower(event_data$name)),]
test_event_id <- event_data$id[grep(tolower("man"), tolower(event_data$name))[1]]
test_event_id
من الواضح، اعتمادًا على وقت تشغيل هذا، قد يكون لديك نتائج كثيرة أو معدومة. إذا لم تجد نتيجة ناجحة، فاستبدل كلمة "man" باسم فريق كرة القدم الذي تعرف أنه سيلعب قريبًا. لذلك دعونا نحصل على كافة بيانات السوق لهذا الحدث. وبما أننا نريد المراهنة على نتيجة المباراة، سنحاول استخلاص نوع السوق "الفائز الفردي".
market_data <- mb_get_markets(session_data=session_details,event_id=test_event_id,include_runners=TRUE)
market_data
test_market_id <- market_data$id[market_data$'market-type'=="one_x_two"]
test_market_id
الآن بعد أن أصبح لدينا السوق الصحيح، فلنحصل على معلومات لجميع المتسابقين في هذا السوق. هذه المرة، قمنا بتضمين المعلمة "include_prices=TRUE" حتى نتمكن من معرفة السعر الذي يتوفر به كل متسابق. أيضًا، يتيح لك تحديد العداء من البيانات الناتجة.
runner_data <- mb_get_runners(session_data=session_details,event_id=test_event_id,market_id=test_market_id,include_prices=TRUE)
runner_data
test_runner_id <- runner_data$id[grep("man", runner_data$name,ignore.case=TRUE)]
test_runner_id
الآن لدينا تفاصيل عن جميع المتسابقين، فلنحصل على تفاصيل حول أسعار المتسابق الذي اخترناه.
prices_data <- runner_data$prices[[which(runner_data$id==test_runner_id)]]
prices_data_back <- prices_data[prices_data$side=="back",]
best_available_current_price <- min(prices_data_back$'decimal-odds') # min because we are backing, use the max if you are laying.
الآن بعد أن وجدنا مستويات الأسعار التي يمكننا العودة إليها (الحجم متاح أيضًا عبر 'prices_data_back$'available-amount'') يمكننا المراهنة على المتسابق الذي اخترناه.
mb_bet_place(session_data=session_details,runner_id=test_runner_id,side='back',stake=5,odds=1.10)
mb_get_bets(session_data=session_details)
عندما يتم وضع الرهان، من المهم فحص حالة الرهان. إذا كانت الحالة "متطابقة"، فهذا يعني أنك قد تمت مطابقتك بالسعر المقدم. إذا كان "مفتوحًا"، فهذا يعني أن الرهان لم يتم مطابقته بالكامل. لمزيد من التفاصيل حول الرهانات الموضوعة، راجع الوثائق: ?mb_bet_place
mb_get_bets(session_data=my_session,runner_id=test_runner_id)
هذه الحزمة قيد التطوير النشط وردود الفعل والتحسينات المقترحة هي موضع ترحيب.
الرجاء إنشاء مشكلة باستخدام منطقة المشكلات.
يتم توفير البرنامج "كما هو"، دون أي ضمان من أي نوع، صريحًا أو ضمنيًا، بما في ذلك، على سبيل المثال لا الحصر، ضمانات القابلية للتسويق والملاءمة لغرض معين وعدم الانتهاك. لا يتحمل المؤلفون أو أصحاب حقوق الطبع والنشر بأي حال من الأحوال المسؤولية عن أي مطالبة أو أضرار أو مسؤولية أخرى، سواء في إجراء العقد أو الضرر أو غير ذلك، الناشئة عن أو خارج أو فيما يتعلق بالبرنامج أو الاستخدام أو المعاملات الأخرى في برمجة.