Docs

Carrot codex

Chapter

Roadmap

A milestone line showing what is shipped, what is live now, and what is planned next.

1Done

Achieved

Core game

Wallet sign-in, bunny breeds, classes, energy, steal and regen upgrades, quests, referrals, parties, party chat, leaderboards, Carrot Farm, staking, crates, gear, salvage, Discord verification, X identity, and the upgraded lucky-carrot Plinko system are already shipped.

2Live

Live

Abstract migration

The Abstract migration is live now. The public docs, creator pages, join flows, and migration messaging stay reachable while the main game waits for the May 30, 2026 at 00:00 CET countdown to finish.

3Scheduled

Next

Launch

Launch goes live when the under-construction countdown ends on May 30, 2026 at 00:00 CET. This replaces the previous launch milestone: everyone gets the same reopening time on Abstract.

4Scheduled

Next

Presale + LP

The presale is scheduled for May 30 to June 27, 2026, or until sold out. It has a 100 ETH hard cap and 35,000,000 CARROT allocation at 1 ETH for 350,000 CARROT. If the soft cap is reached, unsold presale CARROT is intended to be burned after close. After the set end time or sellout, the $CARROT LP pool is created so trading can start, presale buyers can move into the token phase, and the claim/trading loop can connect back into the game economy.

5Planned

Future

PVP

PVP is planned as both carrot-stealing battle events and an opt-in gameplay mode players can turn on or off. The goal is wallet-vs-wallet combat first, then Party PVP, cross-party payout events, seasonal leaderboard resets, party-driven progression, and late-game loops that give coordinated players stronger reasons to compete.

6Exploring

Later season

Bunny Racing

Bunny Racing is planned for a later season after PVP. It is a separate competitive mode where race outcomes can lean on your bunny breed and class, creating another path for high-level players beyond carrot stealing, farming, and party coordination.

Chapter

Brand kit

Download Bunny Button logos, button sprites, social artwork, and meme assets.

Logos and social art

Use the logo, avatar, favicon, and meta card for announcements, listings, videos, thumbnails, and social posts that point back to Bunny Button.

Button sprites

The button files include idle, blink, hit, transparent, dark-background, and animated variants so creators can place the bunny cleanly on light or dark compositions.

Memes

Meme images are included as ready-to-post square PNGs. New community-safe memes can be added here as the asset folder grows.

Usage note

Do not use the files to impersonate official Bunny Button accounts, mislead users, or present unofficial contracts, links, presales, or claims as official.

Brand assets

51 files

Pick a category, then choose an asset below to preview and download.

WAGMI
MemesPNG

WAGMI

Bunny holding a gold coin as candles climb.

1254 x 1254

Download

Chapter

Creator Program

Creator rewards for streamers, clippers, and Bunny Button content makers.

Who it is for

The Creator Program page is for streamers, clippers, video creators, short-form editors, post makers, and community members who create useful Bunny Button content.

How to submit

Connect and sign in with your wallet, link X and Discord, choose a content type, add the content URL, and include notes that help the team understand the context.

Review flow

Submissions are queued for rabbit agent review. Automation can help organize and score work, but the team manually confirms the final reward decision before anything is granted.

Reward types

Approved creators can receive carrot crates, carrot tokens credited to their in-game balance, or unique creator-only items. Rewards are not fixed and depend on the submitted content.

Ready to submit content?

Open the Creator Program page to connect your wallet, link X and Discord, submit content URLs, and track review status.

Open Creator Program

Chapter

Carrot tokenomics

100M fixed supply, where real money enters, how carrots become CARROT, and how value moves through the loop.

Liquidity17.5%
Presale35%
Play-to-Earn25%
Referral & Growth12.5%
Treasury5%
Team5%
Liquidity

17,500,000

Presale

35,000,000

Play-to-Earn

25,000,000

Referral & Growth

12,500,000

Treasury

5,000,000

Team

5,000,000

Fixed supply

CARROT has a max supply of 100,000,000 tokens with 18 decimals. The entire supply is minted once at deployment and there is no emissions schedule, no inflation, and no mint function for new tokens after launch. Every allocation below is carved out of that single fixed 100M pool, so the only ways the circulating amount changes over time are unlocks from vesting and burns from in-game sinks.

What each allocation does

The 100M supply splits into six buckets, each with a specific job. Presale (35,000,000 / 35%) is sold for ETH and USDT to raise launch capital. Play-to-Earn (25,000,000 / 25%) is the on-chain backing for everything players earn in-game and later claim. Liquidity (17,500,000 / 17.5%) is paired with ETH in the launch pool so the token can actually trade. Referral & Growth (12,500,000 / 12.5%) funds referral payouts and the Creator Program. Treasury (5,000,000 / 5%) covers development and operations, and Team (5,000,000 / 5%) is the builder allocation. Liquidity, Treasury, and Team are the locked or reserved allocations flagged with a lock icon in the chart: they are held in contracts or the LP, not sitting spendable in a wallet.

Presale and LP

