BloFin Account Manager
Manage your BloFin futures trading account — balances, positions, leverage, margin mode, and account configuration. All tools require authenticated API access.
Available Tools (via blofin-mcp)
get_balance — Futures Account Balance
Check your futures trading account balance.
Use get_balance to check account funds.
Key response fields:
totalEquity— Total account equity in USDisolatedEquity— Equity in isolated margin positionsdetailsarray per currency:currency,equity,balance,availableEquity,availablefrozen,orderFrozen— Funds locked in ordersunrealizedPnl— Current unrealized profit/lossisolatedUnrealizedPnl— Isolated position unrealized PnL
Example prompts:
- "What's my BloFin account balance?"
- "How much available margin do I have?"
- "Show my unrealized PnL"
get_positions — Open Positions
View all currently open positions.
Use get_positions to see current open positions.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
instId | String | No | Filter by instrument, e.g. BTC-USDT |
Key response fields:
instId— InstrumentpositionSide—long,short, ornetpositions— Position size (contracts)availablePositions— Closeable position sizeaveragePrice— Average entry priceunrealizedPnl— Unrealized profit/lossunrealizedPnlRatio— PnL percentageleverage— Current leveragemarginMode—crossorisolatedliquidationPrice— Estimated liquidation pricemargin— Position marginmarkPrice— Current mark price
Example prompts:
- "Show all my open positions"
- "What's my BTC position?"
- "Am I in profit or loss?"
- "How close am I to liquidation?"
get_leverage_info — View Leverage
Check current leverage settings for an instrument.
Use get_leverage_info to see the current leverage configuration.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
instId | String | Yes | Instrument ID, e.g. BTC-USDT |
marginMode | String | Yes | cross or isolated |
Example prompts:
- "What leverage am I using for BTC-USDT?"
- "Show my leverage settings"
set_leverage — Adjust Leverage
Change the leverage for a specific instrument.
Use set_leverage to adjust leverage. Confirm with the user before applying changes.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
instId | String | Yes | Instrument ID, e.g. BTC-USDT |
leverage | String | Yes | Leverage value, e.g. 10 |
marginMode | String | Yes | cross or isolated |
positionSide | String | No | long or short (for hedge mode) |
Important constraints:
- Max leverage varies by instrument (check via
get_instruments→maxLeverage) - Cannot change leverage while there are pending cross orders (error 110006)
- May need to cancel open orders and close positions first (error 110019)
Example prompts:
- "Set my BTC-USDT leverage to 10x"
- "Lower my ETH leverage to 5x isolated"
- "What's the maximum leverage I can use for SOL-USDT?"
get_margin_mode / set_margin_mode — Margin Mode
View or change between cross and isolated margin modes.
Use get_margin_mode / set_margin_mode to manage margin mode.
Always confirm with the user before switching margin mode.
Parameters (set):
| Parameter | Type | Required | Description |
|---|---|---|---|
instId | String | Yes | Instrument ID |
marginMode | String | Yes | cross or isolated |
Margin mode comparison:
| Feature | Cross | Isolated |
|---|---|---|
| Margin sharing | Shared across positions | Per-position |
| Liquidation risk | All positions affected | Only the isolated position |
| Capital efficiency | Higher | Lower |
| Risk control | Less granular | More granular |
Example prompts:
- "Switch BTC-USDT to isolated margin"
- "What margin mode am I using for ETH?"
get_position_mode / set_position_mode — Position Mode
View or change between one-way and hedge position modes.
Use get_position_mode / set_position_mode to manage position mode.
Always confirm with the user before switching.
Parameters (set):
| Parameter | Type | Required | Description |
|---|---|---|---|
positionMode | String | Yes | long_short_mode (hedge) or net_mode (one-way) |
Position mode comparison:
| Mode | Description |
|---|---|
net_mode | One-way mode. Can only hold one direction per instrument. |
long_short_mode | Hedge mode. Can hold both long and short positions simultaneously. |
get_account_config — Account Configuration
Get the overall account configuration settings.
Use get_account_config to review account settings.
Example prompts:
- "Show my BloFin account configuration"
- "What position mode am I using?"
Safety Rules
- Always confirm with the user before changing leverage, margin mode, or position mode
- Warn about liquidation risk when leverage is set above 20x
- Check for open positions before changing margin mode (may fail with existing positions)
- Display unrealized PnL prominently when showing positions — users need to know their current risk exposure