blofin-trader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

BloFin Trader

Execute trades on BloFin exchange. Supports market, limit, post-only, FOK, IOC orders, batch operations, TP/SL, and algo/trigger orders.

CRITICAL: Always confirm order details with the user before placing any trade. Display the instrument, side, size, price, and estimated cost/margin before execution.

在BloFin交易所执行交易。支持市价、限价、post-only、FOK、IOC订单、批量操作、TP/SL以及算法/触发订单。

重要提示：下单前务必与用户确认订单详情。执行前请展示交易对、方向、数量、价格以及预估成本/保证金。

Order Basics

订单基础

Order Types

订单类型

Type	Description
`market`	Execute immediately at best available price
`limit`	Execute at specified price or better
`post_only`	Limit order that only adds liquidity (maker only); cancelled if it would match immediately
`fok`	Fill or Kill — must fill entirely immediately or cancel
`ioc`	Immediate or Cancel — fill what's possible immediately, cancel the rest

类型	说明
`market`	以当前最优价格立即成交
`limit`	以指定价格或更优价格成交
`post_only`	仅提供流动性的限价单（仅maker）；若会立即成交则自动取消
`fok`	Fill or Kill（全数成交或取消）——必须立即全部成交，否则直接取消
`ioc`	Immediate or Cancel（即时成交剩余撤销）——立即成交可成交部分，剩余部分取消

Position Sides

持仓方向

Side	Position Side	Action
`buy`	`long`	Open long / close short
`sell`	`short`	Open short / close long
`buy`	`short`	Close short (in hedge mode)
`sell`	`long`	Close long (in hedge mode)

操作方向	持仓方向	动作
`buy`	`long`	开多 / 平空
`sell`	`short`	开空 / 平多
`buy`	`short`	平空（对冲模式下）
`sell`	`long`	平多（对冲模式下）

Size & Contract Value

数量与合约价值

Order
```
size
```
is in contracts, not in base currency
Each contract has a
```
contractValue
```
(check via
```
get_instruments
```
)
Example: BTC-USDT contract value is 0.001 BTC, so 100 contracts = 0.1 BTC
Minimum order size is defined by
```
minSize
```
(e.g., 0.1 contracts for BTC-USDT)
Size must be a multiple of
```
lotSize
```

订单
```
size
```
以合约张数为单位，而非基础货币
每张合约对应固定的
```
contractValue
```
（可通过
```
get_instruments
```
查询）
示例：BTC-USDT合约价值为0.001 BTC，因此100张合约 = 0.1 BTC
最小下单数量由
```
minSize
```
定义（例如BTC-USDT最小下单量为0.1张）
下单数量必须是
```
lotSize
```
的整数倍

Available Tools (via blofin-mcp)

可用工具（通过blofin-mcp）

place_order — Place a Single Order

place_order — 单笔下单

Use place_order to submit a new trade. ALWAYS confirm with the user first.

Parameters:

Parameter	Type	Required	Description
`instId`	String	Yes	Instrument ID, e.g. `BTC-USDT`
`marginMode`	String	Yes	`cross` or `isolated`
`positionSide`	String	Yes	`long` , `short` , or `net`
`side`	String	Yes	`buy` or `sell`
`orderType`	String	Yes	`market` , `limit` , `post_only` , `fok` , `ioc`
`size`	String	Yes	Order size in contracts
`price`	String	Conditional	Required for limit/post_only/fok/ioc orders
`reduceOnly`	Boolean	No	If true, only reduces existing position
`clientOrderId`	String	No	Custom order ID (max 32 chars)
`tpTriggerPrice`	String	No	Take-profit trigger price
`tpOrderPrice`	String	No	TP order price (-1 for market)
`slTriggerPrice`	String	No	Stop-loss trigger price
`slOrderPrice`	String	No	SL order price (-1 for market)
`brokerId`	String	No	Broker ID if applicable

Example prompts:

"Buy 1 BTC-USDT contract at market price"
"Place a limit buy for 10 ETH-USDT at $3,000"
"Open a 5x long BTC position with 100 contracts"
"Short ETH-USDT with a stop loss at $4,000"

Pre-order checklist (always do this before placing):

Confirm instrument exists and is live (
```
get_instruments
```
)
Verify user has sufficient balance (
```
get_balance
```
)
Check current leverage setting (
```
get_leverage_info
```
)
For limit orders, compare price to current market (
```
get_tickers
```
)
Calculate estimated cost:
```
size * contractValue * price / leverage
```
Display order summary and get explicit user confirmation

Use place_order to submit a new trade. ALWAYS confirm with the user first.

参数：

参数	类型	必填	说明
`instId`	String	是	交易对ID，例如 `BTC-USDT`
`marginMode`	String	是	`cross` （全仓）或 `isolated` （逐仓）
`positionSide`	String	是	`long` 、 `short` 或 `net` （净头寸）
`side`	String	是	`buy` 或 `sell`
`orderType`	String	是	`market` 、 `limit` 、 `post_only` 、 `fok` 、 `ioc`
`size`	String	是	下单数量（单位：合约张数）
`price`	String	条件必填	限价/post_only/fok/ioc订单必填
`reduceOnly`	Boolean	否	若为true，仅减少现有持仓
`clientOrderId`	String	否	自定义订单ID（最多32个字符）
`tpTriggerPrice`	String	否	止盈触发价格
`tpOrderPrice`	String	否	止盈委托价格（-1代表市价）
`slTriggerPrice`	String	否	止损触发价格
`slOrderPrice`	String	否	止损委托价格（-1代表市价）
`brokerId`	String	否	经纪商ID（如有）