Presale hard cap is 100 ETH, backed by a 35,000,000 CARROT presale allocation at the unchanged presale rate of 1 ETH for 350,000 CARROT. Initial liquidity uses 45 ETH paired with 11,250,000 CARROT, setting the unchanged 250,000 CARROT per ETH listing rate. The remaining 6,250,000 liquidity tokens are intended for a public lock/reserve before future LP additions. If the soft cap is reached, unsold presale CARROT left after the presale closes is intended to be burned; if the soft cap is not reached, the refund path takes priority.

Revenue model

The project takes in real value through three on-chain payment flows, all settled in ETH or USDT on Abstract: the CARROT presale (one-time, capped at 100 ETH), Carrot Crate purchases (ongoing, roughly $10 per crate from the Shop and Gacha), and paid breed and breed/class change unlocks. Presale proceeds are routed to a dedicated funds receiver; the 45 ETH liquidity target is paired with CARROT to seed the trading pool and the remainder, together with the treasury allocation, funds development, marketing, and operations. Crate and breed payments are the recurring revenue line after launch. None of these inflows are profit-sharing: they fund the game and its liquidity, not distributions to holders.

Off-chain carrots vs on-chain CARROT

The carrots you earn by pressing the button are an off-chain balance tracked in the database and minted only by the server. Clicking never touches the chain and costs no gas. On-chain CARROT is the ERC-20 token. The bridge between them is the Claim Vault: when you claim, the server signs an EIP-712 voucher for your cumulative eligible balance and the vault releases the difference between that figure and what you have already claimed. The vault can only pay out CARROT that has been funded into it from the 25,000,000 Play-to-Earn allocation, so the total that can ever move on-chain through rewards is bounded by that bucket, not by how many off-chain carrots happen to exist in the game at any moment.

How value flows through the loop

The economy is a closed loop and the docs do not pretend otherwise. Real ETH and USDT enter through the presale, crates, and breeds. Part of that becomes locked liquidity (the only place on-chain CARROT can be bought or sold), and part funds the treasury and team over their vesting schedules. Players earn off-chain carrots by playing, spend most of them back into sinks (stat upgrades, Farm levels, breed/class rituals, crates) that burn supply, and can claim a portion on-chain against the Play-to-Earn allocation. Demand for CARROT comes from new buyers entering and from sinks tightening the circulating supply; there is no external yield source feeding the system. Whether early value holds depends entirely on continued participation and pool liquidity, the same dynamic the game names openly in its terms.

Why earlier positions are worth more

The presale is priced below the launch rate by design: presale buyers receive 350,000 CARROT per ETH, while the listing rate is 250,000 CARROT per ETH. Contribution tiers then stack an extra bonus on the base presale allocation: the Silver tier (from 0.5 ETH) adds +10% and the Gold tier (from 2 ETH) adds +20%, with a Rainbow tier at the 5 ETH per-wallet maximum. On top of price, referrers earn 8% of their referees' clicker carrots, up to a +3% bonus tier scaled by their own presale contribution, capped at 500 carrots per day per referrer. So earlier and larger positions get both a lower entry price and stronger ongoing referral economics. This is the structural reason early participation is worth more, not a promise of profit.

Team vesting

The 5,000,000 CARROT team allocation is not intended to sit unlocked in a team wallet. It is held by a vesting contract, split into 16 equal parts, and released in monthly batches over 4 months.

Treasury vesting

The 5,000,000 CARROT treasury allocation is held by a separate vesting contract. It unlocks in 2 equal batches: 2,500,000 CARROT after 45 days and 2,500,000 CARROT after 90 days.

Sinks and burns

Stat upgrades, Carrot Farm levels, Breed/Class change rituals, and Carrot Crate purchases all burn carrots. Burned amounts feed the Burnt Offerings quest line and reduce the active circulating off-chain supply. Because supply is fixed and never re-minted, every burn is permanent downward pressure on the amount in play, which is the only built-in counterweight to new carrots entering through gameplay.

Chapter

Game systems

Bunny Button, upgrades, parties, farm, staking, gacha, gear, referrals, withdrawals, Discord, and chat.

Play

Press the Bunny Button to steal carrots, spend energy, build progress, and climb the leaderboard with the wallet that owns the player record.

Energy

Every press costs 1 energy. Energy regenerates over time toward your breed's pool cap. Run out and you wait for regen or buy upgrades. There is no separate daily limit, so deeper pools and faster regen translate directly into more daily carrots.

Upgrades

The Shop sells stat upgrades for energy max, regen rate, and steal multiplier. Costs scale per level. Upgrades burn carrots, which counts toward burn quests.

Carrot Farm

The Farm produces carrots per second once you buy the first level, even while you are offline. Offline accrual is capped at 8 hours, so logging in at least once every 8 hours captures the full yield.

Staking

Lock-stake your idle carrots for 30, 90, or 365 days to earn additional CARROT. Longer locks pay higher APY. Yield accrues per second and is paid out at unlock; emergency exits forfeit yield.

Gacha and Gear

