Housebets
Feature SpecOCB-01

On-Chain Bonus

A direct-to-user acquisition system that replaces ad-platform spend by analysing a user's on-chain history and offering them a personalised deposit bonus of up to $25,000.

Max Bonus

$25,000

Turnover

Categories

4

Total Levels

70

What is the On-Chain Bonus?

The On-Chain Bonus is a personalised acquisition mechanic that reads a user's wallet history to determine their "degen score" — a measure of their on-chain activity across crypto casinos, prediction markets, perps trading, and DEX usage. Based on this score, the user is offered a tiered deposit bonus. The system is designed to target KOLs and high-value crypto-native users who would otherwise be unreachable via traditional ad spend.

Key Differentiator

No wallet connection is required at the scan stage. The system reads public on-chain data from the address alone. Ownership is only proven at the deposit step, keeping friction minimal at the top of the funnel.

OCB-02

9-Step User Flow

The complete end-to-end journey from wallet scan to bonus grant.

#Step
1
Wallet Scan
2
Score Check
3
Bonus Offer
4
Test Deposit
5
Send from Wallet
6
Bonus Granted
7
Turnover Applied
8
X Bot Card
9
VIP Entry
OCB-03

Scoring System

The user's bonus is determined by their highest level across all four categories. Exchange wallets are excluded.

Crypto Casino

25 levels

Deposits to competitor casinos — Stake, Rollbit, Shuffle, and others. The most granular tier system with 25 levels.

StakeRollbitShuffleBC.Game

Polymarket

15 levels

Prediction market activity on Polymarket. Measures volume and frequency of on-chain prediction market participation.

Polymarket

Perps Trading

15 levels

Perpetual futures trading volume across major on-chain perps platforms.

GMXdYdXHyperliquid

DEX Usage

15 levels

Decentralised exchange activity — swap volume and frequency across major DEXes.

UniswapCurve1inch
Category Summary
CategoryLevelsWhat is Measured
Crypto Casino25Deposits to competitor casinos — Stake, Rollbit, Shuffle, and others. The most granular tier system with 25 levels.
Polymarket15Prediction market activity on Polymarket. Measures volume and frequency of on-chain prediction market participation.
Perps Trading15Perpetual futures trading volume across major on-chain perps platforms.
DEX Usage15Decentralised exchange activity — swap volume and frequency across major DEXes.

Scoring rule: The user qualifies for the bonus corresponding to their highest achieved level across all categories — not an average.

OCB-04

API Response Fields

Full response schema for GET /api/housebets/[walletAddress]. All 12 fields are returned on every successful 200 response.

API Response Schema12 fields
walletAddress
stringWALLET

The queried wallet address, returned as-is from the request.

Example:"0xAbc123..."
tier
numberTIER

Trader activity tier from 1 to 25. Higher values indicate a more active on-chain trader. Drives the bonus amount offered.

Example:8
topSectorByTier
stringTOP SECTOR

The sector in which the wallet achieved its highest tier. One of: "gambling", "perpetuals", "dex", or "prediction".

Example:"perpetuals"
topProtocolUsed
stringTOP PROTOCOL

The specific protocol with the highest volume within the top sector (e.g. Hyperliquid for perps, Stake for gambling).

Example:"hyperliquid"
gamblingScore
numberGAMBLING SCORE

Percentile score (0–100) for on-chain gambling activity. Measures deposits to competitor casinos such as Stake, Rollbit, and Shuffle.

Example:0
perpsScore
numberPERPS SCORE

Percentile score (0–100) for perpetual futures trading volume across on-chain perps platforms including Hyperliquid, GMX, and dYdX.

Example:72.4
dexScore
numberDEX SCORE

Percentile score (0–100) for decentralised exchange activity — swap volume and frequency across Uniswap, Curve, 1inch, and others.

Example:12.1
polymarketScore
numberPOLY SCORE

Percentile score (0–100) for prediction market activity on Polymarket. Measures volume and frequency of on-chain prediction market participation.

Example:0
profitableOnPolymarket
booleanPOLY PNL

Whether the wallet has net positive Polymarket PnL. Only meaningful when polymarketScore > 0.

Example:false
totalGamblingDepositVolume
numberGAMBLING VOL

