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

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

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

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

<a id="authorization"></a>

## Авторизация

bearer: http · bearer (обязательно). Персональный API-ключ с префиксом `usk_`.

<a id="parameters"></a>

## Параметры

- path: accountId (string · uuid; обязательно). Идентификатор торгового аккаунта. Должен принадлежать вызывающей стороне.

Тип: string · uuid

format: uuid

- path: asset (string; обязательно). Тикер базового актива рынка, как возвращается `GET /v2/markets`.

Тип: string

Пример: "BTC"

<a id="example-curl"></a>

## Пример · cURL

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

<a id="example-javascript"></a>

## Пример · JavaScript

```javascript
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());
```

<a id="example-python"></a>

## Пример · Python

```python
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)
```

<a id="response-401"></a>

## Ответ 401

**401**  — Неавторизовано

<a id="response-403"></a>

## Ответ 403

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

<a id="response-404"></a>

## Ответ 404

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

<a id="response-429"></a>

## Ответ 429

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

<a id="response-default-positionopennotionalresponse"></a>

## Ответ default · PositionOpenNotionalResponse

**default** application/json — Ответ

Схема: PositionOpenNotionalResponse

Тип: object

Обязательные поля: openNotionalLong, openNotionalShort

Типы обязательных полей: openNotionalLong (string · int32; обязательно), openNotionalShort (string · int32; обязательно)

- openNotionalLong (string · int32; обязательно)

openNotionalLong пример: 1000000000

openNotionalLong.Тип: string · int32

openNotionalLong.Открытый номинал, который аккаунт держит в лонг на этом рынке, суммированный по позициям, fp9 в сыром виде.

openNotionalLong.format: int32

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

- openNotionalShort (string · int32; обязательно)

openNotionalShort пример: 1000000000

openNotionalShort.Тип: string · int32

openNotionalShort.Открытый номинал, который аккаунт держит в короткой позиции на этом рынке, суммированный по позициям, fp9 в сыром виде.

openNotionalShort.format: int32

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

Пример



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