Upscale
Menu
On this page

Закрыть все позиции и ордера

Попробовать ↓
POST/accounts/{accountId}/close-all
Закрыть все позиции и ордераАккаунты

Отменяет каждый активный ордер на счёте, а затем закрывает каждую открытую позицию по рынку.

  • Отвечает 204 без тела; возникшие исполнения появляются в истории позиций и в событиях счёта.
  • Отправьте заголовок x-idempotency-key, чтобы сделать вызов безопасным при повторной отправке: в пределах окна повторной отправки, указанного в этом заголовке, тот же ключ на том же маршруте воспроизводит сохранённый ответ (помеченный X-Idempotency-Cached: true и X-Idempotency-Timestamp) вместо повторного выполнения, а второй вызов, поступивший, пока первый всё ещё выполняется, получает 409 (idempotency_key_in_flight).
Базовый URL https://api.upscale.trade

Авторизация

bearerhttp · bearerобязательно

Персональный API-ключ с префиксом usk_.

Параметры

Путь
accountIdstring · uuidобязательно

Идентификатор торгового аккаунта. Должен принадлежать вызывающей стороне.

Пример: 00000000-0000-4000-8000-000000000000
Заголовок
x-idempotency-keystringнеобязательно

Ключ идемпотентности — любая непрозрачная строка, uuid v4 хорошо подходит. Повторение вызова с тем же ключом на этом маршруте в течение 1 минуты воспроизводит сохранённый ответ вместо повторного выполнения; повторное воспроизведение содержит X-Idempotency-Cached: true и X-Idempotency-Timestamp. Пропустите заголовок, чтобы отказаться.

Пример: 9f1c2b7e-5a3d-4f61-9b0e-2c7d4a8e1f35

Примеры

curl --request POST 'https://api.upscale.trade/accounts/{accountId}/close-all' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Ответы

401

Неавторизовано

403

Аккаунт принадлежит другому пользователю (account_access_denied), или запрос аутентифицирован с помощью API-ключа, тогда как api_trading отключён на аккаунте (api_trading_not_enabled).

404

Нет аккаунта с этим идентификатором.

409

Другой вызов с тем же x-idempotency-key всё ещё выполняется (idempotency_key_in_flight). Повторите попытку, когда он завершится.

429

Превышен лимит частоты запросов API-ключа (api_key_rate_limit_exceeded). Retry-After указывает, когда вернуться; тело содержит бакет (read / write), окно, которое сработало, его лимит и retryAt.