Skip to main content
Una order sobre un perpetuo opera desde el saldo de trading, transfiriendo primero por bridge el USDT0 que necesita desde la billetera cuando el saldo no alcanza; una order sobre spot intercambia entre USDT0 y el activo en la billetera. Un close cierra toda la posición en un mercado; cuando la cuenta queda sin posiciones, un trade withdraw devuelve el saldo de trading a la billetera. Un deposit o un withdraw mueve dinero entre la billetera y el saldo de trading. Los perpetuos se operan en Hyperliquid. Usa la API de Trades para listar los mercados en los que puedes operar, colocar órdenes, cerrar posiciones y mover fondos, y hacer seguimiento de cada trade hasta que termine. Los trades se ejecutan en segundo plano; una orden que transfirió dinero por bridge y no se ejecuta devuelve ese dinero a la billetera, y funds_location indica dónde está el dinero. La API de trading, incluido include_trading en cuentas y usuarios, está en beta. Puede cambiar sin una nueva fecha de versión de la API.

Endpoints

Mercados

Listar mercados devuelve todos los mercados en los que puedes operar en Whop.
  • Spot: se listan por símbolo: BTC, SOL y XAUT (oro).
  • Perpetuos: como BTC, y perpetuos de acciones y materias primas del exchange xyz de Hyperliquid, como xyz:TSLA. Envía el id como market cuando crees un trade.
El mismo símbolo puede aparecer dos veces, una como perpetuo y otra como spot, así que usa id junto con instrument_type para distinguirlos. Los resultados se ordenan por id y luego por instrument_type. Este endpoint es público: no se necesita API key, y cada dirección IP puede hacer hasta 60 solicitudes por minuto. El size de una orden de perpetuo puede tener como máximo size_decimals decimales, y su leverage puede ser como máximo max_leverage, que es null para un mercado spot.
La lista de mercados está en beta, como el resto de la API de trading, y puede cambiar sin una nueva fecha de versión de la API.

Atributos

string
requerido
ID del trade, con el prefijo tint_.
string | null
requerido
La cuenta propietaria de la billetera de trading, con el prefijo biz_. null cuando su propietario es un usuario.
string | null
requerido
El USDT0 que envía desde la billetera un depósito, una compra spot o una orden de perpetuo sin saldo de trading suficiente, o el USDC que devuelve un retiro, en unidades nativas, como cadena decimal. Un retiro de all muestra lo que envió una vez que termina. null en otro caso.
string | null
requerido
El precio medio de ejecución de la orden, en USD, como cadena decimal. Para spot, el precio al que se cotizó el swap. null cuando no se conoce.
string | null
requerido
El ID propio de quien llama para el trade, único para la cuenta. null cuando no se envió ninguno.
string | null
requerido
Cuándo terminó el trade como completado o fallido, como marca de tiempo ISO 8601. null antes de eso.
string
requerido
Cuándo se creó el trade, como marca de tiempo ISO 8601.
string | null
requerido
ID que Whop envía al exchange con la orden de este trade, para que las actualizaciones de órdenes del exchange se puedan asociar al trade. En Hyperliquid, el cloid de la orden informado en orderUpdates, una cadena hexadecimal de 32 caracteres con el prefijo 0x. No es el client_order_id de quien llama. null para un depósito o retiro.
string | null
requerido
Por qué falló el trade, o null.Opciones disponibles: market_unavailable, leverage_too_high, amount_too_small, isolated_position_open, trading_paused, funding_failed, margin_unavailable, builder_fee_unapproved, leverage_rejected, leverage_unconfirmed, order_rejected, close_rejected, return_failed, withdraw_failed
string | null
requerido
El tamaño ejecutado de la orden, en unidades del mercado, como cadena decimal. Para una compra spot, el importe que el swap se cotizó para entregar. null hasta que se ejecuta.
string | null
requerido
Dónde está el dinero cuando el trade no se completó como se pidió: wallet, trading_account o unknown mientras una persona lo revisa. null en otro caso.Opciones disponibles: wallet, trading_account, unknown
string | null
requerido
perpetual o spot para una orden, perpetual para un cierre. null para un depósito o retiro.Opciones disponibles: perpetual, spot
integer | null
requerido
El apalancamiento cruzado definido antes de una orden de apertura de perpetuo. null para una orden spot, un cierre, un depósito, un retiro o una orden de solo reducción.
string | null
requerido
El mercado, por ejemplo BTC para un perpetuo o XAUT para spot. null para un depósito o retiro.
object
requerido
Anotaciones libres de cadena a cadena almacenadas en el trade.
string
requerido
string | null
requerido
market, limit, take_profit o stop_loss para una orden. null en otro caso.Opciones disponibles: market, limit, take_profit, stop_loss
string | null
requerido
Para un take-profit o stop-loss enviado con una orden, el trade de esa orden, con el prefijo tint_. null en otro caso.
object | null
requerido
El precio límite de la orden en USD. El precio de una orden de mercado es el precio medio desplazado por slippage_bps; el de un take-profit o stop-loss es el peor precio al que puede ejecutarse su orden de mercado una vez activada. null para otros tipos.

