LiqOdds Docs

Everything you need to play, provide liquidity, or bring your community to LiqOdds.

Introduction

LiqOdds turns any token into a game. Each token has one liquidity pool. Holders deposit the token to provide liquidity, and players bet with the same token against that pool.

The official site and every Pro Alliance partner site play against the same pool for a given token. More sites means more activity for that token's pool.

Getting started

Sign in

• Solana wallet: Phantom, Solflare or OKX Wallet.
• BNB Chain wallet: MetaMask, OKX Wallet, TokenPocket, Coinbase Wallet, or any wallet through WalletConnect.
• Email and password, with an optional referral code at sign-up.

Signing in with a wallet only asks you to sign a message. It sends no transaction and costs no gas.

Try it first

Guest mode lets you play every game with PLAY, a demo token. PLAY has no value and cannot be withdrawn.

Deposits & withdrawals

Deposits

• Your account gets its own deposit address on each supported network.
• Deposits are credited after network confirmation: 15 blocks on BSC and 32 confirmations on Solana. Small deposits may be credited earlier, and become withdrawable once fully confirmed.
• Minimum deposit: 1 USDT or the equivalent shown in the app.

Withdrawals

• Withdrawals require Google Authenticator (2FA). If you signed in with a wallet and withdraw to that same wallet address, you can confirm by signing with the wallet instead.
• A new withdrawal address can be used 24 hours after you add it. Your sign-in wallet address can be used right away.
• For your protection, withdrawals pause for 24 hours after a password change, and for 48 hours after you turn off 2FA or change your email.
• Larger withdrawals may go through a manual review before they are sent.

Games

All games are played against the token's liquidity pool. A 1% fee is taken from every stake, and the rest plays against the pool. Winnings are paid instantly to your balance in the same token you bet.

Crash

1. Each round opens with a 4.5-second betting window. You can place one bet per round.
2. The multiplier starts at 1.00× and rises until it crashes at a random point.
3. Cash out before the crash to win your stake (after the fee) × the multiplier. If you don't cash out in time, the stake is lost.
4. Set an auto cash-out target and the server cashes out for you, even if you disconnect.

• Built-in edge: 1%.
• Maximum win: 10×. A cash-out above 10× is paid at 10×.
• If total payouts in a round reach 20% of the pool, all remaining bets are settled at the current multiplier and the round ends.

Mine

1. Pick a risk tier: 1, 2, 3 or 4 bomb digits. Each packet has a 10%, 20%, 30% or 40% chance to be a bomb.
2. Start the round. Your stake is taken, and the bomb digits and the total prize are revealed.
3. Open the 9 red packets one by one. A packet whose amount ends in a bomb digit ends the round. Open all 9 safely to win the full prize.
4. You have 30 seconds. When time runs out, the remaining packets are opened in order until the first bomb.

There is no cash-out once a round starts. You can have up to 3 rounds open at a time. The maximum stake depends on the pool size; a tier the pool can't cover is shown as unavailable.

Trading

Predict whether a volatility index will finish above or below a target line.

1. Choose an index, Up or Down, a payout tier and your stake. Rounds last 15 seconds.
2. The target line and multiplier are set when you place the bet.
3. At expiry, Up wins if the index is above the line, and Down wins if it is below. Only the price at expiry counts.
4. If the index finishes exactly on the line, the bet is refunded in full.

DiceBETA

Pick a number and bet whether the roll lands under or over it. Every bet settles instantly.

1. Choose a number n from 2 to 98.
2. Choose Under (you win if the roll is less than n) or Over (you win if the roll is greater than n).
3. Enter your stake and roll. The result is a whole number from 1 to 100 and is settled at once.
4. If the roll equals n, the bet loses.

• Chance to win: Under = (n − 1)%, Over = (100 − n)%.
• Payout: stake × multiplier. The multiplier already includes the 1% bet fee and a 0.5% built-in edge, so the return to player is about 98.5% on every choice.

• Limits: the minimum bet is about $0.10 in the token you bet. The maximum depends on the pool and on the multiplier you choose: the higher the multiplier, the smaller the maximum. When many large bets land at once, or after a run of big wins, the limit is lowered for a short time and then recovers on its own. The app always shows your current maximum.
• You can place up to 120 bets per minute.

Fairness

LiqOdds uses a commit-reveal system, so a result can't be changed after you bet:

1. Before you bet, the server publishes the SHA-256 hash of a secret server seed.
2. The result is derived from HMAC-SHA256(server seed, client seed + round data).
3. After the round, the server seed is revealed. You can check it against the published hash and recompute the result.

