Appearance
Futures Risk
Admin → Trading → Futures Risk shows the mark price that futures liquidations use and the insurance fund. Superadmins only. What traders see is described in Futures → Mark price.
Status
Top right: Mark price live (green) or Mark price process not running (red). Red means the futures-mark-price process (Market Services) hasn't updated any price in the last 20 seconds; liquidations then use the last price until it runs again. Start it with PM2 like the other services, or by hand:
bash
php artisan futures:mark-price # runs until stopped (restarts itself every hour to pick up changes)
php artisan futures:mark-price --once # one update, prints mark / index / last / sources per marketMark prices
A live table (refreshes every 3 seconds) with one row per futures market:
| Column | Meaning |
|---|---|
| Market | Pair, plus Index (external price used), Own price only (no external price: average of our last price) or Stale, and how many seconds ago it updated |
| Last | Our last trade, and how far it is from the mark (highlighted above 1%) |
| Mark | The price liquidations, unrealized PnL and funding use |
| Index | Median of the external spot prices |
| Mark vs index | Our persistent price difference to other exchanges |
| Sources | Exchanges that answered (hover for their price) |
| Positions | Open futures positions on the market |
Mark price settings
| Field | Default | What it does |
|---|---|---|
| Smoothing window | 300 s | How long the average of (last − index) runs. Longer = steadier against spikes on your own book, slower to follow a real change of your price level. 30 – 3600. |
| Drop sources further than | 3% | A source further than this from the median of all sources is ignored. |
| Fetch external prices every | 5 s | 2 – 60. Each fetch is one request per exchange for all markets. |
| Index sources | Binance, OKX, Bybit, MEXC | Untick a source you don't want to use. At least one. |
The process reads the settings when it starts; it restarts itself every hour, or restart it under Market Services to apply them now.
Markets are matched by their coin symbols (BTC + USDT → BTCUSDT / BTC-USDT). A pair that doesn't exist on any source uses its own average price (shown as Own price only).
Insurance fund
One card per quote coin with the balance, the last 30 days (in from liquidations, out for deficits and shortfalls, number of liquidations) and a 30-day balance chart.
What changes the fund:
| Type | When | Amount |
|---|---|---|
| Liquidation | An Isolated position, or a user's Cross positions, are liquidated | Margin (plus balance taken, for Cross) + unrealized PnL at the mark price. Positive normally; negative when the price gapped past the margin |
| Shortfall | A Cross position is closed with a loss bigger than the user's whole free balance | − the part nobody paid |
| Deposit / Withdrawal | An admin used the buttons below | ± the amount, with the admin and note |
Deposit and Withdraw ask for the coin, amount and a note (shown in the ledger). They change the fund's ledger only: no wallet balance moves. Use them to seed the fund or to record that you moved profit out of it.
Fund ledger
Every movement, newest first, 25 per page, filterable by coin and type. Each row shows the user (links to their profile), the market and mark price, or the admin and note, the signed amount and the balance after it.
The public page /insurance-fund shows the balances and 30-day chart (no user data). The same data is in the API at GET /api/v1/futures/insurance-fund; mark prices at GET /api/v1/futures/mark?market=BTC-USDT (both public).
