CLOSEPOSITION

8.18.0

Описание

Экшн для закрытия открытых позиций на фьючерсном рынке. Позволяет закрыть полностью или частично позицию по рыночной или лимитной цене.

Поддерживаемые рынки

• ❌ Spot (спот)

• ✅ Futures (фьючерсы)

Алиасы

• EXIT

• EXITPOSITION

Синтаксис

action=closeposition;symbol=SYMBOL[;дополнительные_параметры]

Сокращенная запись:

closeposition=SYMBOL[;дополнительные_параметры]
exit=SYMBOL[;дополнительные_параметры]

Обязательные параметры

symbol

Торговый символ позиции для закрытия

symbol=BTCUSDT

mktype

Тип рынка (всегда futures)

mktype=futures

Дополнительные параметры

closepro

Процент позиции для закрытия (по умолчанию 100%)

closepro=50        # закрыть 50% позиции
closepro=100       # закрыть всю позицию

price

Лимитная цена для закрытия (по умолчанию рыночная)

price=30000        # закрыть по цене 30000

type

Тип ордера для закрытия

type=MARKET        # рыночный ордер (по умолчанию)
type=LIMIT         # лимитный ордер

positionside

Для режима хеджирования

positionside=long     # закрыть long позицию
positionside=short    # закрыть short позицию

Параметры количества

Подробнее о формировании количества Детальную информацию о всех способах указания количества см. в разделе Формирование количества

Абсолютное количество:

qty=0.5            # закрыть точно 0.5 единицы

Процентное количество:

closepro=50        # закрыть 50% позиции (по умолчанию 100%)

clientid

Пользовательский ID для ордера закрытия

clientid=close_order_123

Примеры использования

Полное закрытие позиции по рынку

action=closeposition;symbol=BTCUSDT;mktype=futures
closeposition=BTCUSDT;mktype=futures
exit=BTCUSDT;mktype=futures

Частичное закрытие позиции

action=closeposition;symbol=ETHUSDT;closepro=50;mktype=futures
closeposition=ETHUSDT;closepro=30;mktype=futures

Закрытие по лимитной цене

action=closeposition;symbol=BTCUSDT;price=31000;type=LIMIT;mktype=futures
closeposition=BTCUSDT;price=31000;mktype=futures

Закрытие конкретного количества

action=closeposition;symbol=ETHUSDT;qty=1.5;mktype=futures
closeposition=ETHUSDT;qty=0.8;mktype=futures

В режиме хеджирования

action=closeposition;symbol=BTCUSDT;positionside=long;mktype=futures
closeposition=BTCUSDT;positionside=short;closepro=75;mktype=futures

С пользовательским ID

action=closeposition;symbol=ADAUSDT;clientid=emergency_exit;mktype=futures
closeposition=ADAUSDT;clientid=profit_taking;mktype=futures

В составе сцепки команд

action=closeposition;symbol=BTCUSDT;mktype=futures::action=openposition;symbol=ETHUSDT;side=BUY;openpro=100;mktype=futures

Закрывает позицию по Bitcoin, затем открывает позицию по Ethereum

Особенности

Сокращенная запись Поддерживает алиасы exit, closeposition и exitposition

Только фьючерсы Экшн работает только с фьючерсными позициями

Автоматическое определение стороны Система автоматически определяет сторону для закрытия на основе текущей позиции

Проверка позиции Если позиция уже закрыта или отсутствует, будет возвращена ошибка

Рыночное исполнение По умолчанию использует рыночные ордера для быстрого закрытия

Результат выполнения

Возвращает подтверждение закрытия позиции с деталями исполненного ордера.

Связанные экшены

• OPENPOSITION - открытие новых позиций

• EXITALLPOSITIONS - закрытие всех позиций

• NEWORDER - создание ордеров

• CANCELORDER - отмена ордеров