Bet-brew NPM | npm.io

Bet-Brew

Bet-Brew is an npm package that provides a suite of utilities designed to aid bettors in various betting and trading strategies.

Installation

npm install bet-brew

Usage

Import the main class and use its methods. Below are example usages for a few methods:

import { betBrew } from 'bet-brew';

const brew = betBrew();

// Example usage of calculateEV
const evResult = brew.calculateEV({
    stakedAmount: 100,
    oddsTaken: 2.0,
    startingPrice: 1.9,
});

console.log('Expected Value:', evResult);

// Example usage of calculateROI
const roiResult = brew.calculateROI({
    stakedAmount: 100,
    oddsTaken: 2.0,
    startingPrice: 1.9,
});

console.log('Return on Investment:', roiResult);

// Example usage of calculateBookmakerMargin
const marginResult = brew.calculateBookmakerMargin({
    allOdds: [1.9, 2.1, 3.0],
});

console.log('Bookmaker Margin:', marginResult);

// Example usage of calculateAdjustedProbability
const adjustedProbResult = brew.calculateAdjustedProbability({
    startingPrice: 1.9,
    allOdds: [1.9, 2.1, 3.0],
});

console.log('Adjusted Probability:', adjustedProbResult);

// Example usage of calculateAdjustedEV
const adjustedEVResult = brew.calculateAdjustedEV({
    stakedAmount: 100,
    oddsTaken: 2.0,
    startingPrice: 1.9,
    allOdds: [1.9, 2.1, 3.0],
});

console.log('Adjusted Expected Value:', adjustedEVResult);

// Example usage of calculateAdjustedROI
const adjustedROIResult = brew.calculateAdjustedROI({
    stakedAmount: 100,
    oddsTaken: 2.0,
    startingPrice: 1.9,
    allOdds: [1.9, 2.1, 3.0],
});

console.log('Adjusted Return on Investment:', adjustedROIResult);

API Documentation

`BetBrewClass`

Core class containing methods for various betting utilities.

Methods

calculateEV(input: EVInput): Calculates the Expected Value (EV) of a bet.
calculateROI(input: ROIInput): Calculates the Return on Investment (ROI) of a bet.
calculateBookmakerMargin(input: BookmakerMarginInput): Calculates the margin of a bookmaker based on provided odds.
calculateAdjustedProbability(input: AdjustedProbabilityInput): Calculates the adjusted probability accounting for the bookmaker's margin.
calculateAdjustedEV(input: AdjustedEVInput): Calculates the adjusted Expected Value (EV) of a bet.
calculateAdjustedROI(input: AdjustedROIInput): Calculates the adjusted Return on Investment (ROI) of a bet.
calculatePnL(input: PnlInput): Calculates profit and total return of a bet.
calculateKellyBet(input: KellyBetInput): Calculates the optimal bet amount using the Kelly criterion, returns the suggested bet amount and the Kelly fraction.
decimalToFractional(decimalOdds: number): Converts decimal odds to fractional format.
fractionalToDecimal(fraction: string): Converts fractional odds to decimal format.
decimalToMoneyline(decimalOdds: number): Converts decimal odds to moneyline format.
moneylineToDecimal(moneyline: number): Converts moneyline odds to decimal format.

Input Types

`EVInput`

Used for calculating the Expected Value (EV) of a bet.

stakedAmount: The amount of money staked on the bet. (Type: number)
oddsTaken: The odds that were taken when the bet was placed. (Type: number)
startingPrice: The starting price or odds of the bet. (Type: number)

`ROIInput`

Used for calculating the Return on Investment (ROI) of a bet. Extends from EVInput.

`BookmakerMarginInput`

Used for calculating the margin of a bookmaker based on provided odds.

allOdds: An array of all odds that are being considered. (Type: number[])

`AdjustedProbabilityInput`

Used for calculating the adjusted probability, accounting for the bookmaker's margin.

startingPrice: The starting price or odds of the bet. (Type: number)
allOdds: An array of all odds that are being considered. (Type: number[])

`AdjustedEVInput`

Used for calculating the adjusted Expected Value (EV) of a bet.

Inherits fields from both EVInput and BookmakerMarginInput.

`AdjustedROIInput`

Used for calculating the adjusted Return on Investment (ROI) of a bet.

Inherits all fields from AdjustedEVInput.

`PnlInput`

Used for calculating the profit and total return of a bet.

oddsTaken: The odds that were taken when the bet was placed. (Type: number)
stakedAmount: The amount of money staked on the bet. (Type: number)

`KellyBetInput`

Used for calculating the profit and total return of a bet.

oddsTaken: The odds that were taken when the bet was placed. (Type: number)
bankroll: The total amount of money available for betting. (Type: number)
probability: The bettor's estimated probability that the bet will win, expressed as a value between 0 and 1. (Type: number)

BrewResult

Interface outlining the results of calculations:

margin: Bookmaker's margin in percentage. (Type: number)
rawEV: Raw Expected Value of a bet. (Type: number)
rawROI: Raw Return on Investment of a bet in percentage. (Type: number)
adjustedEV: Adjusted Expected Value of a bet. (Type: number)
adjustedROI: Adjusted Return on Investment of a bet in percentage. (Type: number)