# Introduction

betBase is a developer community researching decentralized non-custodial, peer-to-peer and onchain betting / prediction market infrastructure and services.

The community has developed an open and free protocol called betBlox™ and a number of support services allowing anyone to build and run non-custodial onchain betting dapps and services. For details on how to develop with the betBlox™ protocoll see: [\[betblox gitbook\]](https://docs.betblox.xyz)

A virtual peer-to-peer market place called the Open Betting Markets (OBM) built with the betBlox protocol has been deployed.
\
Anyone can become a bettor or a market maker via OBM and anyone can build clients / dapps to interact with the contracts.

To enhance the protocol our community has deployed a number of services like the A.I. Oracle, Sport Events API and development tools.

Explore the Docs to learn all about the betBase ecosystem.


# Onchain Betting Markets (OBM)

Onchain Betting Markets (OBM) is a virtual peer-to-peer market place for betting / prediction markets made with the betBlox protocol. On OBM anyone can become a market maker and create or bet on markets.

Community members have developed a client for exploring and interacting with the Markets. Anyone is free to build their own OBM client.

<figure><img src="/files/KaeX5PWj2NaURdaKfHrM" alt=""><figcaption></figcaption></figure>


# OBM client

The OBM reference client can be accessed through the community maintained site <https://betbase.xyz/>, it is one of many community front ends to come build around the betBlox protocol.&#x20;

Via an OBM client interface users can interact with or create markets on the contract layer. \
Think of an OBM client as a search engine for onchain betting markets, any individual can create their own betting lines with custom odds pricing, win commission fees, rebates and a ton of other stuff in the future. Everything from the event, the settlement to the liquidity lives in smart contracts with audible code, no single entity controls the system in its entirety and everybody has access to the tools and services.&#x20;

The invention of the AMM democratized access for asset to asset market making, OBM democratizes the access for true decentralized and immutable betting and bookmaking.   &#x20;


# Bettors

This page will run through the steps of placing bets in the OBM reference client, note that this interface is just one of many interacting with the betBlox protocol.&#x20;

Connect your web3 wallet or sign in with privy&#x20;

<figure><img src="/files/sr2MY533QLo19KhcPV6Y" alt=""><figcaption></figcaption></figure>

All contracts use USDC as the unit of account. Your connected account, wallet balance and preferred odds format  will show in the top right corner&#x20;

<figure><img src="/files/oNQ81uKnjeA7tIp1h8qs" alt=""><figcaption></figcaption></figure>

In 'Explore Markets' users can navigate what sports they want to browse&#x20;

<figure><img src="/files/NKO4S2AAQcO6HNsq1UzG" alt=""><figcaption></figcaption></figure>

Leagues with live events will have a parentheses () with the number of live events&#x20;

<figure><img src="/files/WztLwTtORIoENbIP6qIT" alt=""><figcaption></figcaption></figure>

If no markets have been created for the events you can create your own (see market maker section for more)

<figure><img src="/files/nQoNvM4uYQBEgIRlCSS3" alt=""><figcaption></figcaption></figure>

When markets have been created users can click 'Bet on markets'&#x20;

<figure><img src="/files/gGsn8VvbTaFkUq2QcXJG" alt=""><figcaption></figcaption></figure>

In the event view bettors can see the active markets and available liquidity. Toggle between 'Money Line', 'Spread' or Total.&#x20;

<figure><img src="/files/V5MjU4BRGzwHUotld8th" alt=""><figcaption></figcaption></figure>

To place a bet, tap the desired odds, put amount and hit Place Bet&#x20;

<figure><img src="/files/eJCzD9Mbl2VK7VEJ6uoK" alt=""><figcaption></figcaption></figure>

After the confirmation ticket with market, event and bet hash, the status of the bet can be found in the Positions tab under 'Active Bets'&#x20;

<figure><img src="/files/aCbSfM1zY2kCNz5yXKvO" alt=""><figcaption></figcaption></figure>

When the event has concluded, users will find the bet either within the 'Settled Bets' tab in case market maker has settled the event or inside 'Unsettled Bets' where the user can hit 'Payout' to settle the event

<figure><img src="/files/1hHvVvTf8jrRLN23e1gh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oIOUVCvcM3mnTWlKz5o4" alt=""><figcaption></figcaption></figure>


# Market Maker

This page will run through the steps of market making in the OBM reference client, note that this interface is just one of many interacting with the betBlox protocol.&#x20;

Connect your web3 wallet or sign in with privy&#x20;

As a market maker you most hold a minimum of 100 $BET, tokens can be obtained on a public AMM like Aerodrome. To proceed, Create MarketMakebox

<figure><img src="/files/NU4ur1QYLC9kP9qrGTvn" alt=""><figcaption></figcaption></figure>

When the market makerbox has been created, go to MM controller in the nav bar and deposit funds

<figure><img src="/files/H4xsrd1JP9CCd3ds1Cuj" alt=""><figcaption></figcaption></figure>

To create markets select event in the Onchain Betting Markets tab, navigate to the league view and create market

<figure><img src="/files/8Dv9mAWXsPNud749uoxQ" alt=""><figcaption></figcaption></figure>

+Add market in the market maker dashboard. Here you can select Market Type, odds, fees, and margin. Market makers can add liquidity on a single line or multiple lines with a spread as well as a win fee collected.&#x20;

<figure><img src="/files/VYYC0hlmnYadCrrASwq5" alt=""><figcaption></figcaption></figure>

When a market is created a markethash and eventhash will be generated

<figure><img src="/files/vuo3HI6Zja5HPutc0dR0" alt=""><figcaption></figcaption></figure>

Odds can dynamically be changed pre match inside the market maker dashboard

<figure><img src="/files/THb3w4F3J3XqutKtpro5" alt=""><figcaption></figcaption></figure>

Live markets can be managed inside MM controller, see active, unsettled and final markets&#x20;

<figure><img src="/files/2kRFTOs40bzIGQZk4Ufl" alt=""><figcaption></figcaption></figure>


# Services

## A.I. Oracle&#x20;

The A.I. Oracle is an experimental Oracle service for delivering Sport events data onchain to be used with the betBlox protocol. State and final results are availabe. The Oracle uses an A.I. engine to understand flow and results of various data sources around a given sport event. The oracle is still highly experimental and no guarantee is given as to the accuracy of the data.

## Events API&#x20;

The Events API is a beBase service delivering event meta data to be used in context with the betBlox protocol and A.I. Oracle. dApps can request data for sport events from a number of endpoints referenced by unique onchain event IDs. See docs for details.


# Contracts

Base Production contracts

CURRENCY\_TOKEN\_ADDRESS=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

$BET=0x80f6bcedd3d4fa1035285affa30e38f464db3895

BET\_BOX\_ADDRESS=0x5CE5378B14bDeB5a559986901A7de02F85cCD956

EVENT\_HANDLER\_ADDRESS=0xd2D1cdD2270f873CB73713F38e868ab99afd87c0

MARKET\_HANDLER\_ADDRESS=0x5663A9eb2Eb97B4342868094D31F92a95E4615b9

BET\_HANDLER\_ADDRESS=0x2c6eA1A6B3111b9813B2b8cF9Ef7596883F58686

PARLAY\_MARKET\_HANDLER\_ADDRESS=0x88C36E545aEDFf4813B1F2Ac3F9E58b5CA98a11f

MARKETMAKER\_FACTORY\_ADDRESS=0x08e894bE0E7BcA90186bf4098757F1b972304C62


# Links

Portal: <https://betbase.xyz/>

OBM Client: <https://app.betbase.xyz/>

Sports Events API: <https://api.betbase.xyz/>

A.I. Oracle: <https://oracle.betbase.xyz/>

Protocol site: <https://betblox.xyz/>

BloxTester tool: <https://tools.betblox.xyz/>


# Sportsbook (Legacy)

The Betbase sportsbook resides entirely on chain in smart contracts deployed on Base and is accessible via any interface and a web3 wallet. \
Each wager comes to life in an entirely decentralized and transparent manner where the individual user place a bet against a another user. Everything from the bet, the liquidity and the fees generated can be audited at all times. \
BetBase takes no custody of user assets nor requires traditional logins with personal information.

Visit: legacy.betbase.xyz

NOTE: There is no company, customer support or any other function or service connected to the protocol. The smart contracts are immutable and reside on a blockchain, no entity can make any changes. &#x20;

\ <br>


# Betting

Disclaimer: This product is in beta, please do not risk more than you can afford to lose

The BetBase protocol offers a permissionless and trustless betting experience without the need for deposits or login details such as e-mail, username or password as all activity is transparently onchain in smart contracts deployed on the Base network.

To interact with the protocol a web3 wallet is needed.

<figure><img src="/files/ssyH5EC9mN8Cdk8DZxVk" alt=""><figcaption></figcaption></figure>

USDC acts as the platforms unit of account and the users' available balance will appear in the top right corner after connecting wallet.&#x20;

Next to the available balance, preferred odds format can be selected.

<figure><img src="/files/IoAsWdhGic2ESXNL1yd2" alt=""><figcaption></figcaption></figure>

To view events and betting markets click on the “Bet” tab and select a sport.

<figure><img src="/files/9c50LjA1QFyRgRRkofHw" alt=""><figcaption></figcaption></figure>

Now select your preferred league or event (live events are showed in brackets).

<figure><img src="/files/ie8MJShdjEDyoafgrH00" alt=""><figcaption></figcaption></figure>

From here select preferred market and odds&#x20;

<figure><img src="/files/F8Od5bVa50sEjpXPzJnp" alt=""><figcaption></figcaption></figure>

Now click on an outcome and odds to place a bet.&#x20;

In this box your available balance and a "MAX BET" option can be found (Max Bet is based on available liquidity and the protocols risk management parameters).&#x20;

<figure><img src="/files/3ARZz1Js205v1ymlpFvm" alt=""><figcaption><p>When hovering over the "fees may apply" caption, current win fee % is shown.</p></figcaption></figure>

After confirming the “Approve spend” and "Place Bet" transactions, a confirmation ticket and the option to share your bet  on X will appear .

<figure><img src="/files/BsiLK8iGTcMGr6GVKB4S" alt=""><figcaption></figcaption></figure>

When a bet is placed go to the “Positions” tab to find all settled and unsettled bets.

<figure><img src="/files/zIQG2pg6brfbwOrIudOE" alt=""><figcaption></figcaption></figure>

The contract will automatically settle your bet and pay out the return minus the win fee.&#x20;

**\*\*BetBase is a permissionless and decentralized platform running immutably onchain in smart contracts. No single entity is able to offer refunds in case of bugs or loss of funds. Please exercise caution\*\***


# Parlay Betting

A parlay in sports betting is when a bettor makes multiple wagers (at least two) and ties them into the same bet. If any bets in the parlay lose, then the entire parlay loses. However, if all wagers win, the bettor gets a bigger payout.

Users can add up to 8 money line, full time result or over/under bets in a single parlay.&#x20;

Note that in the case of a void bet on the parlay, either due to cancelation or if the final score ends at the exact total of the over/under line i.e. final result ends 4-4 and bet placed on the coupon is over 8, the entire parlay coupon will be a wash - regardless of the outcome of other events.&#x20;

To add events for parlay betting, click on desired events and "Add to bet list".

<figure><img src="/files/Br0gt8VAXazpXRP1alav" alt=""><figcaption></figcaption></figure>

After adding events, click on the "Bet" tab to interact with the betlist

<figure><img src="/files/EMUEpOFYgwuxMfLpuIsQ" alt=""><figcaption></figcaption></figure>

In the Bet List, checkmark the desired events for the parlay and click "Build Parlay"

<figure><img src="/files/Ay1Zni1TZKZnIHQzYFac" alt=""><figcaption></figcaption></figure>

Enter amount in the Parlay Bet slip&#x20;

<figure><img src="/files/1w0roYkPI6OV0yfXBVxu" alt=""><figcaption><p>Max bet will vary depending on available liquidity and the protocols risk management system</p></figcaption></figure>

When the parlay is confirmed it will show up in "Positions" under "Parlay Bets" until it is settled.&#x20;

<figure><img src="/files/KfVpltOIc6TxbM7tNXuv" alt=""><figcaption></figcaption></figure>

The contract will automatically settle your bet and pay out the return minus the win fee.&#x20;

**\*\*BetBase is a permissionless and decentralized platform running immutably onchain in smart contracts. No single entity is able to offer refunds in case of bugs or loss of funds. Please exercise caution\*\***


# Liquidity

Disclaimer: This product is in beta, please do not risk more than you can afford to lose

Any participant can provide liquidity to the protocol and will receive BetBase Liquidity Token (BLT) in return. BLT's value will fluctuate depending on the pools performance.

BLT holders provides liquidity for bettors and will make a profit when bettors lose and vice versa.\
\
When buying BLT, one is taking a position against individual bettors. Buying BLT does not offer a risk free return.

BLT can be bought or sold for USDC in the "Financials" tab.

<figure><img src="/files/lxjmGrAXTneC3XyygoRZ" alt=""><figcaption></figcaption></figure>

To trade BLT click “Buy” or “Sell”.

<figure><img src="/files/HTxe2MEOHVV0H59WLTI1" alt=""><figcaption><p>When hovering the "Fees may apply caption" current swap fee can be noted</p></figcaption></figure>

**\*\*BetBase is a permissionless and decentralized platform running immutably onchain in smart contracts. No single entity is able to offer refunds in case of bugs or loss of funds. Please exercise caution\*\***

&#x20;


# Share Cards

Share bets and winnings with your audience directly on X. &#x20;

The "Share" feature can be accessed directly from the betslip after confirmation:

<figure><img src="/files/56v69ZcJfO08d4IbCZxn" alt=""><figcaption></figcaption></figure>

Users can also share their bets or winnings from the "Positions" tab:&#x20;

<figure><img src="/files/VuPL0NWBfcW7ZGWSfi5T" alt=""><figcaption></figcaption></figure>

Copy your card to clipboard and share it in chats, download it or post it directly on X!

Please note that the browser window can block the popup request to share on X.&#x20;

<figure><img src="/files/I5VbxCQsKsRcz6sv8I44" alt=""><figcaption></figcaption></figure>


# Contracts (Legacy)

All live betbase contracts deployed on Base:&#x20;

$BET: 0x80F6BcedD3d4fa1035285affA30e38f464Db3895

Native $USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

BLT (LP token): 0xac79B99eADd86C0F68a912003BCDaB36FE677E22

BetBox: 0xa9E8C2c8F2D4435d231B5C6227685e7174574896

LP\_ADDRESS: 0x5991938F5dE255ac11Fe3Dbe6f1bCc07eD47CEf9

MARKET\_HIST\_ADDRESS=0xd4d9886f09e61490d25c867cb9DA497640B72E4D&#x20;

BET\_HIST\_ADDRESS=0xA953d82192e8eCbd121f5f84Cf95Bd1a6Be9225b

BETBASE\_MAIN: 0x2889B92019b4d64D89273AE1d8C1F4987FB34b45


# Tokenomics

$BET is the ecosystem utility token of the BetBase community and betBlox protocol. With build in deflation. All fees generated via protocol payments for services will be used entirely to burn $BET or buy and burn automatically from the open market.&#x20;

100.000.000 $BET tokens were minted at genesis and at the time of writing a total of 60,915,683 $BET is left after token burns.&#x20;


# Socials

Stay up to date by following our official channels: \
\
X: <https://twitter.com/betbase_xyz>

Betty agent: <https://x.com/0xbasedBetty>\
\
Telegram: <https://t.me/+DlDX23qaPCpjMGU0>\
\
Farcaster: <https://warpcast.com/betbase-xyz>