Lifetime gambling deposit volume in USD across all tracked competitor casinos.

Example:0
totalPerpsDexPolymarketVolume
numberTRADING VOL

Combined lifetime volume in USD across perps, DEX, and prediction markets. Includes live Hyperliquid volume.

Example:185000
claimed
booleanCLAIMED

Whether this wallet has already claimed their Housebets reward. Use the PUT /claim endpoint to mark a wallet as claimed.

Example:false

Scores are percentiles (0–100): Each score reflects the wallet's position relative to all wallets in the dataset — not an absolute volume figure. A score of 72.4 means the wallet is in the 72nd percentile for that category.

Claim flow: The claimed field starts as false. After the user claims their reward, call PUT /api/housebets/claim/[wallet] to flip it to true. The wallet must be fetched via GET first.

Error Codes
400Invalid wallet address
403CEX hot wallet — individual tracking not supported
404Wallet not found in dataset
404PUT: Wallet must be fetched via GET first
OCB-05

Reward Framework

Full tier tables for all four scoring categories. Sourced directly from the Housebets Reward Framework spreadsheet (v1.3, March 2026).

Casino On-Chain — deposits to competitor gambling sites (Stake, Rollbit, Shuffle, BC.Game). 25 levels. Crown → VIP Flow triggered.
LvlPlayersTotal DepositedEst. ValueAff BountyProof Dep.RewardBoostTOTotal + BoostKeysBadge
1
98,146$25$10.00$1.00$10$5100%$10.00501 of 98,146
2
163,816$50$20.00$2.00$10$10100%$20.001001 of 163,816
3
230,742$100$40.00$2.40$10$12100%$24.001201 of 230,742
4
147,423$250$99.75$2.80$10$14100%$28.001401 of 147,423
5
7,062$500$199.00$3.00$10$15100%$30.001501 of 7,062
6
45,160$750$297.00$4.00$10$20100%$40.002001 of 45,160
7
39,106$1,500$589.50$10.00$10$50100%$100.005001 of 39,106
8
48,643$2,500$970.00$12.00$10$6050%$90.006001 of 48,643
9
22,245$5,000$1,880.00$14.00$10$7050%$105.007001 of 22,245
10
20,640$7,500$2,737.50$16.00$10$8050%$120.008001 of 20,640
11
31,387$10,000$3,550.00$20.00$10$10050%$150.001,0001 of 31,387
12
15,567$15,000$5,025.00$25.00$10$12550%$187.501,2501 of 15,567
13
3,071$50,000$12,100.00$30.00$10$15050%$225.001,5001 of 3,071
14
7,271$100,000$18,400.00$40.00$10$20050%$300.002,0001 of 7,271
15
3,771$500,000$75,000.00$200.00$10$1,00040%$1,400.0010,0001 of 3,771
16
1,612$1,000,000$150,000.00$300.00$10$1,50010%$1,650.0015,0001 of 1,612
17
799$2,500,000$375,000.00$400.00$10$2,00010%$2,200.0020,0001 of 799
18
393$5,000,000$750,000.00$600.00$10$3,00010%$3,300.0030,0001 of 393
19
99$7,500,000$1,125,000.00$800.00$10$4,00010%$4,400.0040,0001 of 99
20
43$10,000,000$1,500,000.00$1,000.00$10$5,00010%$5,500.0050,0001 of 43
21
43$75,000,000$11,250,000.00$1,200.00$10$6,00010%$6,600.0060,0001 of 43
22
13$10,000,000$1,500,000.00$1,400.00$10$7,00010%$7,700.0070,0001 of 13
23
19$25,000,000$3,750,000.00$1,600.00$10$8,00010%$8,800.0080,0001 of 19
24
4$50,000,000$7,500,000.00$1,800.00$10$9,00010%$9,900.0090,0001 of 4
25
3$100,000,000$15,000,000.00$4,550.00$10$22,75010%$25,025.00227,5001 of 3
887,078 total wallets across 25 levelsTotal rewards: $70,161 · With boost: $77,905
TOOL

Wallet Checker

Look up any EVM or Tron wallet to see its tier, scores, and claim status. API calls are proxied server-side.

Paste wallet address (EVM 0x… or Tron T…)

Housebets
On-Chain Bonus v1.0
Housebets © 2024