blofin-trader

BloFin Trader

BloFin 取引所で取引を実行します。成行、指値、ポストオンリー、FOK、IOC 注文、バッチ操作、TP/SL、アルゴ注文／トリガー注文に対応しています。

重要：取引を行う前に、必ずユーザーに注文内容を確認してください。実行前に、銘柄、売買方向、数量、価格、推定コスト／証拠金を表示してください。

注文の基本

注文タイプ

タイプ	説明
market	利用可能な最良価格で即時に約定します
limit	指定価格またはそれより有利な価格で約定します
post_only	流動性を追加する場合のみ有効な指値注文（メイカー専用）です。即時にマッチする場合はキャンセルされます
fok	全量約定またはキャンセルです。即時に全量約定しなければキャンセルされます
ioc	即時約定またはキャンセルです。即時に約定可能な数量を約定し、残りはキャンセルされます

ポジションの売買方向

売買方向	ポジションの方向	アクション
buy	long	ロングを建てる／ショートを決済する
sell	short	ショートを建てる／ロングを決済する
buy	short	ショートを決済する（ヘッジモードの場合）
sell	long	ロングを決済する（ヘッジモードの場合）

数量とコントラクト価値

• 注文の size は、基準通貨ではなくコントラクト数です
• 各コントラクトには contractValue が設定されています（get_instruments で確認してください）
• 例：BTC-USDT のコントラクト価値は 0.001 BTC であるため、100 コントラクト = 0.1 BTC です
• 最小注文数量は minSize で定義されています（例：BTC-USDT では 0.1 コントラクト）
• 数量は lotSize の倍数である必要があります

利用可能なツール（blofin-mcp 経由）

place_order — 単一注文を発注する

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	条件付き	limit／post_only／fok／ioc 注文では必須
reduceOnly	Boolean	いいえ	true の場合、既存ポジションの縮小のみを行います
clientOrderId	String	いいえ	カスタム注文 ID（最大 32 文字）
tpTriggerPrice	String	いいえ	利益確定のトリガー価格
tpOrderPrice	String	いいえ	TP 注文価格（成行注文の場合は -1）
slTriggerPrice	String	いいえ	損切りのトリガー価格
slOrderPrice	String	いいえ	SL 注文価格（成行注文の場合は -1）
brokerId	String	いいえ	該当する場合のブローカー ID

プロンプトの例：

• 「BTC-USDT を成行で 1 コントラクト買って」
• 「ETH-USDT を 3,000 ドルで 10 枚買う指値注文を出して」
• 「100 コントラクトで BTC の 5 倍ロングポジションを建てて」
• 「ETH-USDT をショートして、4,000 ドルで損切りして」

注文前チェックリスト（発注前に必ず実行してください）：

1. 銘柄が存在し、取引可能であることを確認します（get_instruments）
2. ユーザーの残高が十分であることを確認します（get_balance）
3. 現在のレバレッジ設定を確認します（get_leverage_info）
4. 指値注文の場合、価格と現在の市場価格を比較します（get_tickers）
5. 推定コストを計算します：size * contractValue * price / leverage
6. 注文の概要を表示し、ユーザーから明示的な確認を得ます

---

cancel_order — 注文をキャンセルする

Use cancel_order to cancel a pending order.

パラメーター：

パラメーター	タイプ	必須	説明
instId	String	はい	銘柄 ID
orderId	String	条件付き	注文 ID（orderId または clientOrderId のいずれかが必須）
clientOrderId	String	条件付き	クライアント注文 ID

---

batch_orders — 複数の注文を発注する

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

バッチ内のすべての注文で、同じ instId と marginMode を指定する必要があります。

プロンプトの例：

• 「BTC-USDT の 60,000 ドルから 65,000 ドルまで、指値注文のグリッドを出して」
• 「ETH のロングポジションとショートポジションを両方建てて」

---

cancel_batch_orders — 複数の注文をキャンセルする

Use cancel_batch_orders to cancel multiple orders at once.

すべてのキャンセルで同じ識別子タイプを使用してください（orderId を推奨）。

---

close_position — ポジション全体を決済する

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 — 未約定注文を表示する

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 — 個別注文の詳細

Use get_order_detail to check the status of a specific order.

パラメーター：

パラメーター	型	必須	説明
instId	String	はい	商品 ID
orderId	String	条件付き	注文 ID
clientOrderId	String	条件付き	クライアント注文 ID

---

get_order_history — 過去の注文

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

---

利益確定／損切り（TP/SL）

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.

パラメーター：

パラメーター	型	必須	説明
instId	String	はい	商品 ID
marginMode	String	はい	cross または isolated
positionSide	String	はい	long、short、または net
tpTriggerPrice	String	条件付き	利益確定のトリガー価格
tpOrderPrice	String	いいえ	TP の執行価格（成行の場合は -1）
slTriggerPrice	String	条件付き	損切りのトリガー価格
slOrderPrice	String	いいえ	SL の執行価格（成行の場合は -1）
size	String	いいえ	決済する数量（デフォルト：ポジション全体）

TP/SL の検証ルール：

• ロングポジション：TP トリガーは現在価格より高く、SL トリガーは現在価格より低くします
• ショートポジション：TP トリガーは現在価格より低く、SL トリガーは現在価格より高くします
• 設定する前に、必ず現在の市場価格と照合してください

プロンプトの例：

• 「BTC のロングポジションに、70,000 ドルで利益確定、60,000 ドルで損切りを設定して」
• 「ETH のショートポジションに、3,200 ドルで損切りを追加して」

cancel_tpsl — TP/SL 注文をキャンセルする

Use cancel_tpsl to remove existing 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.

---

アルゴリズム／トリガー注文

place_algo_order — 条件付き／トリガー注文

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

アルゴリズム／トリガー注文を管理し、確認します。

---

安全ルール

1. ユーザーの明示的な確認なしに、決して注文を出さないでください — 必ず最初に概要を提示します
2. 売買方向（buy/sell）とポジション方向（long/short）を再確認します — 間違いは大きな損失につながります
3. 注文を出す前に、十分な残高があることを確認します
4. 明らかな誤りを避けるため、指値価格を現在の市場価格と照合します
5. 高レバレッジ注文について警告します — 清算リスクを明確に伝えます
6. 大口注文の場合、注文板の厚みを確認してスリッページを推定します
7. レート制限に注意：取引 API の上限は、ユーザーごとに 10 秒あたり 30 リクエストです