# Получить события позиции для индикаторов графика по тикеру

`GET /positions/{accountId}/{asset}/chart-events`

События позиции аккаунта на одном рынке внутри временного диапазона, сначала самые новые — маркеры, которые отрисовывает график.

- Возвращаются только увеличения, закрытия, принудительные закрытия и ликвидации; изменения финансирования и маржи не являются событиями графика.
- Диапазон задаётся в целых секундах через `executedFrom` и `executedTo`, обе границы включительно.
- Ограничено фазой, в которой аккаунт находится в данный момент.

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

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

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

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

## Параметры

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

Тип: string · uuid

format: uuid

pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

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

Тип: string

Пример: "BTC"

minLength: 1

- query: executedFrom (number; обязательно). Исполнено с, временная метка Unix в секундах (включительно)

Тип: number

Пример: 1735689600

- query: executedTo (number; обязательно). Исполнено по, временная метка Unix в секундах (включительно)

Тип: number

Пример: 1767225599

- query: limit (integer; необязательно). Размер страницы: сколько событий вернуть.

Тип: integer

Пример: 20

По умолчанию: 20

minimum: 1

maximum: 1000

- query: offset (integer; необязательно). Сколько событий пропустить перед страницей.

Тип: integer

Пример: 0

По умолчанию: 0

minimum: 0

maximum: 9007199254740991

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

## Пример · cURL

```bash
curl --request GET 'https://api.upscale.trade/positions/{accountId}/{asset}/chart-events' \
  --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}/chart-events", {
  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}/chart-events",
    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-charteventspaginatedresponse"></a>

## Ответ default · ChartEventsPaginatedResponse

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

Схема: ChartEventsPaginatedResponse

Тип: object

Обязательные поля: data, totalCount

Типы обязательных полей: data (object[]; обязательно), totalCount (number; обязательно)

- data (object[]; обязательно)

data пример: [
  {
    "asset": "BTC",
    "direction": "long",
    "eventName": "open",
    "executedAt": 1767225599,
    "price": "1000000000",
    "size": "1000000000"
  }
]

data.Тип: object[]

data.Запрошенная страница маркеров графика, сначала самые новые.

data.[]Тип: object

data.[]Обязательные поля: asset, direction, eventName, executedAt, price, size

data.[]Типы обязательных полей: asset (string; обязательно), direction (string · enum; обязательно), eventName (string · enum; обязательно), executedAt (number; обязательно), price (string · int32; обязательно), size (string · int32; обязательно)

- data.[]asset (string; обязательно)

data.[]asset пример: BTC

data.[]asset.Тип: string

data.[]asset.Тикер базового актива рынка, на котором произошло событие.

- data.[]direction (string · enum; обязательно)

data.[]direction пример: long

data.[]direction.Тип: string · enum

data.[]direction.Направление позиции, к которой относится событие.

data.[]direction.Допустимые значения: ["long","short"]

- data.[]eventName (string · enum; обязательно)

data.[]eventName пример: open

data.[]eventName.Тип: string · enum

data.[]eventName.Что обозначает маркер: `open` — для первого увеличения позиции, `increase` — для последующих, `decrease` — для частичного закрытия, `close` — для полного и `liquidation` — для ликвидации.

data.[]eventName.Допустимые значения: ["open","increase","decrease","close","liquidation"]

- data.[]executedAt (number; обязательно)

data.[]executedAt пример: 1767225599

data.[]executedAt.Тип: number

data.[]executedAt.Когда произошло событие, временная метка Unix в секундах.

- data.[]price (string · int32; обязательно)

data.[]price пример: 1000000000

data.[]price.Тип: string · int32

data.[]price.Цена, по которой было исполнено событие, fp9 в необработанном виде — обменённая сумма в котируемой валюте, делённая на обменённую сумму в базовом активе.

data.[]price.format: int32

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

- data.[]size (string · int32; обязательно)

data.[]size пример: 1000000000

data.[]size.Тип: string · int32

data.[]size.Абсолютный размер, перемещённый событием, в единицах базового актива, fp9 в необработанном виде.

data.[]size.format: int32

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

- totalCount (number; обязательно)

totalCount пример: 0

totalCount.Тип: number

totalCount.Общее количество событий в запрошенном диапазоне по всем страницам.

Пример



```json
{
  "data": [
    {
      "asset": "BTC",
      "direction": "long",
      "eventName": "open",
      "executedAt": 1767225599,
      "price": "1000000000",
      "size": "1000000000"
    }
  ],
  "totalCount": 0
}
```