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,SOLyXAUT(oro). - Perpetuos: como
BTC, y perpetuos de acciones y materias primas del exchangexyzde Hyperliquid, comoxyz:TSLA. Envía elidcomomarketcuando crees un trade.
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.
Atributos
La cuenta propietaria de la billetera de trading, con el prefijo
biz_. null cuando su propietario
es un usuario.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.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.El ID propio de quien llama para el trade, único para la cuenta.
null cuando no
se envió ninguno.Cuándo terminó el trade como completado o fallido, como marca de tiempo ISO 8601.
null
antes de eso.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.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_failedEl 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.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, unknownperpetual o spot para una orden, perpetual para un cierre. null para un depósito o retiro.Opciones disponibles: perpetual, spotEl 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.El mercado, por ejemplo
BTC para un perpetuo o XAUT para spot. null para un
depósito o retiro.market, limit, take_profit o stop_loss para una orden. null en otro caso.Opciones disponibles: market, limit, take_profit, stop_lossPara un take-profit o stop-loss enviado con una orden, el trade de esa orden,
con el prefijo
tint_. null en otro caso.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
Propiedades
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.Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta
el propio cargo.
El tamaño de la orden en unidades del mercado, como cadena decimal.
null para otros
tipos.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, failedpartial_fill cuando la orden solo se ejecutó en parte de su tamaño. null en otro caso.Opciones disponibles: partial_fillLo 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, creditingEl precio en USD al que un take-profit o stop-loss envía su orden de mercado.
null para otras órdenes y tipos.Propiedades
Propiedades
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.Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta
el propio cargo.
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, withdrawTrade

