FlareBank docs / Bankroll
Bankroll docs
Long or short any FTSO price with BANK. Margin in BANK, paid out in BANK. BANK holders are the House.
Live on Flare mainnet as a small-cap test. Not externally audited — use small amounts only.
1 · What Bankroll is
Bankroll lets you take a position on the price of assets Flare's FTSO tracks — BTC, ETH, XRP, SOL, HYPE and more, plus gold through PAXG — going long (you profit if it rises) or short (you profit if it falls), with leverage (currently up to 3×). The live list is the markets table on the Bankroll page.
Everything is in BANK. You post BANK as margin, profits are paid in BANK and losses are taken in BANK. On the other side of every trade is the House: a vault BANK holders deposit into, which earns when traders lose and pays when they win.
| Who | Does | Earns |
|---|---|---|
| Trader | Posts wBANK, opens long or short positions | Profit on price moves, paid in wBANK |
| House depositor | Deposits wBANK into the House | Trader losses and funding, minus trader wins |
| Liquidator (anyone) | Closes positions that fall below maintenance | 0.5% of the position, in wBANK |
| Governor | Lists markets and sets their limits — a FlareBank test wallet now, the DAO timelock before public launch | Nothing |
| FlareBank DAO treasury | Receives fees (fixed in the contract, can't be changed) | Open and close fees and 10% of funding |
2 · Trading
Before you start: Bankroll uses wBANK, a 1:1 wrapper for BANK. BANK charges 1% on every transfer; wBANK doesn't, so you pay 1% once to wrap and 1% once to unwrap, and nothing in between. Wrap on the Bankroll page.
- Pick a market and Long or Short, enter your margin in wBANK and choose leverage. Position size = margin value × leverage.
- Request the position. Your margin plus the 0.15% fee is held in escrow and the current FTSO price is recorded. The request is checked straight away (leverage, size, your balance), so an impossible one never leaves your wallet. The ticket shows the biggest position allowed right now and its MAX button fills the most margin that fits.
- About 30 seconds later the keeper fills it at the FTSO price then (anyone can, including you). If the price moved more than 0.1% in those 30 seconds, FTSO is still catching up to a fast move and your request is refunded instead — minus the 0.15% fee, which goes to the House so that trying to time the catch-up costs money. See Prices. A countdown shows when it can fill, how long the keeper is taking, and when it expires; if the keeper is more than 20 seconds late a Fill now button appears. If nobody fills it within 5 minutes, anyone can refund it in full.
- Track it under Your positions: live profit and loss, a price chart since you opened (entry and liquidation lines, profit shaded blue and loss red, hover for your PnL at any moment) and a gauge showing how far the price can move against you before liquidation. Add margin any time to push the liquidation price further away.
- Close any time from 5 minutes after it filled. Closing works the same way: about 30 seconds after you ask, it fills at the worse of the price when you asked and the price when it fills, and waits a little longer if FTSO is still moving fast. Your margin comes back plus profit or minus loss, less a 0.15% close fee. The same countdown shows progress; if FTSO is still moving fast when it's due, the close re-arms at the new price and the timer restarts. Liquidations never wait.
One position per market per wallet. Profit and loss are measured in US dollars from the FTSO price, then converted to wBANK at the BANK floor (below) when you close. While a position is open it pays a borrow fee of 0.005% of its size per hour (about 0.12% a day) to the House, whichever side it's on.
Your margin's dollar value moves with FLR. Margin is valued at the BANK floor in WFLR, then converted with the FTSO FLR price, so a falling FLR brings your liquidation price closer even if your market hasn't moved.
3 · The House
The House is the counterparty to every trade. Deposit wBANK and you receive shares; their value rises when traders lose or pay funding and falls when traders win.
- Shares are priced at market value. Deposits and withdrawals use the House balance minus traders' open profit (or plus their open loss), so nobody can exit just before a known loss lands or buy in just before a known gain.
- Deposits and withdrawals take about 30 seconds, and fill at the worse of the two House values for you — the value when you asked and the value when it fills — so nobody can time a market move FTSO hasn't caught up with yet. A countdown shows progress.
- Minimum deposit 100 wBANK. The deposit box won't accept less.
- Deposits are refused while traders' open profit has eaten more than half of the House.
- You can withdraw 24 hours after your last deposit.
- A withdrawal is refused if the House left behind could not cover the bigger side of every market. It goes through once positions close.
- The House can hold at most 10% of all BANK, so Bankroll can never grow bigger than FlareBank itself.
BANK dividends: wBANK passes BANK's dividends to FlareBank's lending depositors, not to other holders, so wBANK in the House does not earn BANK dividends. House depositors earn from trading — losses, funding and borrow fees — instead.
The House is a real risk position: when traders win, depositors pay them. Size your deposit accordingly.
4 · Prices
Markets use FTSOv2 block-latency feeds, which update about every 1.8 seconds from ~100 independent Flare data providers. Bankroll finds FTSOv2 through Flare's official contract registry on every read, as Flare recommends, so it keeps working if Flare upgrades it. Opening needs a price at most 30 seconds old; closing and liquidating at most 90 seconds. Older, future-dated or zero prices are refused.
Why opens take 30 seconds. FTSO moves towards the real market in small steps each block, so after a sudden move elsewhere it takes a little while to catch up. Without a delay, someone could open at the lagging price and collect the catch-up from the House. The 30-second wait — and the refund if FTSO moved more than 0.1% during it — closes that door.
wBANK has one price for everything — margin, payouts and fees:
floor = BANK redemption value - 1% unwrap fee (what the reserve pays for BANK) value = floor x FLR/USD (dollars per wBANK)
- The floor comes from FlareBank's reserve — the same redemption oracle the lending market uses. It only moves with real flow through the reserve, which pays the vault's fee both ways.
- BANK's DEX price is deliberately not used. BANK mints around 21 WFLR and redeems around 17, so a thin pool can sit anywhere in between and could be pushed around for a few dollars. A price that can be moved cheaply has no place deciding payouts.
- For size limits the House is valued at what its whole balance would redeem for in one sale — less than the floor price, because a big sale moves down the curve.
5 · Size limits
Every limit is a share of the House, valued at what it would actually redeem for, so Bankroll grows only as fast as BANK holders back it. Because one position can be at most 10% of the House and the minimum is $10, no trade can open until the House is worth about $100. The trade ticket always shows the biggest position allowed right now and says why when a size is too big.
| Limit | Rule |
|---|---|
| Leverage | Set per market, never above 5×. Every market is at 3× during the test |
| One position | At most 10% of the House |
| Worst-case exposure | The bigger side (long or short) of every market, added up, at most 50% of the House. Hedging doesn't get around it: only the bigger side counts |
| One market | A cap per side set by the governor, never above $100,000 ($50 per market during the test) |
| Markets | At most 16 |
| House size | At most 10% of BANK supply |
| Minimum position | $10 |
| Drawdown brake | If the House falls 30% below what was deposited, new positions stop |
6 · Liquidations — open to anyone
A position is liquidatable when its equity (margin value + profit − loss − funding owed) falls below 2% of its size. Anyone can liquidate it — there is no whitelist and no waiting period — and is paid for doing so. The liquidator's reward comes out of the margin first, so it is paid even when a price gaps straight past the liquidation point.
| On a liquidation | Goes to |
|---|---|
| 1% penalty — half (paid first) | Whoever called the liquidation |
| The position's loss | The House |
| 1% penalty — other half | The Clearing Reserve (a backstop for the House) |
| 0.15% close fee | The DAO |
| Whatever margin is left | Back to the trader |
The Bankroll page lists every liquidatable position with a Liquidate button. Bots can call marginCall(trader, marketId) on the Bankroll contract directly; liquidatable(trader, marketId) tells you which ones qualify. FlareBank also runs its own liquidator so positions are closed even when nobody else is looking.
7 · Fees and funding
| Amount | Paid to | |
|---|---|---|
| Open | 0.15% of position size | DAO |
| Close | 0.15% of position size | DAO |
| Liquidation penalty | 1% of position size | Half liquidator, half Clearing Reserve |
| Funding | Up to 0.1% per 8 hours | The crowded side pays the House; 10% of it to the DAO |
| Borrow | 0.005% of size per hour (≈0.12%/day) | Every open position, either side, to the House |
| Refused open (price moved, leverage, escrow) | 0.15% of position size | The House |
| Wrap / unwrap | 1% each | BANK's own transfer fee |
Funding nudges longs and shorts towards balance. When one side is bigger, that side pays the House continuously — the House carries that imbalance — scaled by how lopsided the market is: 0.1% per 8 hours at most, when everyone is on one side.
The 30-second fills on both opening and closing, the 0.15% fee and the 5-minute minimum hold are deliberate: together they make it unprofitable to trade on FTSO's catch-up lag at the House's expense. The borrow fee makes sure tying up the House's capacity always costs something — even a perfectly hedged pair of positions.
8 · Network fees and stuck transactions
Flare's network fee (the base fee) normally sits around 500 gwei but can jump several-fold within minutes when blocks fill up — on 14 November 2026 it went to about 5,500 gwei. A trade request costs a few hundred thousand gas, so even then it's around 1–2 FLR.
- Gas. The cost of a call that reads FTSO prices changes from block to block, so the site sends every transaction with 50% more gas than estimated. You only pay for what's used.
- Fee cap. The site lets each transaction pay up to 3× the current base fee, plus a small tip, so a spike doesn't strand it. You pay only the actual base fee plus the tip. Keep the site's suggested fees in your wallet.
- Stuck transaction. If a transaction was sent with too low a fee cap it waits in the queue, and nothing else from your wallet confirms until it clears. The Bankroll page shows a warning when this happens. Fix it in your wallet with Speed up or Cancel; if your wallet has lost track of it, send 0 FLR to yourself with the stuck transaction's nonce and a higher fee than the current base fee.
9 · If things go wrong
If a winner is owed more than a loser's margin covers, the shortfall is paid from, in order:
- The House.
- The Clearing Reserve.
- If both run out, the winner is paid what exists, new positions stop permanently, and the contract records on-chain exactly who is owed what. Anyone can then settle every remaining position (no fee), and the House can be withdrawn once the book is empty.
If a price feed dies. If a market's FTSO price can't be read, the keeper (or anyone) starts a 24-hour clock; any good reading resets it. After 24 hours of continuous failure, anyone can settle its positions at the last good price, with no fee. If the DAO delists a market, positions can be settled the same way 7 days later. After a wind-down, the Clearing Reserve goes to the House. Your margin can never be stuck.
The DAO can vote to cover a shortfall. BANK holders can propose and pass a vote to pay affected winners from the DAO treasury, or to top up the House. It is a choice the DAO makes at the time, not an automatic guarantee.
FlareBank's main reserve is never touched automatically. On its own, Bankroll can only ever pay out what is in the House and its Clearing Reserve.
10 · Who controls what
| Who | Can | Cannot |
|---|---|---|
| Governor — a FlareBank test wallet during the test; handed to the DAO timelock before public launch | List (up to 16) and delist markets; set a market's leverage (≤ 5×) and cap (≤ $100k); pause or resume new positions; change the guardian; hand over to a new governor (two-step: propose, then accept) | Touch House funds or margin, change fees, the fee recipient or any other rule, block exits |
| Guardian — the DAO treasury | Pause new positions on a market in an emergency | Unpause, list, or change anything |
| Fee recipient — the DAO treasury | Receive open/close fees and 10% of funding | Fixed at deployment; nobody can change it |
| Anyone | Fill or refund open, close and House requests, liquidate, report a dead feed, settle stranded positions, update funding | — |
| Nobody | Stop you closing, adding margin, being liquidated or settling a stranded position; upgrade the contracts |
Every rule other than the per-market settings above is fixed in the contract code and cannot be changed after deployment.
11 · Risks
- Leverage. A 5× position is liquidated by a move of roughly 18% against you, sooner if FLR also falls.
- BANK and FLR exposure. Margin and payouts are wBANK, valued at BANK's floor in FLR, so your result in dollars also depends on both.
- House risk. Depositors lose when traders win. Limits cap how much the House can lose to open positions, but not to zero.
- Oracle risk. Bankroll relies on FTSOv2 and the BANK redemption oracle. It stops trading rather than use a stale price, and a dead feed can always be settled at its last good price.
- Refused opens. In fast markets your open may be refused and refunded minus the 0.15% fee. That's the protection working, not a fault.
- Slower exits. Closes take about 30 seconds and can wait longer while prices move fast, at the worse of two prices. Liquidation is still instant.
- Network fees. Flare's base fee can spike; transactions sent with too low a cap get stuck (see section 8).
- Keeper. FlareBank's keeper fills requests and liquidates. If it's down, anyone — including you — can do the same from the page, and expired requests can always be refunded.
- Smart-contract risk. The code has extensive tests and two independent reviews, but no paid external audit yet. Don't deposit more than you can afford to lose.
12 · Contracts and source
| Contract | Role |
|---|---|
Bankroll0x572Db92037706506bA655Da4f639274F1BF229C7 | Trading: request and fill opens, close, add margin, liquidate, settle stranded positions, funding |
House0x25761C4125BC2128768843740129d4C1432473b1 | The vault BANK holders deposit into, priced at market value |
FtsoIndex0x627d8Ff8Be55A2cDAef6BC17166B94875eaa91d2 | Reads FTSOv2 through Flare's contract registry and refuses stale prices |
BankMarginOracle0xd957F0DF1A5f173D4DdBed6309aF0aE6AD092A6B | Values wBANK at the BANK redemption floor |
Governor0x9F494DAd807fab296DC69938aE4C8ff7259428fe | Test-phase market admin (see Who controls what) |
DAO treasury0xaA68BC4BAb9a63958466f49f5a58c54A412D4906 | Fee recipient and guardian |
Keeper0x668eD573468Cd6f4223E28462d9583D8B43Ad340 | FlareBank's bot: fills requests, liquidates, refreshes prices (gas only, no special rights) |
All contracts are verified on the Flare explorer (deployed in block 74515546). They have no owner and no upgrade path, and are built with Flare's official developer libraries. They went through two review rounds — against Flare's official developer guidance and an independent Flare/Enosys security checklist, the second after the fixes from the first — plus the Slither, Aderyn and Mythril static analysers; every finding and its fix is listed in the repository's review record. No paid external audit yet. Source is open under AGPL-3.0; parts are adapted from NetNet Capital Management's open-source futures desk, with the changes listed in each file.