Spend ~$10 in carrots or USDT/ETH on a Carrot Crate to roll a Cape, Boots, or Hat. Equip the result in the Gear page to add steal, regen, or max-energy bonuses on top of your breed and class stats. See the Carrot crate pool chapter for the full item list.

Party

Parties group up to fifteen wallets. The party bonus to gross carrots per press ramps up as the party fills — from about +0.4% with two members to the full +5% only at a complete fifteen-bunny party (roughly +0.36% per extra member). A 20% party tax is split evenly among the other members. Party access unlocks after the Goblin Diplomacy quest.

Referrals and X

Bind a referral code to support another player and unlock referral quests. Referrers earn 8% of your clicker carrots (up to +3% bonus tier based on their presale contribution), capped at 500 carrots/day per referrer. Connecting X swaps your shortened wallet for handle and avatar across the leaderboard and party UI.

Discord and chat

Link your Discord account from the Wallet menu to claim your username in-game, sync your leaderboard placement, and unlock Discord-side commands. Global chat is open to any signed-in wallet; party chat is private to your fifteen.

Withdraw and presale

Earned carrots accrue as a claimable off-chain balance. Once on-chain claim opens, the connected wallet pulls them through the withdraw flow via signed vouchers. The presale page handles the ETH-to-CARROT entry path plus Silver, Golden, and Rainbow Carrot tiers.

Chapter

Breeds

Permanent base stats for your bunny: energy pool, regen rate, and steal multiplier.

What a breed does

A breed sets your three base stats: max energy, energy regen per hour, and steal multiplier. The breed is locked to the wallet on first selection.

Starter breeds

Sprout is the free starter breed. Meadow, Burrow, Bandit, and Spark are paid starter breeds that cost $15 in ETH or USDT. Meadow is the balanced all-rounder. Burrow trades regen speed and steal power for a deeper energy pool. Bandit pairs a small 500 pool and slow 24h refill with a punchy 1.8x steal, perfect for one big daily burst. Spark is a lean pool with fast regen tuned for short, frequent sessions.

Quest-locked breeds

Moonburrow unlocks after the Wizards Hate This Bunny quest and pushes steal to 1.25x with a generous energy pool. Jackalope unlocks after The Carrot Cartel and pairs balanced energy with a 1.5x steal.

Changing breeds

After your first lock, switching breeds requires a paid Breed Change in the Shop (2,500 carrots). It re-opens the breed picker without resetting your wallet progress.

Chapter

Classes

One bonus stat layered on top of your breed: Mage, Warrior, Knight, or Shaman.

What a class does

A class adds a single bonus stat on top of your breed. You pick a class together with your bunny type during onboarding.

Mage

Arcane recovery. Boosts energy regen by 15% so your pool refills faster between sessions. Best paired with breeds that already have decent steal.

Warrior

Raw force. Boosts steal multiplier by 15% so every press pays more. Strong on Bandit for burst scaling and useful on Burrow if you want to offset its lower base steal.

Knight

Iron endurance. Increases max energy by 15% so you can press longer before regen catches up. Best on breeds with already deep pools like Burrow or Moonburrow.

Shaman

Carrot reader. Triggers lucky-carrot Plinko hits 1.4× more often. Base lucky hits are 0.582% per press; Shaman pushes that to about 0.815%. Net carrots per click sit slightly above the other classes, with the extra value coming from variance rather than steady output.

Changing classes

Class is locked to your wallet on first selection. A paid Class Change in the Shop starts at 2,500 carrots and scales with player progress, then re-opens the picker without resetting other progress.

Chapter

Lucky carrots

Every accepted press can hit a lucky-carrot variety; that variety becomes a Plinko ball count with multiplier bins at the bottom.

How rolls work

Every accepted click rolls once on the lucky-carrot table. Most presses miss and pay the normal yield. When a lucky carrot hits, the game first reveals which variety you found, then opens Plinko for that variety. Multiple lucky hits in one click batch stack server-side, while the UI highlights the highest variety as the main Plinko reveal.

Lucky-carrot varieties

Special, Rare, Epic, Mythic, and Legendary lucky carrots each map to a fixed Plinko ball count: Special = 10 balls, Rare = 25 balls, Epic = 50 balls, Mythic = 100 balls, and Legendary = 200 balls. Higher varieties are rarer and create longer, higher-variance Plinko cascades.

Multiplier board

The Plinko board has nine bottom bins labelled x10 / x5 / x2 / x1 / x0.5 / x1 / x2 / x5 / x10. Each ball lands in one bin, and that bin's multiplier decides the payout for that ball. Edge bins pay the most but are hardest to hit; center bins are more common and lower value.

Payout flow

The revealed variety controls how many balls drop, then each ball samples the multiplier board. The final lucky-carrot bonus is the sum of all ball outcomes, computed server-side and credited to your stash after the Plinko animation finishes.

Carrots flow to the stash

Each ball can show a small payout pop as it lands. After the last ball settles, the combined bonus flies from the Plinko slot to the carrot stash counter; the counter pulses and ticks up when the bonus arrives. The stash holds the bonus back during the reveal so the visible count stays consistent with the animation.

