Close Position

writes · destructive

オープン中の取引ポジションをクローズします(全決済または部分決済)。

ポジションをクローズするために反対方向の成行注文を送信します。反対サイドはポジションから自動的に推測されます(sideパラメータは指定しないでください)。

PARAMETERS:

• positionId: get_positionsレスポンスから取得したポジションID(必須)
• volume: 任意の部分決済数量(単位)
  • 省略するとポジション全体をクローズ
  • 指定すると部分決済(例: 100000単位ポジションの半分をクローズするには volume=50000)
  • 現在のポジション数量を超えてはいけません
• comment: 決済注文用の任意のコメント/ラベル

動作:

• ポジションがLONG(BUY)の場合、SELL成行注文を送信
• ポジションがSHORT(SELL)の場合、BUY成行注文を送信
• サイドは自動的に推測されます — LLMにサイドを尋ねないでください
• 成行注文は最良価格で即時執行されます
• リスクチェックが適用されます(レート制限、キルスイッチなど)

全決済 vs 部分決済:

• 全決済: volumeパラメータを省略すると、ポジション全体がクローズされます
• 部分決済: ポジション数量未満のvolumeを指定すると、残りのポジションはオープンのままになります

成功時は確定損益を含む執行詳細を返します。

⚠️ 部分決済の場合、数量計算を確認してください: UNITSで指定し、ポジション数量以下である必要があります。

パラメータ

パラメータ	型	必須	説明
positionId	string	はい	クローズするポジションID(get_positionsレスポンスから取得)
volume	number	いいえ	任意の部分決済数量(UNITS)。省略するとポジション全体をクローズ。ポジション数量を超えてはいけません。ロットサイズが小さい銘柄では小数値も可。
comment	string	いいえ	決済注文用の任意のコメント