Propiedades

string
requerido
El importe en unidades principales, como cadena decimal exacta. Por ejemplo, "10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
string
requerido
Código de divisa ISO 4217 de tres letras, en minúsculas.
integer
requerido
Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
integer
requerido
Cuántos decimales se deben MOSTRAR. Normalmente es igual a decimals, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es 2 y 0. Usa esto para dar formato al número en tu propia configuración regional.
boolean | null
requerido
Si la orden solo puede reducir una posición. null para otros tipos.
string | null
requerido
buy o sell para una orden. null en otro caso.Opciones disponibles: buy, sell
string | null
requerido
El tamaño de la orden en unidades del mercado, como cadena decimal. null para otros tipos.
string
requerido
pending hasta que el trade empieza. processing mientras se ejecuta, y también mientras una orden que no se ejecutó devuelve a la billetera el dinero que transfirió por bridge. completed cuando hizo lo que se pidió. failed cuando no lo hizo; funds_location indica dónde está el dinero. in_review cuando el resultado es desconocido y una persona lo revisa.Opciones disponibles: pending, processing, in_review, completed, failed
string | null
requerido
partial_fill cuando la orden solo se ejecutó en parte de su tamaño. null en otro caso.Opciones disponibles: partial_fill
string | null
requerido
Lo que está haciendo ahora un trade en curso: depositing mientras el USDT0 de la billetera se envía al bridge, landing una vez enviado y hasta que llega al saldo de trading, placing mientras la orden o el cierre está en el mercado, withdrawing mientras el USDC vuelve a la billetera, returning mientras vuelve el dinero que una orden no ejecutada transfirió por bridge. Una orden spot está en quoting mientras se cotiza el swap, en swapping mientras se ejecuta on-chain y en crediting hasta que el nuevo saldo aparece en la billetera. null una vez que el trade ya no está pendiente ni en proceso.Opciones disponibles: depositing, landing, placing, withdrawing, returning, quoting, swapping, crediting
object | null
requerido
El precio en USD al que un take-profit o stop-loss envía su orden de mercado. null para otras órdenes y tipos.

Propiedades

string
requerido
El importe en unidades principales, como cadena decimal exacta. Por ejemplo, "10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
string
requerido
Código de divisa ISO 4217 de tres letras, en minúsculas.
integer
requerido
Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
integer
requerido
Cuántos decimales se deben MOSTRAR. Normalmente es igual a decimals, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es 2 y 0. Usa esto para dar formato al número en tu propia configuración regional.
string
requerido
order coloca una orden: una orden de perpetuo opera desde el saldo de trading y una orden spot intercambia entre USDT0 y el activo en la billetera. deposit transfiere por bridge USDT0 desde la billetera al saldo de trading. withdraw envía USDC desde el saldo de trading de vuelta a la billetera. close cierra toda la posición en un mercado con una orden de mercado de solo reducción; cuando la cuenta queda sin posiciones, un trade withdraw devuelve el saldo de trading a la billetera.Opciones disponibles: close, order, deposit, withdraw
string
requerido
Cuándo cambió el trade por última vez, como marca de tiempo ISO 8601.
string | null
requerido
El usuario propietario de la billetera de trading, con el prefijo user_. null cuando su propietario es una cuenta.
Trade