Получить коэффициент скальпинга для тикера

GET/positions/{accountId}/{asset}/scalping-coefficient

Получить коэффициент скальпинга для тикераТорговля

Находится ли счёт в данный момент внутри окна скальпинга на этом рынке — периода после увеличения, в течение которого рынок взимает повышенный динамический спред.

amount — это множитель, применяемый внутри окна, а amountRegular — применяемый вне него; оба fp9.
activeSince и activeUntil возвращаются только пока окно работает; без недавнего увеличения они отсутствуют, и применяется обычный множитель.
recentVolume.long и recentVolume.short содержат накопленный объем после последнего исполненного открытия или увеличения в каждом направлении, в USD fp9 raw. Он исключает ордер, который вводится в данный момент, и добавляется к его размеру при расчете динамического влияния на цену.
У каждого направления есть свои updatedAt и activeUntil: объём линейно убывает до нуля за 60 секунд, независимо от окна скальпинга.
Направление равно null, когда его объём полностью восстановился или у него нет снимка динамического влияния на цену.

Базовый URL https://api.upscale.trade

Авторизация

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

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

Параметры

Путь

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

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

Пример: 00000000-0000-4000-8000-000000000000

assetstringобязательно

Тикер базового актива рынка, как возвращается GET /v2/markets.

Пример: BTC

Примеры

curl --request GET 'https://api.upscale.trade/positions/{accountId}/{asset}/scalping-coefficient' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch("https://api.upscale.trade/positions/{accountId}/{asset}/scalping-coefficient", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
});
console.log(response.status, await response.text());

import requests
 
response = requests.request(
    "GET",
    "https://api.upscale.trade/positions/{accountId}/{asset}/scalping-coefficient",
    headers={"Accept":"application/json","Authorization":"Bearer YOUR_API_KEY"},
    timeout=30,
)
print(response.status_code, response.text)

Ответы

401

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

403

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

404

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

429

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

defaultОтветapplication/json

activeSincestring · date-timeнеобязательно

Start of the running scalping window — the last increase on this market. Absent when no increase happened inside the window.

Пример: 2026-05-01T12:30:00.000Z

activeUntilstring · date-timeнеобязательно

End of the running scalping window. Absent together with activeSince.

Пример: 2026-05-01T12:30:00.000Z

amountstring · fp9обязательно

Spread multiplier charged while the window is running, fp9 raw (2000000000 = 2x).

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

amountRegularstring · fp9обязательно

Spread multiplier charged outside the window, fp9 raw (1000000000 = 1x).

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

recentVolumeobjectобязательно

Accumulated executed volume counted in the next open or increase, per direction, with its own recovery window; 60 seconds by default.

Объект · 2 поля

longobject · nullableобязательно

Recent long volume. Null when no volume remains in this direction.

Объект · 3 поля

volumestring · fp9обязательно

Volume right after the latest execution, USD fp9 raw. It decays linearly from updatedAt to zero at activeUntil.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

updatedAtstring · date-timeобязательно

Latest execution of an open or increase in this direction.

Пример: 2026-05-01T12:30:00.000Z

activeUntilstring · date-timeобязательно

Moment the volume decays to zero according to the trading recovery window; 60 seconds by default.

Пример: 2026-05-01T12:30:00.000Z

Посмотреть пример

{
  "volume": "1000000000",
  "updatedAt": "2026-05-01T12:30:00.000Z",
  "activeUntil": "2026-05-01T12:30:00.000Z"
}

shortobject · nullableобязательно

Recent short volume. Null when no volume remains in this direction.

Объект · 3 поля

volumestring · fp9обязательно

Volume right after the latest execution, USD fp9 raw. It decays linearly from updatedAt to zero at activeUntil.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

updatedAtstring · date-timeобязательно

Latest execution of an open or increase in this direction.

Пример: 2026-05-01T12:30:00.000Z

activeUntilstring · date-timeобязательно

Moment the volume decays to zero according to the trading recovery window; 60 seconds by default.

Пример: 2026-05-01T12:30:00.000Z

Посмотреть пример

{
  "volume": "1000000000",
  "updatedAt": "2026-05-01T12:30:00.000Z",
  "activeUntil": "2026-05-01T12:30:00.000Z"
}

Посмотреть пример

{
  "long": {
    "volume": "1000000000",
    "updatedAt": "2026-05-01T12:30:00.000Z",
    "activeUntil": "2026-05-01T12:30:00.000Z"
  },
  "short": {
    "volume": "1000000000",
    "updatedAt": "2026-05-01T12:30:00.000Z",
    "activeUntil": "2026-05-01T12:30:00.000Z"
  }
}

{
  "activeSince": "2026-05-01T12:30:00.000Z",
  "activeUntil": "2026-05-01T12:30:00.000Z",
  "amount": "1000000000",
  "amountRegular": "1000000000",
  "recentVolume": {
    "long": {
      "volume": "1000000000",
      "updatedAt": "2026-05-01T12:30:00.000Z",
      "activeUntil": "2026-05-01T12:30:00.000Z"
    },
    "short": {
      "volume": "1000000000",
      "updatedAt": "2026-05-01T12:30:00.000Z",
      "activeUntil": "2026-05-01T12:30:00.000Z"
    }
  }
}