What a Boost is
A Boost has two parts:- The bet: the regular Up / Down contract, bought on the order book at the current ask. It buys as many contracts as your stake in dollars, so a right call pays your whole stake back. It pays the normal taker fee, like any order on the book.
- The ride: one option leg bought with the rest of the stake. It’s a call spread on Up and a put spread on Down, struck at the live price when the order is placed. It pays a fixed amount for every $1 the asset closes past that strike, up to a ceiling set so the whole Boost pays at most 100× your stake.
- The bet buys 10 contracts on the order book at 65¢, plus the taker fee of about 1.6¢ each. That’s $6.66 in all, and any close at or above the price to beat pays $10.
- The other $3.34 buys the ride, which adds to the payout for every $1 the asset closes above its strike.
Two records
Once placed, a Boost is two records on your account:
On a Boost order,
stake, max_payout, value, sell_proceeds and payout are the ride’s. The whole Boost cost stake + bet.cost, and multiplier is max_payout ÷ stake.
Partial fills and no sellers
- Partial fill. If the order book can’t sell you the full number of contracts at the price you were shown, the bet takes what it can. The rest of the stake goes into the ride, and
bet.contractssays how many filled. - No sellers. If nothing is for sale at that price, nothing is bought and the order is refused with
400 ORDER_REJECTED. Try again in a moment.
Where and when
- Which markets. Boost is offered on the markets your account has it on. Anywhere else, an order answers
403 BOOST_UNAVAILABLE. - The current window only.
market_tickermust name the window that’s open now; find it withGET /markets?status=open. Any other window answers400 MARKET_NOT_OPEN. - Not in the last minute. That answers
400 MARKET_NOT_OPEN. Otherwise Boost is open whenever the market is: there are no paused hours. - Live keys only. There is no practice Boost: a test key’s order answers
403 BOOST_UNAVAILABLE, and its list is always empty. - Check
mode.liveis real money.shadowmeans the market isn’t open to real money for your account yet: the order is recorded, but no money moved and nothing was bought on the order book.
Place a Boost
201 Created
The response is the order after it’s placed, usually
open. It reads pending while the stake is still being taken.
Retrying safely with client_order_id
The rules are the same as for orders:
- Same id, same order → you get back the order already placed. Never a second one.
- Same id, different order →
409 IDEMPOTENCY_CONFLICT.
503 EXCHANGE_UNAVAILABLE, resend it with the same client_order_id, or look it up with GET /portfolio/boosts?client_order_id=…. Never retry with a new id: if the first request went through, a new id places a second order.
A failed order with no bet gives its id back: nothing moved, so to try again, send the same order with the same client_order_id. A failed order with a bet keeps its id: the bet was bought and is a position on your account, and resending the same id returns that order rather than buying again.
Ids are 1 to 64 characters (letters, digits, . _ : -) and unique per account. Boost orders and book orders keep separate ids, so the same id can be used once on each.
Order status
Track your orders
While an order is open,
value is what the ride is worth at the current price and sell_proceeds is what selling it right now pays. Each is left out when it can’t be worked out. After the close, close_price is the settlement price (or the price it was sold at) and payout is what the ride paid. The bet settles on its own, like any position.
There’s no websocket channel for Boost orders yet, so poll these endpoints.
credit_used and paid show only on orders placed on the website or in the app with trade credit. There, paid is what reached the wallet: the payout less the credit.
Orders placed on the website before Boost replaced the leverage slider may read kind: "multiplier". Every new order is kind: "boost".
Sell early
sell_proceeds, paid to your cash, and the response shows it sold.
- This sells the ride only. The bet is an ordinary position: sell it on the order book like any other (see Order entry), or hold it to the close.
sell_proceedsis belowvalue, so buying and selling straight back costs money.expected_proceedsis optional. With it, the sale is refused (400 ORDER_REJECTED) if it would pay more than 10% less.- Only an
openorder can be sold, and not in the window’s last minute. - A key limited to some series can only sell Boost orders on those, including ones placed on the website or in the app.
- A sale has no
client_order_id. If it answers503 EXCHANGE_UNAVAILABLE, get the order before trying again:sellingorsoldmeans it went through.
At the close
Open orders settle automatically on the window’s result:settling, then settled, with the ride’s payout sent to your cash. The bet settles like any position in that market. If the result still can’t be read 6 hours after the close, the ride’s stake is refunded and the order reads void.
Limits
The tightest of these wins:- Your key’s limits. The key’s max order applies to the whole stake: trade keys start at $20 per order, so raise the key’s max order to stake more. The key’s daily limit counts its Boosts of the last 24 hours, bet and ride, alongside its book fills and resting buys;
GET /accountshows them together asdaily_used_usd. A key limited to some series can only place Boost orders on those. - The stake, the same as on the website: $1 to $100 per order. There’s no limit on how many orders you place on a window or in a day, beyond the cash they need and your key’s limits.
- The order budget. Each new Boost order costs one unit of your key’s order budget (10 a second, bursts of 20), like a book order. Sales don’t. See Rate limits.
400 LIMIT_EXCEEDED, with a message that says which.
Before your first order, the account must have accepted the current Terms of Service and allowed trading on its wallet (a one-time step in the app). Without them, an order answers 403 FORBIDDEN and says which step is missing.
Errors
Boost
How a Boost pays, when it’s open, and cashing out early.
Order entry
Limit orders on the order book, batches, and cancels.