# Obtener eventos de posición para indicadores de gráfico por ticker
`GET /positions/{accountId}/{asset}/chart-events`
Eventos de posición de la cuenta en un mercado dentro de un rango de tiempo, los más recientes primero — los marcadores que dibuja un gráfico.
- Solo se devuelven aumentos, cierres, cierres forzosos y liquidaciones; los cambios de financiación y margen no son eventos de gráfico.
- El rango se da en segundos enteros mediante `executedFrom` y `executedTo`, ambos inclusive.
- Limitado a la fase en la que se encuentra actualmente la cuenta.
## Autorización
bearer: http · bearer (obligatorio). Clave de API personal, con el prefijo `usk_`.
## Parámetros
- path: accountId (string · uuid; obligatorio). Identificador de la cuenta del trader. Debe pertenecer al solicitante.
Tipo: 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; obligatorio). Ticker del activo base del mercado, tal como lo devuelve `GET /v2/markets`.
Tipo: string
Ejemplo: "BTC"
minLength: 1
- query: executedFrom (number; obligatorio). Ejecutado desde, marca de tiempo Unix en segundos (inclusive)
Tipo: number
Ejemplo: 1735689600
- query: executedTo (number; obligatorio). Ejecutado hasta, marca de tiempo Unix en segundos (inclusive)
Tipo: number
Ejemplo: 1767225599
- query: limit (integer; opcional). Tamaño de página: cuántos eventos devolver.
Tipo: integer
Ejemplo: 20
Predeterminado: 20
minimum: 1
maximum: 1000
- query: offset (integer; opcional). Cuántos eventos omitir antes de la página.
Tipo: integer
Ejemplo: 0
Predeterminado: 0
minimum: 0
maximum: 9007199254740991
## Ejemplo · cURL
```bash
curl --request GET 'https://api.upscale.trade/positions/{accountId}/{asset}/chart-events' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
## Ejemplo · 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());
```
## Ejemplo · 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)
```
## Respuesta 401
**401** — No autorizado
## Respuesta 403
**403** — La cuenta pertenece a otro usuario (`account_access_denied`), o la solicitud se autentica con una clave de API mientras `api_trading` está deshabilitado en la cuenta (`api_trading_not_enabled`).
## Respuesta 404
**404** — No hay ninguna cuenta con este identificador, o no hay ningún mercado para este ticker.
## Respuesta 429
**429** — Se superó el límite de velocidad de la clave de API (`api_key_rate_limit_exceeded`). `Retry-After` indica cuándo volver; el cuerpo incluye el bucket (`read` / `write`), la ventana que se activó, su límite y `retryAt`.
## Respuesta default · ChartEventsPaginatedResponse
**default** application/json — Respuesta
Esquema: ChartEventsPaginatedResponse
Tipo: object
Campos obligatorios: data, totalCount
Tipos de campos obligatorios: data (object[]; obligatorio), totalCount (number; obligatorio)
- data (object[]; obligatorio)
data ejemplo: [
{
"asset": "BTC",
"direction": "long",
"eventName": "open",
"executedAt": 1767225599,
"price": "1000000000",
"size": "1000000000"
}
]
data.Tipo: object[]
data.Página solicitada de marcadores del gráfico, los más recientes primero.
data.[]Tipo: object
data.[]Campos obligatorios: asset, direction, eventName, executedAt, price, size
data.[]Tipos de campos obligatorios: asset (string; obligatorio), direction (string · enum; obligatorio), eventName (string · enum; obligatorio), executedAt (number; obligatorio), price (string · int32; obligatorio), size (string · int32; obligatorio)
- data.[]asset (string; obligatorio)
data.[]asset ejemplo: BTC
data.[]asset.Tipo: string
data.[]asset.Ticker del activo base del mercado en el que ocurrió el evento.
- data.[]direction (string · enum; obligatorio)
data.[]direction ejemplo: long
data.[]direction.Tipo: string · enum
data.[]direction.Dirección de la posición a la que pertenece el evento.
data.[]direction.Valores permitidos: ["long","short"]
- data.[]eventName (string · enum; obligatorio)
data.[]eventName ejemplo: open
data.[]eventName.Tipo: string · enum
data.[]eventName.Qué representa el marcador: `open` para el primer aumento de una posición, `increase` para los posteriores, `decrease` para un cierre parcial, `close` para un cierre total y `liquidation` para una liquidación.
data.[]eventName.Valores permitidos: ["open","increase","decrease","close","liquidation"]
- data.[]executedAt (number; obligatorio)
data.[]executedAt ejemplo: 1767225599
data.[]executedAt.Tipo: number
data.[]executedAt.Cuándo ocurrió el evento, marca de tiempo unix en segundos.
- data.[]price (string · int32; obligatorio)
data.[]price ejemplo: 1000000000
data.[]price.Tipo: string · int32
data.[]price.Precio al que se ejecutó el evento, fp9 en bruto — cotización intercambiada sobre base intercambiada.
data.[]price.format: int32
data.[]price.pattern: ^(?:-?[1-9][0-9]*|0)$
- data.[]size (string · int32; obligatorio)
data.[]size ejemplo: 1000000000
data.[]size.Tipo: string · int32
data.[]size.Tamaño absoluto que movió el evento, en unidades del activo base, fp9 en bruto.
data.[]size.format: int32
data.[]size.pattern: ^(?:-?[1-9][0-9]*|0)$
- totalCount (number; obligatorio)
totalCount ejemplo: 0
totalCount.Tipo: number
totalCount.Número total de eventos en el rango solicitado, en todas las páginas.
Ejemplo
```json
{
"data": [
{
"asset": "BTC",
"direction": "long",
"eventName": "open",
"executedAt": 1767225599,
"price": "1000000000",
"size": "1000000000"
}
],
"totalCount": 0
}
```