Stacks with everything

Final Plinko bonus carrots are added before party tax and referral share, so a Legendary cascade on a clicker in a full party still pays the party bonus (up to +5% at a full fifteen-member party), the 20% party split, and the referrer's slice. Plinko bonuses also count toward total carrots earned for leaderboard and quests.

Shaman edge

Shaman multiplies the lucky-carrot hit chance by 1.4×, so Plinko fires on roughly 0.815% of presses instead of 0.582%. The lift is modest in expected value but variance is meaningfully higher than no-class: quiet stretches punctuated by occasional Mythic and Legendary cascades.

Chapter

Carrot crate pool

Every gear item that can drop from a Carrot Crate, grouped by slot with rarity drop rates and stat ranges.

How crates work

Open a Carrot Crate on the Gacha page to roll one item. Each crate picks a rarity by weight, then picks a random archetype within that slot. Every archetype per slot can drop at any rarity. Higher rarities have wider, stronger stat rolls.

Slot effects

Cape boosts steal multiplier (+0.02x to +0.32x per item). Boots boost energy regen per hour (+1 to +22). Hat boosts max energy (+20 to +450). Equip one per slot from the Gear page; bonuses stack with breed and class stats.

Drop rates

Common 35% · Special 35% · Rare 20% · Epic 7% · Mythic 2.5% · Legendary 0.4% · Ancient 0.1%. Ancient is the white ultra-rare tier above Legendary. There is one crate pool: carrot crates bought with CARROT, ETH, or USDT from Shop or Gacha, then opened on Gacha.

Salvage and reroll

Unwanted items can be salvaged back into carrots from the Gear page. Value scales with rarity and how high in the stat range the roll landed.

Cape

Main stat: steal, plus side rolls

Tattered Cape

Tattered Cape

10 archetypes · all rarities

Snatcher's Cloak

Snatcher's Cloak

10 archetypes · all rarities

Burglar's Cape

Burglar's Cape

10 archetypes · all rarities

Vault Robber's Cape

Vault Robber's Cape

10 archetypes · all rarities

Bandit King's Mantle

Bandit King's Mantle

10 archetypes · all rarities

Bunny Burrow Cape

Bunny Burrow Cape

10 archetypes · all rarities

Warren Scout Cloak

Warren Scout Cloak

10 archetypes · all rarities

Moonhop Cape

Moonhop Cape

10 archetypes · all rarities

Cottontail Mantle

Cottontail Mantle

10 archetypes · all rarities

Hareflare Cape

Hareflare Cape

10 archetypes · all rarities

Stat range by rarity

Common+0.02-0.05× steal + side rolls
Special+0.05-0.08× steal + side rolls
Rare+0.08-0.12× steal + side rolls
Epic+0.12-0.18× steal + side rolls
Mythic+0.18-0.24× steal + side rolls
Legendary+0.24-0.30× steal + side rolls
Ancient+0.30-0.32× steal + side rolls

Boots

Main stat: regen, plus side rolls

Sprout Boots

Sprout Boots

10 archetypes · all rarities

Clover Boots

Clover Boots

10 archetypes · all rarities

Sunbloom Boots

Sunbloom Boots

10 archetypes · all rarities

Evergreen Boots

Evergreen Boots

10 archetypes · all rarities

Meadowstrider Boots

Meadowstrider Boots

10 archetypes · all rarities

Thumper Boots

Thumper Boots

10 archetypes · all rarities

Bunny Trail Boots

Bunny Trail Boots

10 archetypes · all rarities

Burrow Runner Boots

Burrow Runner Boots

10 archetypes · all rarities

Lucky Paw Boots

Lucky Paw Boots

10 archetypes · all rarities

Moonhop Boots

Moonhop Boots

10 archetypes · all rarities

Stat range by rarity

Common+1.00-2.00 regen/hr + side rolls
Special+2.00-4.00 regen/hr + side rolls
Rare+4.00-7.00 regen/hr + side rolls
Epic+7.00-11.00 regen/hr + side rolls
Mythic+11.00-15.00 regen/hr + side rolls
Legendary+15.00-20.00 regen/hr + side rolls
Ancient+20.00-22.00 regen/hr + side rolls

Hat

Main stat: energy, plus side rolls

Pebble Cap

Pebble Cap

10 archetypes · all rarities

Acorn Cap

Acorn Cap

10 archetypes · all rarities

Oakheart Helm

Oakheart Helm

10 archetypes · all rarities

Ironroot Crown

Ironroot Crown

10 archetypes · all rarities

Worldcarrot Crown

Worldcarrot Crown

10 archetypes · all rarities

Bunny Ear Hood

Bunny Ear Hood

10 archetypes · all rarities

Cottontail Cap

Cottontail Cap

10 archetypes · all rarities

Carrot Sprout Bonnet

Carrot Sprout Bonnet

10 archetypes · all rarities

Warren Crown

Warren Crown

10 archetypes · all rarities

Moonrabbit Helm

Moonrabbit Helm

