Obtener órdenes activas por ticker

GET/orders/{accountId}/{asset}/active

Obtener órdenes activas por tickerTrading

Las órdenes activas de la cuenta en un mercado, seleccionadas por el ticker de su activo base. La misma regla de fase que la lista sin filtrar.

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/orders/{accountId}/{asset}/active' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch("https://api.upscale.trade/orders/{accountId}/{asset}/active", {
  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/orders/{accountId}/{asset}/active",
    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

Array de OrderResponse

idstring · uuidobligatorio

Identificador de la orden.

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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

txIdstringobligatorio

Identificador de la orden. Se conserva por compatibilidad con versiones anteriores, siempre igual a id.

Ejemplo: string

traderstring · uuidobligatorio

Cuenta del trader a la que pertenece la orden.

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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

marketstring · uuidobligatorio

Mercado en el que se coloca la orden.

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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

statusstring · enumobligatorio

Estado del ciclo de vida: active mientras espera, executed una vez ejecutada, canceled cuando es cancelada por el trader o la plataforma, canceled_by_update cuando es reemplazada por una edición, canceled_by_position cuando la posición a la que estaba vinculada desapareció, canceled_by_error cuando falló la ejecución — consulta errorCode.

Permitido: "active" "canceled" "canceled_by_update" "canceled_by_error" "canceled_by_position" "executed"

Ejemplo: active

typestring · enumobligatorio

Tipo de orden. liquidation marca una orden que el propio motor generó.

Permitido: "market" "limit" "stop" "trailing_stop" "take" "stop_limit" "stop_market" "liquidation"

Ejemplo: market

directionstring · enumobligatorio

Dirección de la orden.

Permitido: "long" "short"

Ejemplo: long

triggerPricestring · int32obligatorio

Precio al que se dispara la orden, fp9 en bruto. 0 cuando la orden no lleva disparador.

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

Ejemplo: 1000000000

requestedTriggerPricestring · int32 · nullableobligatorio

Precio de activación tal como se solicitó, antes de que el motor lo desplazara hasta la distancia mínima de stop, fp9 en bruto. Nulo cuando el precio solicitado se mantuvo tal cual.

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

Ejemplo: 1000000000

stopPricestring · int32obligatorio

Precio de activación de una orden stop_market / stop_limit, fp9 en bruto; 0 para cualquier otro tipo.

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

Ejemplo: 1000000000

limitPricestring · int32obligatorio

Precio al que se coloca la orden una vez activada, fp9 en bruto: el precio stop-limit, recurriendo al precio de activación como alternativa.

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

Ejemplo: 1000000000

stopTriggerPricestring · int32obligatorio

Stop-loss asociado a la orden, fp9 en bruto. 0 cuando no hay ninguno asociado.

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

Ejemplo: 1000000000

takeTriggerPricestring · int32obligatorio

Take-profit asociado a la orden, fp9 en bruto. 0 cuando no hay ninguno asociado.

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

Ejemplo: 1000000000

trailingStopActivationPricestring · int32obligatorio

Precio al que un stop móvil comienza a hacer seguimiento, fp9 sin procesar. 0 cuando hace seguimiento desde la creación.

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

Ejemplo: 1000000000

trailingStopOffsetstring · int32obligatorio

Distancia de seguimiento como un importe absoluto de cotización, fp9 sin procesar. 0 cuando la distancia se establece como porcentaje.

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

Ejemplo: 1000000000

trailingStopOffsetPercentstring · int32obligatorio

Distancia de seguimiento como una fracción del precio, fp9 sin procesar. 0 cuando la distancia es absoluta.

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

Ejemplo: 1000000000

leveragestring · int32 · nullableobligatorio

Apalancamiento de la orden, fp9 en bruto. Nulo en órdenes de cierre, que heredan el apalancamiento de la posición.

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

Ejemplo: 1000000000

indexstringobligatorio

Identificador de la orden. Se conserva por compatibilidad con versiones anteriores, siempre igual a id.

Ejemplo: string

positionIdstring[]obligatorio

Posición a la que está asociada una orden de cierre. Nulo para órdenes que abren o aumentan una posición.

Elementos del array · string

string

Ver ejemplo

[
  "string"
]

parentOrderIdstring[]obligatorio

Orden de la que se generó esta: un stop o un take creado a partir de stopTriggerPrice / takeTriggerPrice, o la orden limit en la que se convirtió un stop_limit. Nulo cuando la orden se envió directamente.

Elementos del array · string

string

Ver ejemplo

[
  "string"
]

expirationstring · date-time · nullableobligatorio

Siempre nulo. Se mantiene por compatibilidad con versiones anteriores: las órdenes no expiran por sí solas.

Ejemplo: 2026-05-01T12:30:00.000Z

amountstring · int32obligatorio

