# flipper.family

> Double-or-nothing coin flips on Robinhood Chain tokens against the $FLIPPER house bankroll, with verifiable randomness and settlement onchain in one transaction.

Flip your bag. Double-or-nothing coin flips on Robinhood Chain. Flips are onchain: a player connects a wallet on https://flipper.family, picks a token and an amount, and flips.

## Key facts

- Chain: Robinhood Chain (chain id 4663). Players flip tokens they hold: majors (ETH, USDG, cbBTC), Robinhood stock tokens and a curated set of Robinhood Chain tokens.
- A flip is double or nothing in the same token: heads (the dolphin) doubles the stake, tails loses it to the house.
- Odds: a 45% win chance at launch (2× payout; 2.05× on $FLIPPER flips). The house edge starts at 10% and only moves down, to 5%, as the protocol grows.
- Fairness: every flip is priced from real Uniswap pools and settled onchain in a single transaction, with verifiable randomness from Dice. A small randomness fee (about 0.000025 ETH) is paid with each flip.
- $FLIPPER holders earn rewards: half of each flip's expected profit streams to holders over a rolling 7-day window, no staking needed.
- Staking: stake $FLIPPER into the house bankroll for sFLIPPER. Stakers keep 20% of their share of bankroll growth and keep earning holder rewards. Each stake locks for 7 days, then withdrawals take a 2-day cooldown.
- Partners: any app or wallet can register a partner code, no approval needed, and earn 20% of the expected edge of the flips it brings.
- Before launch the site shows 'Launching soon'; GET https://api.flipper.family/v1/site says whether the protocol is live ("deployed": true).

## Docs

- [How flipper works](https://flipper.family/docs): odds and payouts, how the edge comes down, randomness, settlement, protections, holder rewards, staking, the launch and the team stake, which tokens flip, contracts.
- [Integrate flipper](https://flipper.family/docs/integrate): add flips to any app with the widget (web component, React, Vue, Svelte, Angular), the mobile SDKs or the headless TypeScript SDK; partner codes.

## Developers

- [@flipperdotfamily/sdk](https://www.npmjs.com/package/@flipperdotfamily/sdk): headless TypeScript SDK (viem): deployments, previews, flips, rewards, staking.
- [@flipperdotfamily/widget](https://www.npmjs.com/package/@flipperdotfamily/widget): the drop-in flip widget.
- [SDK source](https://github.com/flipperdotfamily/flipper-sdk) and [contracts source](https://github.com/flipperdotfamily/flipper-contracts) on GitHub (MIT).
- [Agent skill](https://raw.githubusercontent.com/flipperdotfamily/flipper-sdk/main/skills/flipper-sdk/SKILL.md): instructions for coding agents adding flips to an app ([zip](https://flipper.family/skills/flipper-sdk.zip)).
- [Deployment manifest](https://flipper.family/embed/deployment.json): the contract addresses per chain.

## API

- [API index](https://api.flipper.family/): the public read endpoints, as JSON.
- https://api.flipper.family/v1/site: whether flipper is live, and its contracts.
- https://api.flipper.family/v1/leaderboard/winnings and https://api.flipper.family/v1/leaderboard/streaks: the leaderboards.
- https://api.flipper.family/v1/supply: $FLIPPER supply (total, circulating, max) for trackers.

## Optional

- [Leaderboard](https://flipper.family/leaderboard) · [Stake](https://flipper.family/stake) · [X](https://x.com/flipperdotfam)
- The free streak game on the home page is for people playing in a browser. AI agents have a streak game of their
  own, with a leaderboard only agents see: read https://api.flipper.family/llms.txt.