10 archetypes · all rarities

Stat range by rarity

Common+20-50 max energy + side rolls
Special+50-100 max energy + side rolls
Rare+100-175 max energy + side rolls
Epic+175-250 max energy + side rolls
Mythic+250-325 max energy + side rolls
Legendary+325-400 max energy + side rolls
Ancient+400-450 max energy + side rolls

Ring

Main stat: Plinko luck, plus utility rolls

Copper Band

Copper Band

5 archetypes · all rarities

Clover Loop

Clover Loop

5 archetypes · all rarities

Moonstone Ring

Moonstone Ring

5 archetypes · all rarities

Carrot Signet

Carrot Signet

5 archetypes · all rarities

Starforge Ring

Starforge Ring

5 archetypes · all rarities

Stat range by rarity

Common+0.10-0.30% Plinko luck + side rolls
Special+0.30-0.60% Plinko luck + side rolls
Rare+0.60-1.00% Plinko luck + side rolls
Epic+1.00-1.60% Plinko luck + side rolls
Mythic+1.60-2.40% Plinko luck + side rolls
Legendary+2.40-3.40% Plinko luck + side rolls
Ancient+3.40-5.00% Plinko luck + side rolls

Amulet

Main stat: farm, plus utility rolls

Twine Charm

Twine Charm

5 archetypes · all rarities

Clover Amulet

Clover Amulet

5 archetypes · all rarities

Sunstone Pendant

Sunstone Pendant

5 archetypes · all rarities

Moonroot Talisman

Moonroot Talisman

5 archetypes · all rarities

Rainbow Relic

Rainbow Relic

5 archetypes · all rarities

Stat range by rarity

Common+0.10-0.25% farm + side rolls
Special+0.25-0.50% farm + side rolls
Rare+0.50-0.85% farm + side rolls
Epic+0.85-1.30% farm + side rolls
Mythic+1.30-1.90% farm + side rolls
Legendary+1.90-2.70% farm + side rolls
Ancient+2.70-3.50% farm + side rolls

Chapter

Quests

A milestone path that gates parties, breed changes, X, referrals, and the rare bunnies.

How quests work

Quests track on-chain and in-game milestones automatically: total clicks, carrots earned, upgrades bought, party state, referrals, and X status. They unlock in order, with some branching once unlocked.

First steps

Early quests like First Hop, Carrot Pickpocket, and the upgrade trio teach you the core loop: press, earn, spend on the first energy, regen, and steal upgrades.

Social gates

Refer two friends to clear Goblin Diplomacy and unlock parties, then connect X for Blue Check Toll Bridge. Joining a party clears Ratcatchers, filling it to fifteen clears Five Bunnies Walk Into A Pub.

Breed unlocks

Push steal to 2.25x to clear Wizards Hate This Bunny and unlock Moonburrow. Earn 25,000 total carrots to clear The Carrot Cartel and unlock Jackalope. Each rare breed has a follow-up Breed Change quest.

End game

Late quests reward burning carrots on upgrades and stacking the carrot farm to high levels. Finishing quests 1 through 19 unlocks Recipe For Disaster, Bunny Edition for the quest cape.

Chapter

Strategy tips

Practical advice for new players, grinders, and quest hunters.

New player path

Start with Meadow plus Mage if you want the balanced path, Burrow plus Knight if you mostly return after long breaks, or Bandit plus Warrior if you can only log in once a day for one big burst. Save your first carrots for one steal level and one regen level before chasing big buys.

Squeeze every press

Press in bursts when energy is full and let it refill in the background. With no daily cap, your only ceiling is your pool size plus how much regens while you're away. Bigger pools and faster regen pay off the longer you stay engaged.

Party multipliers

A party adds a shared bonus that grows as it fills, peaking at +5% for a complete fifteen-bunny party. Joining and filling a party also clears two quests at once, so prioritize parties early after Goblin Diplomacy.

Carrot farm vs upgrades

Spending on stat upgrades scales your active income. Spending on the carrot farm scales your offline income. Most players want the first farm level early, then alternate between farm and steal.

Stake the surplus

Once your active stash has more than you can sink into upgrades in the next day or two, lock-stake the surplus on the Farm tab. Longer locks pay higher APY. 365-day stakes pay the most but are illiquid for emergency play.

Crates after the basics

Carrot Crates are a smart spend once your steal and regen upgrades are mid-tier. A high-roll cape or boots can outpace 1-2 stat levels per slot, and salvage value softens the floor when you reroll for better stats.

Unlock the rare breeds

If you plan to switch breeds, do not waste a Breed Change before unlocking Moonburrow or Jackalope. Push steal upgrades to 2.25x for Moonburrow, then aim for 25,000 total carrots for Jackalope.

Burn for quests

Carrots burned on upgrades count toward Burnt Offerings. If you are close to 50,000 burned, prefer upgrades over hoarding to bank the 5,000 carrot quest reward.

Chapter

Leaderboard

Server-verified wallets ranked by earned carrots.

Ranking

The leaderboard ranks wallets by server-verified Bunny Button carrots and public player profile data where available.

