Capabilities
- Up to 10x leverage — Adjustable per account via the leverage endpoint
- Isolated Margin mode — Limit risk to the margin allocated to a specific position, preventing cross-position liquidation cascades
- 6 order types — Limit, Market, Stop-Limit, Trigger-Market, OCO, Bulk-Limit (details)
- Bulk orders — Place up to 20 collateral limit orders in a single call (endpoint)
- Position management — Open, monitor, and close positions programmatically (open positions, close)
API naming convention: WhiteBIT’s API uses “collateral” endpoints for both
Margin and Futures trading. The market pair determines the product:
spot pairs (e.g.,
BTC_USDT) for Margin, perpetual pairs (e.g., BTC_PERP)
for Futures. All endpoints under /api/v4/order/collateral/ and
/api/v4/collateral-account/ serve both products.
See Compare Trading Products for a full side-by-side comparison.Who Uses This
- Hedge funds — Hedging spot holdings or amplifying directional exposure with controlled risk
- Prop trading firms — Leveraged strategies on liquid spot pairs with isolated margin for risk containment
- Experienced algo traders — Programmatic margin management through the collateral account API
Common Integration Patterns
Hedging — Open opposing margin positions to offset risk on existing spot holdings. For example, short BTC_USDT on margin while holding BTC in a spot wallet. Use the collateral account balance endpoint to monitor margin utilization. Leveraged directional trading — Amplify exposure with controlled risk via isolated margin. Set leverage via the leverage endpoint, place orders, and monitor positions through the open positions endpoint. The API returns aliquidationPrice field in position responses for risk monitoring.
Risk Context
Borrowed funds fee: A commission is charged for using borrowed funds — only applied when an order is at least partially executed. Unexecuted orders incur no borrowing fee. See the trading fees page for the current rate. No public endpoint returns the rate itself; accrued cost per open borrow arrives asunrealized_funding on the Borrows stream.
Liquidation can occur when the maintenance margin threshold is breached. The Maintenance Margin Rate is 3% for leverage 1x–10x, and partial liquidation closes part of the position before full liquidation.
Full mechanics — the maintenance margin schedule, leverage brackets, the liquidation sequence, and the liquidationPrice / liquidationState / marginFraction fields for risk monitoring: Liquidation and margin requirements.
Portfolio Margin is available for institutional clients with a minimum 200,000 USDT collateral balance.
Portfolio Margin provides up to 10x leverage with portfolio-level risk assessment.
Contact institutional@whitebit.com or see the
Institutional Overview for details.
Technical Overview
Endpoint categories (shared with Futures Trading):
- Account & Balance — Balance, balance summary, account summary, leverage, hedge mode (6 endpoints)
- Order Management — Limit, bulk-limit, market, stop-limit, trigger-market, OCO, cancel (7 endpoints)
- Order Queries — Conditional orders, OCO orders (2 endpoints)
- Position Management — Open positions, ADL quantile (returns perpetual markets only), close position, position history, closed-position PNL, funding history (6 endpoints)
BTC_USDT) route to Margin. Perpetual pairs (e.g., BTC_PERP) route to Futures.
For full endpoint documentation, see the Collateral Trading API Reference.
For Go and PHP examples, see SDKs.
What’s Next
Margin & Futures Quickstart
Open a first leveraged position in 5 minutes.
Futures Trading
Compare with perpetual contracts — up to 100x leverage and Hedge Mode.
API Reference
Full endpoint documentation for all 21 collateral trading endpoints.