# Obtener el coeficiente de scalping para el ticker

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

Si la cuenta está actualmente dentro de la ventana de scalping en este mercado — el período posterior a un aumento durante el cual el mercado cobra el spread dinámico elevado.

- `amount` es el multiplicador aplicado dentro de la ventana y `amountRegular` el aplicado fuera de ella, ambos fp9.
- `activeSince` y `activeUntil` se devuelven solo mientras la ventana está activa; sin un aumento reciente, están ausentes y se aplica el multiplicador regular.

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

## Autorización

bearer: http · bearer (obligatorio). Clave de API personal, con el prefijo `usk_`.

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

## Parámetros

- path: accountId (string · uuid; obligatorio). Identificador de la cuenta del trader. Debe pertenecer al solicitante.

Tipo: string · uuid

format: uuid

- path: asset (string; obligatorio). Ticker del activo base del mercado, tal como lo devuelve `GET /v2/markets`.

Tipo: string

Ejemplo: "BTC"

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

## Ejemplo · cURL

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

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

## Ejemplo · JavaScript

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

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

## Ejemplo · Python

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

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

## Respuesta 401

**401**  — No autorizado

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

## 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`).

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

## Respuesta 404

**404**  — No hay ninguna cuenta con este identificador, o no hay ningún mercado para este ticker.

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

## 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`.

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

## Respuesta default · ScalpingCoefficientResponse

**default** application/json — Respuesta

Esquema: ScalpingCoefficientResponse

Tipo: object

Campos obligatorios: amount, amountRegular

Tipos de campos obligatorios: amount (string · int32; obligatorio), amountRegular (string · int32; obligatorio)

- activeSince (string · date-time; opcional)

activeSince ejemplo: 2026-05-01T12:30:00.000Z

activeSince.Tipo: string · date-time

activeSince.Inicio de la ventana de scalping activa — el último aumento en este mercado. Ausente cuando no ocurrió ningún aumento dentro de la ventana.

activeSince.format: date-time

- activeUntil (string · date-time; opcional)

activeUntil ejemplo: 2026-05-01T12:30:00.000Z

activeUntil.Tipo: string · date-time

activeUntil.Fin de la ventana de scalping activa. Ausente junto con `activeSince`.

activeUntil.format: date-time

- amount (string · int32; obligatorio)

amount ejemplo: 1000000000

amount.Tipo: string · int32

amount.Multiplicador de spread aplicado mientras la ventana está en ejecución, fp9 sin procesar (`2000000000` = 2x).

amount.format: int32

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

- amountRegular (string · int32; obligatorio)

amountRegular ejemplo: 1000000000

amountRegular.Tipo: string · int32

amountRegular.Multiplicador de spread aplicado fuera de la ventana, fp9 sin procesar (`1000000000` = 1x).

amountRegular.format: int32

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

Ejemplo



```json
{
  "activeSince": "2026-05-01T12:30:00.000Z",
  "activeUntil": "2026-05-01T12:30:00.000Z",
  "amount": "1000000000",
  "amountRegular": "1000000000"
}
```