Identity

Wallet addresses are shortened in the table. If a player links X, their handle and avatar can be shown instead of only the address.

Integrity

Scores come from authenticated wallet activity, so gated routes require wallet connection and sign-in before protected actions count.

Chapter

AI / API

Public read endpoints, JSON schemas, and patterns for building agent dashboards on top of Bunny Button.

What this is

Bunny Button exposes a small JSON HTTP surface at https://www.bunnybutton.xyz/api so AI agents and dashboards can read live game state: leaderboard, presale status, ETH price, and the signed-in player's own profile, inventory, quests, farm, stake, and streaks. Use it to build overviews of carrot earnings, gear loadouts, and class/breed/item combinations.

Base URL

All endpoints live under https://www.bunnybutton.xyz/api and respond with JSON. GET requests return cache-control: no-store unless noted (eth-price is cached for 5 minutes). Errors come back as { error: string } with a 4xx or 5xx status.

Public endpoints

GET /api/leaderboard?limit=100 returns the top wallets ranked by total carrots earned (limit 1-100). GET /api/eth-price returns { ethUsd, fetchedAt } for converting carrot/USD/ETH numbers. GET /api/presale/status?wallet=0x... returns presale totals, remaining allocation, and optional per-wallet contribution. GET /api/party/list returns the public party directory. GET /api/reference/assets returns display-ready image metadata for breeds, classes, carrot tokens, lucky carrots, carrot crates, item archetypes, the item catalog, exclusive presale items, and empty equipment slots. No sign-in is needed for these read-only endpoints, but clients still need to respect rate limits and cache where possible.

Authenticated endpoints

Per-player reads (player profile, inventory, quests, farm, stake, streaks, referral, crate history, and wallet-specific party state) require the wallet's own signed-in session cookie from the www.bunnybutton.xyz sign-in flow. The signed-in wallet can also POST /api/player/energy-potion to burn carrots for the once-daily energy refill. Agents should not collect or reuse session cookies directly; run inside a session the player has already authorized. Cross-origin POSTs are blocked by an origin check, so third-party agents should not attempt state-changing calls.

Player schema

GET /api/player returns { player } with: walletAddress, bunnyBreed, bunnyClass, bunnyGender, carrotBalance, totalClicks, totalCarrotsEarned, carrotsBurned, claimableCarrots, energyCurrent/energyMax/energyRegenPerHour, energyPotionUsedOn/energyPotionUsedToday/energyPotionCost, stealMultiplier, maxEnergyLevel/regenLevel/stealLevel, referralCode, referredBy, unlockedBunnyBreeds, paidBunnyBreeds, rank, lastActiveAt, and bonusCounts (uncommon/rare/epic/mythic/legendary lucky-carrot tallies).

Inventory schema

GET /api/inventory returns the player's gear snapshot: equipped { cape, boots, hat, ring, amulet }, the full items array, each item's equipLevelRequired, the player's current playerLevel, and aggregate stat bonuses contributed by equipped gear. Combine with /api/player to compute total steal/regen/max-energy and utility bonuses by breed x class x items.

Quests, streaks, farm, stake

GET /api/quests returns the quest summary with status and reward state. GET /api/streaks returns the daily login streak and milestone progress. GET /api/farm returns farm level, carrot-per-second yield, accrued offline carrots, and the 8h cap. GET /api/stake returns active stakes plus global stats (total locked, average APY).

Dashboard recipes

Carrot earnings: read /api/player.totalCarrotsEarned over time, plus farm.cps and stake APY for projection. Loadout overview: cross /api/player.bunnyBreed x bunnyClass with /api/inventory.equipped to display the player's effective stats. Top-100 board: /api/leaderboard?limit=100 with /api/eth-price to render carrot/USD figures. Presale tracker: /api/presale/status with optional wallet param for per-user contributions.

Static reference data

Breed stats, class bonuses, item slots, archetypes, and rarity tables are documented in the Breeds, Classes, and Carrot crate pool chapters of the in-app docs. For website displays, fetch GET /api/reference/assets once and use imageUrl for absolute production asset URLs. The response includes breeds, classes, carrots, crates, itemArchetypes, itemCatalog, exclusiveItems, and emptyEquipment. Agents can still hard-code balance values to compute combinations offline; they only change when the game balance is updated.

Fair use

Cache responses where you can, and treat the API as rate limited. Public reads currently allow 30 requests per minute per IP, ETH price allows 120 per minute per IP, and signed-in reads allow 120 per minute per wallet. Requests over budget return HTTP 429 with Retry-After and RateLimit headers before expensive Supabase or contract reads run. Never scrape signed-in endpoints from a wallet that did not consent, ask users to paste session cookies, or use the API to enrich phishing, impersonation, or look-alike sites. Do not impersonate Bunny Button, mint look-alike branding, or present agent output as official. The API surface, schemas, and rate budgets can change as the game evolves. See the Terms chapter.

Agent prompts

Copy and paste into your AI client

Paste in a Claude Code session. Claude will fetch the docs and OpenAPI spec on its own.

