Appearance
Futures
Futures let traders bet on a price going up (long) or down (short) with leverage, without owning the coin. The platform offers linear perpetual contracts: margin and profit are in the quote coin (for example USDT), and positions stay open until the trader closes them or they're liquidated.
Requirements
Futures need APP_PLAN=5, so that the futures background processes run (futures-mark-price, futures-processor, futures-limit-processor, futures-tpsl-process). Futures are switched on per market in Admin → Markets. The futures list is at /markets/futures, and each pair's screen at /futures-market/BTC-USDT.
Opening a position
On the futures trade screen, the order form has:
| Field | Meaning |
|---|---|
| Leverage | A slider from 1x to 125x. The position is margin × leverage. |
| Limit / Market | Open at a chosen price, or at once at the market price |
| Price | For limit orders: the price to open at |
| Amount | The margin: how much of the quote coin the trader puts in |
| TP/SL | Optional Take Profit and Stop Loss prices |
| Buy/Long or Sell/Short | The direction |
The form shows the available balance and the Est. fee.
How the size is calculated
txt
fee = margin × fee rate
position value = (margin − fee) × leverage
position size = position value ÷ entry price (in the base coin)Example: 100 USDT margin, 10x leverage, BTC at 50,000 USDT, taker fee 0.1%: fee 0.1 USDT → position value 999 USDT → size 0.01998 BTC.
- Market orders pay the futures taker fee and open at once at the last price.
- Limit orders pay the futures maker fee. The margin is locked until the price is reached, then the position opens at that price. The
futures-limit-processorwatches them.
Fees are set in Trading & fees.
Which balance is used
Margin comes from the trader's Trading Account balance of the quote coin (see Wallets). Profits go back there.
While the position is open
The Positions tab shows each open position: pair, side, size, entry price, Liquidation price, live PNL, and TP/SL.
Profit and loss (in the quote coin):
txt
Long: PNL = size × (current price − entry price)
Short: PNL = size × (entry price − current price)Take profit and stop loss
If the trader set TP or SL, the futures-tpsl-process closes the position automatically when the price reaches it.
Funding
Every 8 hours, open positions pay or receive funding at a rate of 0.01% of the position value (size × current price):
- with a positive rate, longs pay and shorts receive,
- the amount is taken from or added to the position's margin.
The scheduler checks every hour for positions that are due (futures:funding-fees). Users see what they paid in Funding fee distributions (/reports/funding-fee-distributions). The futures trade screen shows the current Funding Rate.
Changing the funding rate
The rate and interval aren't in the admin panel yet. They're settings named futures.funding_fee_rate (percent, default 0.01) and futures.funding_fee_interval_hours (default 8). Change them from the server:
bash
php artisan tinker --execute="Setting::set('futures.funding_fee_rate', '0.005'); Setting::set('futures.funding_fee_interval_hours', '8'); Setting::save();"Set the rate to 0 to switch funding off.
Margin mode: Isolated or Cross
The order form has an Isolated / Cross switch (shown when an admin allows Cross margin for futures); positions show their mode next to the leverage.
| Isolated (default) | Cross | |
|---|---|---|
| What backs the position | Only its own margin | The user's whole free balance of the quote coin (USDT) plus all Cross positions |
| Worst case | The margin is lost | The free balance can be used up as well |
| Liquidation | At the position's own liquidation price | When equity ≤ maintenance margin for the user's Cross positions together |
| Closing at a loss bigger than the margin | Released 0, the margin is lost | The difference is taken from the free balance |
For Cross: equity = free balance + the Cross positions' margin + their unrealized PnL; maintenance = position size × mark price × the maintenance rate (default 0.5%). The positions table shows an estimated liquidation price per Cross position (other positions held at the current price), or — when the balance covers the whole position. A push notification warns when equity falls to twice the maintenance margin; at liquidation all Cross positions are closed and the free balance pays the losses. Copy trading always uses Isolated.
Note that the Trading wallet is shared with spot trading: with Cross positions open, the USDT used for spot orders is also backing them.
Mark price and index price
Liquidations, unrealized PnL and funding use the mark price, not the last trade. One large order on a thin order book can make the last price spike for a moment; the mark price barely moves, so nobody is liquidated by a spike.
| Price | How it is calculated |
|---|---|
| Index price | Median of the spot price on Binance, OKX, Bybit and MEXC. A source more than 3% (setting) away from the median of all sources is ignored. Fetched every 5 seconds. |
| Mark price | Index price + the average of (our last price − index price) over the last 5 minutes (exponential moving average). |
| Last price | Our own last trade. Orders, take profit, stop loss and Close Position still fill at this price. |
The average difference lets the mark follow our own price level: if a pair always trades 2% above other exchanges (for example with custom liquidity), the mark stays there too. A sudden move of only our price moves the mark by about seconds ÷ 300 of it. In tests, a +30% spike that lasted 5 seconds moved the mark by less than 0.5%. When the index moves, the mark moves with it at once.
Markets with no price on those exchanges (your own tokens), or while all of them are unreachable for over a minute, use the 5-minute average of our own last price.
The futures screen shows Mark Price and Index Price next to the 24h stats (the label links to an explanation), and the positions table has a Mark Price column. The app shows the mark price on each position card. The futures-mark-price process (Market Services) keeps the prices fresh; settings and a live table are in Admin → Futures Risk.
Keep futures-mark-price running
If the process stops, the mark price goes stale after 20 seconds and liquidations fall back to the last price (a warning is logged and Admin → Futures Risk shows Mark price process not running).
Liquidation
Isolated positions get a liquidation price when they open. It's calculated from the entry price and leverage, with a 0.5% maintenance margin rate per 1x of leverage. The higher the leverage, the closer the liquidation price is to the entry price.
If the mark price reaches the liquidation price, the futures-processor closes the position, and the margin is lost. Cross positions are checked the same way, with mark prices for every position of the account.
How far the price can move against the position before liquidation, with the platform's formula:
| Leverage | Long: price may fall | Short: price may rise |
|---|---|---|
| 2x | 33.1% | 98.0% |
| 10x | 8.7% | 10.5% |
| 50x | 1.5% | 1.5% |
| 100x | 0.5% | 0.5% |
| 125x | 0.3% | 0.3% |
Insurance fund
Because a position is liquidated before its margin is fully used up, the trader usually loses more than the real loss at the mark price. That difference goes into the insurance fund (one balance per quote coin, for example USDT):
txt
fund += position margin + unrealized PnL at the mark priceWhen the price jumped past the point where the margin is gone (a gap between two checks), the result is negative and the fund pays the difference. A Cross position closed at a loss bigger than the user's whole balance takes the uncovered part from the fund too (a shortfall).
Everyone can see the fund at /insurance-fund (footer → Insurance Fund, and header More menu): the balance per coin, a 30-day chart, and how the mark price works with live mark, index and last prices. Admins see every movement in Futures Risk.
The fund is a ledger
The platform is the counterparty of every futures position, so the fund doesn't move money between wallets. It records how much liquidations made or cost the exchange, and shows traders that losses beyond a position's margin are covered.
Closing a position
Close Position closes it at the current market price. The trader gets back:
txt
(margin + PNL) − exit fee (exit fee = futures taker rate × (margin + PNL))Profits also count towards lifting the transfer fee between Trading and Funding.
History
| Where | Shows |
|---|---|
| Trade screen → Positions and Open Orders | Open positions and waiting limit orders (with Cancel) |
Futures trades (/reports/futures-trades) | Closed positions with their result |
Funding fee distributions (/reports/funding-fee-distributions) | Funding paid and received |
Explain the risk
Leverage multiplies losses as well as profits. Make sure your Risk Disclosure Statement page (Pages) explains futures risk. The leverage slider always goes up to 125x.
