blofin-account-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

BloFin Account Manager

BloFin账户管理器

Manage your BloFin futures trading account — balances, positions, leverage, margin mode, and account configuration. All tools require authenticated API access.

管理你的BloFin期货交易账户——涵盖余额、持仓、杠杆、保证金模式及账户配置。所有工具都需要经过身份验证的API访问权限。

Available Tools (via blofin-mcp)

可用工具（通过blofin-mcp提供）

get_balance — Futures Account Balance

get_balance — 期货账户余额

Check your futures trading account balance.

Use get_balance to check account funds.

Key response fields:

```
totalEquity
```
— Total account equity in USD
```
isolatedEquity
```
— Equity in isolated margin positions
```
details
```
array per currency:
- ```
currency
```
  ,
```
equity
```
  ,
```
balance
```
  ,
```
availableEquity
```
  ,
```
available
```
- ```
frozen
```
  ,
```
orderFrozen
```
  — Funds locked in orders
- ```
unrealizedPnl
```
  — Current unrealized profit/loss
- ```
isolatedUnrealizedPnl
```
  — Isolated position unrealized PnL

Example prompts:

"What's my BloFin account balance?"
"How much available margin do I have?"
"Show my unrealized PnL"

查询你的期货交易账户余额。

Use get_balance to check account funds.

核心返回字段：

```
totalEquity
```
— 以美元计价的账户总权益
```
isolatedEquity
```
— 逐仓保证金持仓的权益
各币种的
```
details
```
数组：
- ```
currency
```
  ,
```
equity
```
  ,
```
balance
```
  ,
```
availableEquity
```
  ,
```
available
```
- ```
frozen
```
  ,
```
orderFrozen
```
  — 订单中冻结的资金
- ```
unrealizedPnl
```
  — 当前未实现盈亏
- ```
isolatedUnrealizedPnl
```
  — 逐仓持仓未实现盈亏

示例提问：

「我的BloFin账户余额是多少？」
「我有多少可用保证金？」
「展示我的未实现盈亏」

get_positions — Open Positions

get_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
```
— Instrument
```
positionSide
```
—
```
long
```
,
```
short
```
, or
```
net
```
```
positions
```
— Position size (contracts)
```
availablePositions
```
— Closeable position size
```
averagePrice
```
— Average entry price
```
unrealizedPnl
```
— Unrealized profit/loss
```
unrealizedPnlRatio
```
— PnL percentage
```
leverage
```
— Current leverage
```
marginMode
```
—
```
cross
```
or
```
isolated
```
```
liquidationPrice
```
— Estimated liquidation price
```
margin
```
— Position margin
```
markPrice
```
— 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?"

查看所有当前未平仓的持仓。

Use get_positions to see current open positions.

参数：

参数	类型	是否必填	说明
`instId`	字符串	否	按交易对筛选，例如 `BTC-USDT`

核心返回字段：

```
instId
```
— 交易对
```
positionSide
```
—
```
long
```
（做多）、
```
short
```
（做空）或
```
net
```
（净头寸）
```
positions
```
— 持仓数量（合约张数）
```
availablePositions
```
— 可平仓的持仓数量
```
averagePrice
```
— 平均入场价格
```
unrealizedPnl
```
— 未实现盈亏
```
unrealizedPnlRatio
```
— 盈亏百分比
```
leverage
```
— 当前杠杆
```
marginMode
```
—
```
cross
```
（全仓）或
```
isolated
```
（逐仓）
```
liquidationPrice
```
— 预估爆仓价格
```
margin
```
— 持仓保证金
```
markPrice
```
— 当前标记价格

示例提问：

「展示我所有未平仓持仓」
「我的BTC持仓情况如何？」
「我现在是盈利还是亏损？」
「我距离爆仓还有多远？」

get_leverage_info — View Leverage

get_leverage_info — 查看杠杆

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"

查询某个交易对当前的杠杆设置。

Use get_leverage_info to see the current leverage configuration.

参数：

参数	类型	是否必填	说明
`instId`	字符串	是	交易对ID，例如 `BTC-USDT`
`marginMode`	字符串	是	`cross` （全仓）或 `isolated` （逐仓）

示例提问：

「我BTC-USDT用的是多少倍杠杆？」
「展示我的杠杆设置」

set_leverage — Adjust Leverage

set_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?"

修改指定交易对的杠杆。

Use set_leverage to adjust leverage. Confirm with the user before applying changes.

参数：

参数	类型	是否必填	说明
`instId`	字符串	是	交易对ID，例如 `BTC-USDT`
`leverage`	字符串	是	杠杆数值，例如 `10`
`marginMode`	字符串	是	`cross` （全仓）或 `isolated` （逐仓）
`positionSide`	字符串	否	`long` （做多）或 `short` （做空）（适用于对冲模式）

重要限制：

最高杠杆数值因交易对而异（可通过
```
get_instruments
```
→
```
maxLeverage
```
查询）
存在未成交全仓订单时无法修改杠杆（错误码110006）
可能需要先取消未成交订单并平仓才能修改（错误码110019）

示例提问：

「把我的BTC-USDT杠杆设置为10倍」
「把我的ETH逐仓杠杆降到5倍」
「我用SOL-USDT最高可以开多少倍杠杆？」

get_margin_mode / set_margin_mode — Margin Mode

get_margin_mode / set_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?"

查看或切换全仓和逐仓保证金模式。

Use get_margin_mode / set_margin_mode to manage margin mode.
Always confirm with the user before switching margin mode.

set模式参数：

参数	类型	是否必填	说明
`instId`	字符串	是	交易对ID
`marginMode`	字符串	是	`cross` （全仓）或 `isolated` （逐仓）

保证金模式对比：

特性	全仓	逐仓
保证金共享	所有持仓共享	单个持仓独立
爆仓风险	所有持仓都会受影响	仅影响该逐仓持仓
资金利用率	更高	更低
风险控制	颗粒度较粗	颗粒度更细

示例提问：

「把BTC-USDT切换为逐仓保证金」
「我ETH用的是什么保证金模式？」

get_position_mode / set_position_mode — Position Mode

get_position_mode / set_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.

查看或切换单向和对冲持仓模式。

Use get_position_mode / set_position_mode to manage position mode.
Always confirm with the user before switching.

set模式参数：

参数	类型	是否必填	说明
`positionMode`	字符串	是	`long_short_mode` （对冲模式）或 `net_mode` （单向模式）

持仓模式对比：

模式	说明
`net_mode`	单向模式。每个交易对仅可持有一个方向的仓位。
`long_short_mode`	对冲模式。可同时持有做多和做空两个方向的仓位。

get_account_config — Account Configuration

get_account_config — 账户配置

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?"

获取整体账户配置设置。

Use get_account_config to review account settings.

示例提问：

「展示我的BloFin账户配置」
「我现在用的是什么持仓模式？」

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

修改杠杆、保证金模式或持仓模式前必须先获得用户确认
当杠杆设置高于20倍时需提醒爆仓风险
修改保证金模式前检查是否有未平仓持仓（存在持仓时操作可能失败）
展示持仓时需突出显示未实现盈亏——用户需要了解当前的风险敞口