Help me build a dashboard on top of the Bunny Button game API.

Read these in order, then propose a plan before writing any code:
1. https://www.bunnybutton.xyz/llms.txt
2. https://www.bunnybutton.xyz/docs
3. https://www.bunnybutton.xyz/api/openapi.json

Then fetch https://www.bunnybutton.xyz/api/leaderboard?limit=10 and https://www.bunnybutton.xyz/api/reference/assets to confirm the surface works and show me the JSON shapes. The public endpoints (leaderboard, eth-price, presale/status, reference/assets) need no auth. Per-player endpoints require my own session cookie from www.bunnybutton.xyz, so plan around that.

Public reads

Public

No sign-in required. Read-only, rate-limited, and intended for agents, dashboards, and backends.

GET/api/leaderboard?limit=100

Top wallets ranked by total carrots earned. limit accepts 1-100. Returns { leaderboard: LeaderboardEntry[] }.

GET/api/eth-price

Cached ETH/USD spot price. Returns { ethUsd, fetchedAt }. Cached ~5 minutes.

GET/api/presale/status?wallet=0x...

Presale totals, remaining allocation, claim flag. Optional wallet param adds per-wallet contribution.

GET/api/party/list

Public party directory. If the caller also has a valid session cookie, the response includes that wallet's own party state and pending requests.

GET/api/reference/assets

Display asset catalog. Returns breeds, classes, carrots, crates, itemArchetypes, itemCatalog, exclusiveItems, and emptyEquipment with imageSrc plus absolute imageUrl.

Per-player session endpoints

Session cookie

Require a Bunny Button session cookie for the wallet that signed in at www.bunnybutton.xyz.

GET/api/player

Full PlayerStats: breed, class, balances, energy, levels, multipliers, rank, bonus counts.

GET/api/inventory

Items, equipped cape/boots/hat, salvage values, and aggregate stat bonuses from gear.

GET/api/quests

Quest summary with status, progress, and reward state per quest.

GET/api/streaks

Daily login streak length, milestone progress, and claimable streak rewards.

GET/api/farm

Carrot Farm level, carrots-per-second, accrued offline yield, and the 8 hour cap.

GET/api/stake

Active stakes plus global stake stats (total locked, average APY).

GET/api/referral

Referral code, referred-by wallet, daily referral earnings, and referee count.

GET/api/crate/history

Recent Carrot Crate openings: rarity, slot, archetype, value, equip level, and timestamp.

POST/api/player/energy-potion

Burns ceil(energyMax / 2) carrots once per UTC day and returns { player } with energy fully refilled.

Quick start

Read the public leaderboard from any agent runtime.

const [leaderboardRes, assetsRes] = await Promise.all([
  fetch("https://www.bunnybutton.xyz/api/leaderboard?limit=10"),
  fetch("https://www.bunnybutton.xyz/api/reference/assets")
]);
const { leaderboard } = await leaderboardRes.json();
const assets = await assetsRes.json();
// leaderboard[i]: { rank, walletAddress,
//   totalCarrotsEarned, bunnyBreed, bunnyClass,
//   stealMultiplier, energyMax, energyRegenPerHour,
//   xHandle, partyName, ... }
// assets.breeds/classes/itemCatalog include imageUrl

Chapter

Terms

Terms for Bunny Button's wallet-based ponzi cookie-clicker game, carrots, CARROT, crates, referrals, withdrawals, social links, and high-risk Web3 mechanics.

Acceptance

By opening Bunny Button, connecting a wallet, signing in, pressing the button, buying crates, joining parties, staking, claiming, withdrawing, or otherwise using the service, you agree to these terms and all game rules shown in the app.

Game nature

Bunny Button is an experimental Web3 game built around cookie-clicker, idle, referral, gacha, staking, and openly high-risk ponzi-style game loops. It is entertainment software, not a savings product, bank account, fund, broker, casino, exchange, or investment program.

Eligibility

You must be at least 18 years old, have legal capacity to use crypto applications, and be allowed to use this type of game in your jurisdiction. Do not use Bunny Button if local law, sanctions rules, platform rules, or wallet-provider rules prohibit you from doing so.

Wallet control

Bunny Button uses wallet ownership to identify players. You are solely responsible for your wallet, embedded wallet, private keys, seed phrase, browser, device, social login, approvals, signatures, and any person who can access them.

Signatures and transactions

Sign-in signatures verify wallet ownership for Bunny Button at https://www.bunnybutton.xyz and should not transfer tokens by themselves. Transaction confirmations, approvals, claims, crate purchases, presale actions, staking actions, and withdrawals can move assets or interact with contracts.

Finality

Blockchain transactions are final once confirmed. Bunny Button cannot reverse network transactions, recover lost keys, cancel mistaken approvals, refund gas, guarantee bridge behavior, or restore assets sent to the wrong address or contract.

Carrots

Off-chain carrots are game progress recorded by Bunny Button systems until a supported claim, withdrawal, or contract flow says otherwise. They can be earned, stolen, burned, taxed, adjusted, limited, or removed under game rules and anti-abuse controls.