示例指令：

"以市价买入1张BTC-USDT合约"
"以3000美元的价格限价买入10张ETH-USDT"
"开5倍杠杆BTC多仓，数量100张"
"做空ETH-USDT，止损设在4000美元"

下单前检查清单（下单前必须完成）：

确认交易对存在且可交易（
```
get_instruments
```
）
验证用户余额充足（
```
get_balance
```
）
检查当前杠杆设置（
```
get_leverage_info
```
）
限价单需对比当前市场价格（
```
get_tickers
```
）
计算预估成本：
```
size * contractValue * price / leverage
```
展示订单摘要并获得用户明确确认

cancel_order — Cancel an Order

cancel_order — 取消订单

Use cancel_order to cancel a pending order.

Parameters:

Parameter	Type	Required	Description
`instId`	String	Yes	Instrument ID
`orderId`	String	Conditional	Order ID (either orderId or clientOrderId required)
`clientOrderId`	String	Conditional	Client order ID

Use cancel_order to cancel a pending order.

参数：

参数	类型	必填	说明
`instId`	String	是	交易对ID
`orderId`	String	条件必填	订单ID（orderId和clientOrderId二选一）
`clientOrderId`	String	条件必填	客户端自定义订单ID

batch_orders — Place Multiple Orders

batch_orders — 批量下单

Use batch_orders for placing multiple orders at once. Max 20 orders per batch.

All orders in a batch must share the same

instId

and

marginMode

Example prompts:

"Place a grid of limit orders for BTC-USDT from $60,000 to $65,000"
"Open both a long and short position on ETH"

Use batch_orders for placing multiple orders at once. Max 20 orders per batch.

同一批次的所有订单必须使用相同的

instId

和

marginMode

。

示例指令：

"为BTC-USDT在60000美元到65000美元区间下网格限价单"
"同时开ETH的多仓和空仓"

cancel_batch_orders — Cancel Multiple Orders

cancel_batch_orders — 批量取消订单

Use cancel_batch_orders to cancel multiple orders at once.

