Obtener el interés abierto actual por ticker

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

Obtener el interés abierto actual por tickerTrading

Nocional abierto que la cuenta mantiene actualmente en un mercado, sumado por dirección, fp9 en bruto.

Útil antes de calcular el tamaño de un aumento: el mercado limita el nocional abierto por dirección, y una orden que superaría el límite se rechaza con order_exceeds_max_open_notional.

URL base https://api.upscale.trade

Autorización

bearerhttp · bearerobligatorio

Clave de API personal, con el prefijo usk_.

Parámetros

Ruta

accountIdstring · uuidobligatorio

Identificador de la cuenta del trader. Debe pertenecer al solicitante.

Ejemplo: 00000000-0000-4000-8000-000000000000

assetstringobligatorio

Ticker del activo base del mercado, tal como lo devuelve GET /v2/markets.

Ejemplo: BTC

Ejemplos

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

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

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)

Respuestas

401

No autorizado

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

404

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

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.

defaultRespuestaapplication/json

openNotionalLongstring · int32obligatorio

Open notional the account holds long on this market, summed across positions, fp9 raw.

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

Ejemplo: 1000000000

openNotionalShortstring · int32obligatorio

Open notional the account holds short on this market, summed across positions, fp9 raw.

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

Ejemplo: 1000000000

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