• Mine: you can set your own client seed (it applies after you reload the game). Each settled round can be verified from your game records.
• Trading: seeds are committed for every 10-minute segment. Each bet can be replayed and checked from your bet history.
• Dice: each player has a seed pair and a counter (nonce) that goes up by one with every bet. Rotate your seed pair in the verify panel to reveal the old server seed, then check every bet made with it.

Liquidity providers

How it works

• Deposit a token into its pool and receive pool shares.
• The pool is the counterparty to every bet on that token, in every game, on every LiqOdds site.
• Your share value updates in real time as bets settle.

Where earnings come from

• The games' built-in edge on stakes after the fee: Crash 1%, Mine 2%, Trading 3–5% by tier, Dice 0.5%.
• Half of the entry fees paid by new LPs.
• The 1% bet fee does not go to the pool.

Key terms

Risk controls

• Maximum bet: 0.5% of the pool. Maximum profit per bet: 3% of the available pool.
• Crash pays out at most 20% of the pool per round.
• If the pool loses more than 15% in 30 minutes, new bets pause automatically.
• Every game's limits are measured against the same available balance, so no game can spend funds reserved for another.

Fees & referrals

Bet fee

• 1% of every stake, win or lose. Some Trading indexes may use a different fee, shown before you bet.
• Voided Trading bets are refunded in full, with no fee.
• The fee is shared in this order: direct referrer, indirect referrer, the partner site, then the platform. The rates are set for each site.

Referrals

• Share your invite link: liqodds.com/?ref=YOURCODE.
• Two levels: you earn from the bet fees of people you invite (direct) and the people they invite (indirect). Your current rates are shown on your referral page.
• A referral link is bound at sign-up, or once later if you have no referrer yet. Once bound, it can't be changed.
• Rewards are credited automatically every day by about 01:00 (UTC+7), in the same token as the bets. There is nothing to claim and no minimum.
• Bets made with PLAY don't earn referral rewards.

Vesting plan

The vesting plan lets you put an extra amount aside with each bet and receive the site's vesting token gradually over time.

The vesting token is a listed project token chosen by each site.

How it works

1. Turn on the vesting switch in Crash, Mine or Trading.
2. With every bet, an extra participation amount equal to 20% of the bet (in USDT value) is taken from your USDT balance. You need enough USDT for it.
3. You immediately get locked credit worth 5× the participation amount, counted in US dollars.
4. Every day after 09:00 Beijing time (UTC+8), part of your locked credit unlocks and becomes claimable.
5. You claim when you choose. Claimable credit is converted into the vesting token at the current price and paid to your balance.

Example: a 100 USDT bet with the plan on costs 20 USDT more and gives 100 credit (USD value).

How fast credit unlocks

Each day, 0.05% of the credit that is still locked unlocks. Because the amount still locked keeps shrinking, unlocking slows down over time and takes many years.

In this example, after one year you have unlocked about 16.7 in credit for 20 USDT paid. What that credit is worth in tokens depends on the token price when you claim.

Claiming

• A claim always takes all your claimable credit at once, converted at the current price.
• A deduction applies to each claim, based on how long it has been since you first joined the plan:

• The deducted tokens go to the platform's burn account. The rest is credited to your balance and can be withdrawn like any other token.
• If the price moves by more than 1% between the preview and your confirmation, the claim is stopped so you can check the new quote.

Where the tokens come from

• Participation amounts go into a USDT pool. Each day about 1.5% of that pool is used to buy the vesting token into a token pool.
• Claims are paid from that token pool. It is shared by every LiqOdds site that uses the same vesting token, and it does not use the liquidity pools of the games.
• If the token pool doesn't have enough tokens, your claim is refused and you can try again later. There is no queue; claims are paid in the order they arrive.

Who can join

• Available only on sites that have chosen a vesting token, and only with Crash, Mine and Trading. Dice and the guest PLAY token are not included.
• Frozen, closed and self-paused accounts can't join or claim. Unlocking catches up when the account is active again.

Partner programs

There are three ways to work with LiqOdds. Pick the one that matches how much you want to run yourself.

Official listing

Get your token a liquidity pool on LiqOdds, so holders can provide liquidity and players can play with your token on every LiqOdds site.

