# Blofin Trader

> Execute trades on BloFin exchange — place orders (market, limit, post_only, fok, ioc), cancel orders, batch operations, close positions, and manage TP/SL and algo/trigger orders. Requires authenticated API access with TRADE permission.

- Skill: `blofin/blofin-trader` (Agent Skill)
- Install (CLI): `npx skillmds@latest add blofin/blofin-trader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blofin/blofin-trader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: Apache-2.0
- Author: blofin (https://skillmd.com/u/blofin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blofin/blofin-trader

---


# 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.**

## 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 |

### 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) |

### 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`

## Available Tools (via blofin-mcp)

### place_order — Place a Single 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):**
1. Confirm instrument exists and is live (`get_instruments`)
2. Verify user has sufficient balance (`get_balance`)
3. Check current leverage setting (`get_leverage_info`)
4. For limit orders, compare price to current market (`get_tickers`)
5. Calculate estimated cost: `size * contractValue * price / leverage`
6. Display order summary and get explicit user confirmation

---

### cancel_order — Cancel an 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 |

---

### batch_orders — Place Multiple 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"

---

### cancel_batch_orders — Cancel Multiple Orders

```
Use cancel_batch_orders to cancel multiple orders at once.
```

All cancellations should use the same identifier type (prefer `orderId`).

---

### close_position — Close an Entire 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"

---

### get_open_orders — View Pending 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 |

---

### get_order_detail — Single Order Details

```
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 |

---

### get_order_history — Past Orders

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

---

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

### place_tpsl — Attach TP/SL to a Position

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

### cancel_tpsl — Cancel TP/SL Orders

```
Use cancel_tpsl to remove existing TP/SL orders.
```

### get_pending_tpsl / get_tpsl_history — View 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

```
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 |

### cancel_algo_order / get_pending_algo_orders / get_algo_order_history

Manage and review algo/trigger orders.

---

## Safety Rules

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