Skip to main content
A Boost order is one order on the window that’s open now. It pays more the further the price closes your way. It’s the same order the website and the app place: the same server prices it, and the same limits and settlement apply. Placing and selling need an API key with the Trade permission; reading needs Read. See Authentication.
Boost orders are real money. The stake is paid from your account’s cash the moment the order is placed. Orders placed through the API never use trade credit.

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.
For example, a $10 Boost on Up when Up’s ask is 65¢:
  • 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.
The option leg has no order book. It’s quoted on request (RFQ) when you place the order, priced for your order at that moment from the live price and the move expected in the time left.

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.contracts says 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_ticker must name the window that’s open now; find it with GET /markets?status=open. Any other window answers 400 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. live is real money. shadow means 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
Here the whole Boost cost $10.00 ($3.34 + $6.66) and pays up to $1,000 ($990 from the ride + $10 from the bet). 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.
When a request times out or answers 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

The ride is sold back for its current 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_proceeds is below value, so buying and selling straight back costs money.
  • expected_proceeds is optional. With it, the sale is refused (400 ORDER_REJECTED) if it would pay more than 10% less.
  • Only an open order 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 answers 503 EXCHANGE_UNAVAILABLE, get the order before trying again: selling or sold means 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:
  1. 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 /account shows them together as daily_used_usd. A key limited to some series can only place Boost orders on those.
  2. 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.
  3. 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.
Going over a limit answers 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.