All cancellations should use the same identifier type (prefer

orderId

Use cancel_batch_orders to cancel multiple orders at once.

所有取消操作需使用相同的标识类型（优先使用

orderId

）。

close_position — Close an Entire Position

close_position — 全额平仓

Use close_position to close a full position on an instrument. Confirm with the user first.

Parameters:

Parameter	Type	Required	Description
`instId`	String	Yes	Instrument ID
`marginMode`	String	Yes	`cross` or `isolated`
`positionSide`	String	No	`long` , `short` , or `net`
`clientOrderId`	String	No	Custom order ID

Example prompts:

"Close my BTC-USDT long position"
"Close all my ETH positions"

Use close_position to close a full position on an instrument. Confirm with the user first.

参数：

参数	类型	必填	说明
`instId`	String	是	交易对ID
`marginMode`	String	是	`cross` 或 `isolated`
`positionSide`	String	否	`long` 、 `short` 或 `net`
`clientOrderId`	String	否	自定义订单ID

示例指令：

"平掉我的BTC-USDT多仓"
"平掉我所有的ETH持仓"

get_open_orders — View Pending Orders

get_open_orders — 查询挂单

Use get_open_orders to see unfilled or partially filled orders.

Parameters:

Parameter	Type	Required	Description
`instId`	String	No	Filter by instrument
`orderType`	String	No	Filter by order type
`state`	String	No	`live` or `partially_filled`
`before` / `after`	String	No	Pagination by orderId
`limit`	String	No	Max 100, default 100

Use get_open_orders to see unfilled or partially filled orders.

参数：

参数	类型	必填	说明
`instId`	String	否	按交易对筛选
`orderType`	String	否	按订单类型筛选
`state`	String	否	`live` （未成交）或 `partially_filled` （部分成交）
`before` / `after`	String	否	按orderId分页
`limit`	String	否	最多100条，默认100条

get_order_detail — Single Order Details

get_order_detail — 查询单笔订单详情

Use get_order_detail to check the status of a specific order.

Parameters:

Parameter	Type	Required	Description
`instId`	String	Yes	Instrument ID
`orderId`	String	Conditional	Order ID
`clientOrderId`	String	Conditional	Client order ID

Use get_order_detail to check the status of a specific order.

参数：

参数	类型	必填	说明
`instId`	String	是	交易对ID
`orderId`	String	条件必填	订单ID
`clientOrderId`	String	条件必填	客户端自定义订单ID

get_order_history — Past Orders

get_order_history — 查询历史订单

Use get_order_history to review filled, cancelled, or expired orders.

Use get_order_history to review filled, cancelled, or expired orders.

Take-Profit / Stop-Loss (TP/SL)

止盈/止损（TP/SL）

place_tpsl — Attach TP/SL to a Position

place_tpsl — 为持仓添加TP/SL

Use place_tpsl to set take-profit and/or stop-loss on an existing position.
Always confirm trigger prices with the user.

Parameters:

Parameter	Type	Required	Description
`instId`	String	Yes	Instrument ID
`marginMode`	String	Yes	`cross` or `isolated`
`positionSide`	String	Yes	`long` , `short` , or `net`
`tpTriggerPrice`	String	Conditional	Take-profit trigger price
`tpOrderPrice`	String	No	TP execution price (-1 for market)
`slTriggerPrice`	String	Conditional	Stop-loss trigger price
`slOrderPrice`	String	No	SL execution price (-1 for market)
`size`	String	No	Size to close (default: full position)

TP/SL validation rules:

Long position: TP trigger > current price, SL trigger < current price
Short position: TP trigger < current price, SL trigger > current price
Always verify against current market price before placing

Example prompts:

"Set a take profit at $70,000 and stop loss at $60,000 for my BTC long"
"Add a stop loss at $3,200 for my ETH short"

Use place_tpsl to set take-profit and/or stop-loss on an existing position.
Always confirm trigger prices with the user.

参数：

参数	类型	必填	说明
`instId`	String	是	交易对ID
`marginMode`	String	是	`cross` 或 `isolated`
`positionSide`	String	是	`long` 、 `short` 或 `net`
`tpTriggerPrice`	String	条件必填	止盈触发价格
`tpOrderPrice`	String	否	止盈执行价格（-1代表市价）
`slTriggerPrice`	String	条件必填	止损触发价格
`slOrderPrice`	String	否	止损执行价格（-1代表市价）
`size`	String	否	平仓数量（默认：全额持仓）

TP/SL校验规则：

多仓：止盈触发价 > 当前价格，止损触发价 < 当前价格
空仓：止盈触发价 < 当前价格，止损触发价 > 当前价格
下单前务必对照当前市场价进行校验

示例指令：

"为我的BTC多仓设置70000美元止盈，60000美元止损"
"为我的ETH空仓添加3200美元的止损"

cancel_tpsl — Cancel TP/SL Orders

cancel_tpsl — 取消TP/SL订单

Use cancel_tpsl to remove existing TP/SL orders.

Use cancel_tpsl to remove existing TP/SL orders.

get_pending_tpsl / get_tpsl_history — View TP/SL Orders

get_pending_tpsl / get_tpsl_history — 查询TP/SL订单

Use get_pending_tpsl to see active TP/SL orders.
Use get_tpsl_history to review past TP/SL orders.

Use get_pending_tpsl to see active TP/SL orders.
Use get_tpsl_history to review past TP/SL orders.

Algo / Trigger Orders

算法/触发订单

place_algo_order — Conditional/Trigger Orders

place_algo_order — 条件/触发订单

Use place_algo_order for trigger-based orders that execute when a condition is met.

Parameters:

Parameter	Type	Required	Description
`instId`	String	Yes	Instrument ID
`marginMode`	String	Yes	`cross` or `isolated`
`positionSide`	String	Yes	`long` , `short` , or `net`
`side`	String	Yes	`buy` or `sell`
`orderType`	String	Yes	Order type for execution
`size`	String	Yes	Size in contracts
`triggerPrice`	String	Yes	Price that triggers the order
`orderPrice`	String	Conditional	Execution price (required for limit)
`reduceOnly`	Boolean	No	Only reduces position

Use place_algo_order for trigger-based orders that execute when a condition is met.

参数：

参数	类型	必填	说明
`instId`	String	是	交易对ID
`marginMode`	String	是	`cross` 或 `isolated`
`positionSide`	String	是	`long` 、 `short` 或 `net`
`side`	String	是	`buy` 或 `sell`
`orderType`	String	是	执行时的订单类型
`size`	String	是	合约数量
`triggerPrice`	String	是	触发订单的价格
`orderPrice`	String	条件必填	执行价格（限价单必填）
`reduceOnly`	Boolean	否	仅减少持仓

cancel_algo_order / get_pending_algo_orders / get_algo_order_history

Manage and review algo/trigger orders.

管理和查询算法/触发订单。

Safety Rules

安全规则

NEVER place an order without explicit user confirmation — always show a summary first
Double-check the side (buy/sell) and position side (long/short) — mistakes are costly
Verify sufficient balance before placing orders
Validate limit prices against current market to avoid obvious errors
Warn about high-leverage orders — clearly state the liquidation risk
For large orders, check order book depth to estimate slippage
Rate limit awareness: Trading APIs are limited to 30 requests per 10 seconds per user

未获得用户明确确认前绝对不要下单——务必先展示订单摘要
反复核对操作方向（buy/sell）和持仓方向（long/short）——失误代价极高
下单前验证余额充足
对照当前市场价校验限价，避免明显错误
高杠杆订单需给出风险提示——明确说明爆仓风险
大额订单需查询订单薄深度，预估滑点
注意频率限制： 交易API限制每个用户每10秒最多发起30次请求