order sur un perpétuel négocie à partir du solde de trading, en transférant d’abord par bridge l’USDT0 nécessaire depuis le portefeuille lorsque le solde est insuffisant ; un order au comptant (spot) échange entre l’USDT0 et l’actif dans le portefeuille. Un close clôture l’intégralité de la position sur un marché ; lorsque le compte n’a alors plus de position, un trade withdraw renvoie le solde de trading vers le portefeuille. Un deposit ou un withdraw déplace de l’argent entre le portefeuille et le solde de trading. Les perpétuels sont négociés sur Hyperliquid.
Utilisez l’API Trades pour lister les marchés sur lesquels vous pouvez négocier, passer des ordres, clôturer des positions et déplacer des fonds, et suivre chaque trade jusqu’à son achèvement. Les trades s’exécutent en arrière-plan ; un ordre qui a transféré de l’argent par bridge et n’est pas exécuté renvoie cet argent vers le portefeuille, et funds_location indique où se trouve l’argent.
L’API de trading, y compris include_trading sur les comptes et les utilisateurs, est en bêta. Elle peut évoluer sans nouvelle date de version de l’API.
Endpoints
Marchés
Lister les marchés renvoie tous les marchés sur lesquels vous pouvez négocier sur Whop.- Spot : répertoriés par symbole :
BTC,SOLetXAUT(or). - Perpétuels : comme
BTC, ainsi que les perpétuels sur actions et matières premières de la plateformexyzd’Hyperliquid, commexyz:TSLA. Envoyez l’idcommemarketlorsque vous créez un trade.
id avec instrument_type pour les distinguer. Les résultats sont triés par id, puis par instrument_type.
Cet endpoint est public : aucune clé API n’est nécessaire, et chaque adresse IP peut effectuer jusqu’à 60 requêtes par minute.
La size d’un ordre perpétuel peut comporter au plus size_decimals décimales, et son leverage ne peut pas dépasser max_leverage, qui vaut null pour un marché spot.
Attributs
Le compte propriétaire du portefeuille de trading, préfixé par
biz_. null lorsqu’il appartient à un utilisateur.L’USDT0 envoyé depuis le portefeuille par un dépôt, un achat spot ou un ordre perpétuel dont le solde de trading est insuffisant, ou l’USDC renvoyé par un retrait, en unités natives, sous forme de chaîne décimale. Un retrait de
all indique ce qu’il a envoyé une fois terminé. null sinon.Le prix d’exécution moyen de l’ordre, en USD, sous forme de chaîne décimale. Pour le spot, le prix auquel le swap a été coté.
null s’il n’est pas connu.L’ID propre à l’appelant pour le trade, unique pour le compte.
null si aucun n’a été envoyé.Date à laquelle le trade s’est terminé avec succès ou en échec, sous forme d’horodatage ISO 8601.
null avant cela.ID que Whop envoie à la plateforme d’échange avec l’ordre de ce trade, afin que les mises à jour d’ordre de la plateforme puissent être associées au trade. Sur Hyperliquid, il s’agit du
cloid de l’ordre indiqué dans orderUpdates, une chaîne hexadécimale de 32 caractères préfixée par 0x. Ce n’est pas le client_order_id de l’appelant. null pour un dépôt ou un retrait.Raison de l’échec du trade, ou
null.Options 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_failedLa taille exécutée de l’ordre, en unités du marché, sous forme de chaîne décimale. Pour un achat spot, le montant que le swap devait livrer selon la cotation.
null jusqu’à l’exécution.Où se trouve l’argent lorsque le trade ne s’est pas terminé comme demandé :
wallet, trading_account, ou unknown pendant qu’une personne vérifie. null sinon.Options disponibles : wallet, trading_account, unknownperpetual ou spot pour un ordre, perpetual pour une clôture. null pour un dépôt ou un retrait.Options disponibles : perpetual, spotL’effet de levier croisé défini avant un ordre perpétuel d’ouverture.
null pour un ordre spot, une clôture, un dépôt, un retrait ou un ordre reduce-only.Le marché, par exemple
BTC pour un perpétuel ou XAUT pour le spot. null pour un dépôt ou un retrait.market, limit, take_profit ou stop_loss pour un ordre. null sinon.Options disponibles : market, limit, take_profit, stop_lossPour un take-profit ou un stop-loss envoyé avec un ordre, le trade de cet ordre, préfixé par
tint_. null sinon.Le prix limite de l’ordre en USD. Le prix d’un ordre au marché est le prix médian ajusté de
slippage_bps ; celui d’un take-profit ou d’un stop-loss est le pire prix auquel son ordre au marché peut être exécuté une fois déclenché. null pour les autres types.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales du montant. Il s’agit de la précision à laquelle le prélèvement lui-même est effectué.
Indique si l’ordre peut uniquement réduire une position.
null pour les autres types.La taille de l’ordre en unités du marché, sous forme de chaîne décimale.
null pour les autres types.pending jusqu’au démarrage du trade. processing pendant son exécution, y compris lorsqu’un ordre non exécuté renvoie vers le portefeuille l’argent transféré par bridge. completed lorsqu’il a fait ce qui était demandé. failed dans le cas contraire ; funds_location indique où se trouve l’argent. in_review lorsque le résultat est inconnu et qu’une personne le vérifie.Options disponibles : pending, processing, in_review, completed, failedpartial_fill lorsque l’ordre n’a été exécuté que pour une partie de sa taille. null sinon.Options disponibles : partial_fillCe que fait actuellement un trade en cours :
depositing pendant l’envoi de l’USDT0 du portefeuille vers le bridge, landing une fois envoyé et jusqu’à ce qu’il atteigne le solde de trading, placing pendant que l’ordre ou la clôture est sur la plateforme, withdrawing pendant que l’USDC revient vers le portefeuille, returning pendant que l’argent transféré par bridge pour un ordre non exécuté est renvoyé. Un ordre spot est quoting pendant la cotation du swap, swapping pendant son exécution on-chain, et crediting jusqu’à ce que le nouveau solde apparaisse dans le portefeuille. null dès que le trade n’est plus en attente ni en cours de traitement.Options disponibles : depositing, landing, placing, withdrawing, returning, quoting, swapping, creditingLe prix en USD auquel un take-profit ou un stop-loss envoie son ordre au marché.
null pour les autres ordres et types.Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales du montant. Il s’agit de la précision à laquelle le prélèvement lui-même est effectué.
order passe un ordre : un ordre perpétuel négocie à partir du solde de trading, un ordre spot échange entre l’USDT0 et l’actif dans le portefeuille. deposit transfère par bridge de l’USDT0 du portefeuille vers le solde de trading. withdraw renvoie de l’USDC du solde de trading vers le portefeuille. close clôture l’intégralité de la position sur un marché avec un ordre au marché reduce-only ; lorsque le compte n’a alors plus de position, un trade withdraw renvoie le solde de trading vers le portefeuille.Options disponibles : close, order, deposit, withdrawTrade