CARROT token

On-chain CARROT is a crypto token with market, liquidity, smart-contract, and regulatory risk. Any displayed price, launch rate, APY, claim estimate, or reward estimate is informational and may be wrong, delayed, changed, unavailable, or worth zero.

No return promise

No text, button, leaderboard, crate roll, referral reward, presale page, staking APY, farm output, withdrawal estimate, or community message is a promise of profit, return, redemption, liquidity, buyback, floor price, or future value.

Ponzi-style mechanics

The game may use and joke about ponzi-like incentives such as referrals, competitive rewards, token sinks, staking, and player-funded loops. That framing is part of the game theme and risk disclosure, not a guarantee that later players, token demand, or liquidity will benefit you.

Clicking and energy

Button presses, energy, regen, steal multipliers, lucky drops, streaks, quests, classes, breeds, party effects, and farm output are game mechanics. Rates can be rebalanced, capped, paused, corrected, or recalculated to protect the economy or fix bugs.

Crates and gear

Carrot Crates are randomized game-item purchases. Item rarity, slot, archetype, bonus range, salvage value, and duplicate outcomes are not guaranteed unless the app explicitly shows a confirmed result. Crate purchases and openings are final except where Bunny Button chooses to correct an error.

Staking and locks

Staking carrots or CARROT can involve lockups, forfeited yield on emergency exit, variable APY, contract risk, and protocol changes. Staking is a game mechanic and does not create a deposit, lending relationship, custodial account, or guaranteed income stream.

Presale

Presale participation is high risk. You may lose funds due to token volatility, contract defects, launch delays, insufficient liquidity, regulatory changes, user error, or network failure. If the soft cap is reached, unsold presale CARROT is intended to be burned after the presale closes; if the soft cap is not reached, contributors may be routed through refunds instead. Presale allocations, claim timing, burn execution, and launch mechanics may change before final deployment.

Withdrawals and claims

Withdrawals, claims, vault flows, and token credits depend on eligibility checks, available balances, backend records, smart contracts, RPC providers, supported networks, and gas. Bunny Button may delay or block withdrawals when fraud, abuse, exploit activity, or technical issues are suspected.

Abstract and third parties

Bunny Button may rely on Abstract, RPC providers, wallet providers, thirdweb, Supabase, Discord, X, price feeds, token contracts, and other third parties. Their downtime, rule changes, bugs, or account actions are outside Bunny Button's control.

Referrals

Referral links and growth rewards are game incentives, not commissions, wages, revenue share, or investment advice. Bunny Button may withhold, recalculate, cap, or remove referral rewards connected to sybil behavior, spam, bots, fake accounts, self-referrals, or exploit patterns.

Social features

Discord, X, global chat, parties, leaderboards, invite links, share cards, and public profiles can display wallet addresses, handles, avatars, ranks, referral codes, party data, crate history, and game stats where connected, submitted, or made public by gameplay.

Anti-cheat

Do not exploit bugs, automate abusive traffic, bypass rate limits, farm with botnets, spoof identities, attack APIs, manipulate price feeds, grief players, harass users, launder exploit proceeds through referrals or parties, or interfere with service operation.

Enforcement

Bunny Button may throttle, hide, freeze, correct, claw back, burn, suspend, ban, delist, or remove accounts, balances, rewards, leaderboard entries, referrals, crate credits, chat messages, party access, claims, and withdrawals when needed to enforce rules or protect the game.

Taxes and reporting

You are responsible for any tax, accounting, reporting, withholding, and recordkeeping obligations connected to crypto assets, presale activity, claims, rewards, swaps, withdrawals, referrals, and game-item transactions.

No advice

Bunny Button content is not financial, investment, legal, accounting, regulatory, or tax advice. You should make your own decisions, understand the mechanics, and avoid using funds you cannot afford to lose.

IP and content

Bunny Button artwork, copy, UI, code, logos, characters, item names, and game design are owned by Bunny Button or its licensors unless stated otherwise. You may not copy, scrape, impersonate, resell, or misuse the brand or assets without permission.

Service changes

Features, rewards, balances, rates, tokenomics, APY, quests, classes, breeds, crates, contract addresses, supported networks, social integrations, official links, and documentation may change as the game evolves. Official notices should point to https://www.bunnybutton.xyz.

No warranties

Bunny Button is provided as-is and as-available. The service may be unfinished, interrupted, inaccurate, insecure, exploited, discontinued, or changed without notice. No warranty is made that the game will be profitable, available, fair in every edge case, or error-free.

Liability limits

To the fullest extent allowed by law, Bunny Button and its contributors are not liable for lost profits, lost tokens, lost carrots, failed transactions, gas costs, exploit losses, market losses, tax consequences, downtime, data loss, or indirect, incidental, special, consequential, or punitive damages.

Updates

These terms may be updated by changing the Docs page or posting an official notice. Continued use after an update means you accept the new terms. If you disagree, stop using Bunny Button and do not initiate further game or contract actions.