Tamaño de la orden, fp9 en bruto, en la unidad que usa su clase: en una orden de incremento, un importe de cotización — la reserva mientras espera, y lo que realmente gastó una vez ejecutada; en una orden de cierre (stop, take, trailing_stop), el tamaño del activo base que cierra, tal como se solicitó al crearla.

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

Ejemplo: 1000000000

indexPricestring · int32 · nullableobligatorio

Precio índice al que se ejecutó la orden, fp9 en bruto. Nulo mientras la orden no se haya ejecutado.

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

Ejemplo: 1000000000

settlementOraclePricestring · int32obligatorio

Siempre 1000000000 (1.0). Se mantiene por compatibilidad con versiones anteriores.

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

Ejemplo: 1000000000

createdAtstring · date-timeobligatorio

Cuándo se aceptó la orden.

Ejemplo: 2026-05-01T12:30:00.000Z

errorstring[]obligatorio

Siempre null. Se mantiene por compatibilidad hacia atrás — utilice errorCode.

Elementos del array · string

string

Ver ejemplo

[
  "string"
]

realizedPnlstring · int32 · nullableobligatorio

Pnl realizado por esta orden, fp9 en bruto. Se establece solo en una orden de cierre ejecutada; null mientras está pendiente y en órdenes que abren o aumentan una posición.

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

Ejemplo: 1000000000

rawRealizedPnlstring · int32 · nullableobligatorio

Pnl realizado antes del ajuste de 60 segundos, fp9 en bruto. Difiere de realizedPnl solo cuando se activó el ajuste.

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

Ejemplo: 1000000000

profitAdjustmentAppliedbooleanobligatorio

Si el ajuste de 60 segundos limitó la ganancia de esta orden — dentro de un minuto de una apertura o un aumento, el pnl de la posición no puede crecer por encima de lo que era en ese momento.

Ejemplo: true

executedAfterPausebooleanobligatorio

Indica si la orden se ejecutó después de una pausa del mercado. No lo establece el motor actual — siempre false.

Ejemplo: true

sizeModestring · enumobligatorio

Cómo se expresó el tamaño al crearse: quote dimensiona la orden por amount, base la dimensiona por baseSize.

Permitido: "quote" "base"

Ejemplo: quote

baseSizestring · int32 · nullableobligatorio

Tamaño de la orden en unidades del activo base, fp9 en bruto. Nulo para órdenes dimensionadas por quote.

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

Ejemplo: 1000000000

reservedAmountstring · int32 · nullableobligatorio

Importe de quote reservado cuando se creó la orden con sizeMode=base, fp9 en bruto. Se mantiene en la reserva original después de la ejecución, mientras que amount se reescribe a lo que se gastó. Nulo para órdenes dimensionadas por quote, donde amount es la reserva.

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

Ejemplo: 1000000000

errorCodestring[]obligatorio

Por qué falló la ejecución, establecido junto con el estado canceled_by_error — por ejemplo insufficient_reserve_at_execution, order_below_min_notional, order_exceeds_market_depth o slippage_tolerance. Nulo en caso contrario.

Elementos del array · string

string

Ver ejemplo

[
  "string"
]

reasonstring · enum · nullableobligatorio

Por qué la plataforma canceló la orden por sí misma, por ejemplo force_close o weekly_session_risk_close. Nulo para cancelaciones impulsadas por el trader.

Permitido: "force_close" "stop_accounts_fail" "stop_accounts_freeze" "stop_accounts_promote" "stop_accounts_manual" "weekly_session_risk_close" null

Ejemplo: force_close

[
  {
    "id": "00000000-0000-4000-8000-000000000000",
    "txId": "string",
    "trader": "00000000-0000-4000-8000-000000000000",
    "market": "00000000-0000-4000-8000-000000000000",
    "status": "active",
    "type": "market",
    "direction": "long",
    "triggerPrice": "1000000000",
    "requestedTriggerPrice": "1000000000",
    "stopPrice": "1000000000",
    "limitPrice": "1000000000",
    "stopTriggerPrice": "1000000000",
    "takeTriggerPrice": "1000000000",
    "trailingStopActivationPrice": "1000000000",
    "trailingStopOffset": "1000000000",
    "trailingStopOffsetPercent": "1000000000",
    "leverage": "1000000000",
    "index": "string",
    "positionId": [
      "string"
    ],
    "parentOrderId": [
      "string"
    ],
    "expiration": "2026-05-01T12:30:00.000Z",
    "amount": "1000000000",
    "indexPrice": "1000000000",
    "settlementOraclePrice": "1000000000",
    "createdAt": "2026-05-01T12:30:00.000Z",
    "error": [
      "string"
    ],
    "realizedPnl": "1000000000",
    "rawRealizedPnl": "1000000000",
    "profitAdjustmentApplied": true,
    "executedAfterPause": true,
    "sizeMode": "quote",
    "baseSize": "1000000000",
    "reservedAmount": "1000000000",
    "errorCode": [
      "string"
    ],
    "reason": "force_close"
  }
]