• Free. Every application is reviewed.
• Supported networks: BSC and Solana. The token needs a reliable price feed.
• Solana Token-2022 tokens with extensions such as transfer hooks, permanent delegate or non-transferable are not accepted.
• Games open once the pool reaches the value of 10,000 USDT. Pools are funded by LP deposits only; LiqOdds does not seed pools.

1. Submit the listing form.
2. We review the token and contact you from @LiqOdds on Telegram.
3. Once listed, the pool opens for LP deposits.
4. Rally your holders to provide liquidity. Games open when the pool reaches 10,000 USDT.

Pro Alliance

Pro Alliance lets you run a game site under your own brand, for free. Your site runs on the LiqOdds platform and plays against the same liquidity pools as every other LiqOdds site, so you get deep pools from day one without raising any liquidity yourself.

Who it's for

• Token projects that want a game for their community.
• KOLs and community owners who want to offer games to their audience.
• Large holders who want to grow activity around a token.

What you get

• Your own brand: site name, logo, browser tab icon, splash screen and theme colour.
• Your own domain: point your domain to LiqOdds and HTTPS is set up automatically.
• Your choice of tokens and games: open any listed tokens and any of the live games on your site. You don't need a token of your own.
• Shared pools: bets on your site play against the same pool as every LiqOdds site for that token, so bet limits are set by the full pool, not just your community.
• Your own players: accounts on your site belong to your site. Referral links work within your site.
• Your own support links: your Telegram and X links are shown on your site.
• Partner dashboard: see your users, turnover and earnings, with separate roles for admin, finance, risk and audit.

How you earn

Every bet pays a 1% fee. On your site, the fee is shared in this order:

1. the player's direct referrer;
2. the player's indirect referrer;
3. you, the site owner, from what is left after referral rewards;
4. the platform keeps the rest.

Your share and your site's referral rates are agreed when you join. Earnings are settled daily and paid after review.

Community bot

• Big-win posts: when a player on your site wins 1.5× or more, the bot posts it to your Telegram groups, with the game, multiplier, profit and a link back to your site. Player IDs are masked.
• Daily report: every day at 00:00 Beijing time (UTC+8), your group gets yesterday's summary: deposits and withdrawals, users, turnover by game, and fees. It only shows your site's data.
• Your own bot (optional): connect your own Telegram bot so the mini app opens on your domain.

How to join

1. Submit the Pro Alliance form.
2. We contact you from @LiqOdds on Telegram to confirm the details.
3. Send us your site name, logo, colours, the tokens and games you want, and your Telegram and X links.
4. We set up your site. Point your domain to us and it goes live with HTTPS.
5. Add the bot to your groups and share your site with your community.

Partner guidelines

• Players on your site use LiqOdds under the Terms of Service.
• Don't promise returns or profits to players or LPs, and always mention that playing and providing liquidity carry risk.
• Don't make statements on behalf of LiqOdds. For anything about the platform, point people to these docs.
• Our only official DM account is @LiqOdds. Tell your community never to share seed phrases or 2FA codes.

White label

White label is for teams that want to run their own gaming platform, with their own brand, funds and operations, built on LiqOdds technology.

How it differs from Pro Alliance

• Private deployment: your platform runs as its own deployment, not as a site on the shared LiqOdds platform.
• Separate funds: your liquidity pools and ledger are your own and completely separate from LiqOdds. Your pools do not take bets from LiqOdds sites, and LiqOdds pools do not take bets from yours.
• You operate it: you set your own tokens, games and parameters, and run your own community and support.

What's included

• Your own domain and community notification bot.
• The LiqOdds games and liquidity pool system.
• Optional deep UI customization and value-added services.

Pricing

A one-time setup fee, a monthly fee, and a share of GGR (gross gaming revenue). Pricing depends on scope and is agreed per project.

How it works

1. Contact @LiqOdds on Telegram.
2. We discuss your needs: brand, tokens, games, markets and customization.
3. You receive a proposal and quote.
4. After the agreement is signed, we deploy and configure your platform.
5. You launch under your own brand.

White label deployments are governed by a separate agreement.

Account safety

• Custody: LiqOdds is custodial. Deposits go to addresses the platform creates for your account, and balances and LP shares are kept in the platform's ledger.
• 2FA: turn on Google Authenticator to withdraw. Too many wrong codes lock 2FA for 15 minutes.
• Address whitelist: up to 20 saved withdrawal addresses. Adding one needs 2FA and an email code.
• Limits: set daily bet and loss limits. Tighter limits apply at once; looser limits wait 24 hours.
• Take a break: pause your account for 1, 7 or 30 days. A pause can't be lifted early.