# Get scalping coefficient for ticker

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

Whether the account is currently inside the scalping window on this market — the period after an increase during which the market charges the
elevated dynamic spread.

- `amount` is the multiplier applied inside the window and `amountRegular` the one applied outside it, both fp9.
- `activeSince` and `activeUntil` are returned only while the window is running; without a recent increase they are absent and the regular
  multiplier applies.

## Authorization

bearer: http · bearer (required). Personal API key, prefixed with `usk_`.

## Parameters

- path: accountId (string · uuid; required). Trader account identifier. Must belong to the caller.

Type: string · uuid

format: uuid

- path: asset (string; required). Base asset ticker of the market, as returned by `GET /v2/markets`.

Type: string

Example: "BTC"

## Example · cURL

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

## Example · 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());
```

## Example · 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)
```

## Response 401

**401**  — Unauthorized

## Response 403

**403**  — The account belongs to another user (`account_access_denied`), or the request is authenticated with an API key while `api_trading` is disabled on the account (`api_trading_not_enabled`).

## Response 404

**404**  — No account with this identifier, or no market for this ticker.

## Response 429

**429**  — Rate limit of the API key exceeded (`api_key_rate_limit_exceeded`). `Retry-After` says when to come back; the body carries the bucket (`read` / `write`), the window that tripped, its limit and `retryAt`.

## Response default · ScalpingCoefficientResponse

**default** application/json — Response

Schema: ScalpingCoefficientResponse

Type: object

Required fields: amount, amountRegular

Required field types: amount (string · int32; required), amountRegular (string · int32; required)

- activeSince (string · date-time; optional)

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

activeSince.Type: string · date-time

activeSince.Start of the running scalping window — the last increase on this market. Absent when no increase happened inside the window.

activeSince.format: date-time

- activeUntil (string · date-time; optional)

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

activeUntil.Type: string · date-time

activeUntil.End of the running scalping window. Absent together with `activeSince`.

activeUntil.format: date-time

- amount (string · int32; required)

amount example: 1000000000

amount.Type: string · int32

amount.Spread multiplier charged while the window is running, fp9 raw (`2000000000` = 2x).

amount.format: int32

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

- amountRegular (string · int32; required)

amountRegular example: 1000000000

amountRegular.Type: string · int32

amountRegular.Spread multiplier charged outside the window, fp9 raw (`1000000000` = 1x).

amountRegular.format: int32

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

Example



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