Получить текущий открытый интерес по тикеру

GET/positions/{accountId}/{asset}/open-notional

Получить текущий открытый интерес по тикеруТорговля

Открытый номинал, который аккаунт в настоящее время держит на одном рынке, суммированный по направлению, fp9 в сыром виде.

Полезно перед определением размера увеличения: рынок ограничивает открытый номинал по направлению, а ордер, который превысил бы лимит, отклоняется с order_exceeds_max_open_notional.

Базовый 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}/open-notional' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch("https://api.upscale.trade/positions/{accountId}/{asset}/open-notional", {
  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}/open-notional",
    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

openNotionalLongstring · int32обязательно

Open notional the account holds long on this market, summed across positions, fp9 raw.

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

Пример: 1000000000

openNotionalShortstring · int32обязательно

Open notional the account holds short on this market, summed across positions, fp9 raw.

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

Пример: 1000000000

{
  "openNotionalLong": "1000000000",
  "openNotionalShort": "1000000000"
}