Skip to main content
Un 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, SOL et XAUT (or).
  • Perpétuels : comme BTC, ainsi que les perpétuels sur actions et matières premières de la plateforme xyz d’Hyperliquid, comme xyz:TSLA. Envoyez l’id comme market lorsque vous créez un trade.
Un même symbole peut apparaître deux fois, une fois en tant que perpétuel et une fois en spot ; utilisez donc 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.
La liste des marchés est en bêta, comme le reste de l’API de trading, et peut évoluer sans nouvelle date de version de l’API.

Attributs

string
requis
ID du trade, préfixé par tint_.
string | null
requis
Le compte propriétaire du portefeuille de trading, préfixé par biz_. null lorsqu’il appartient à un utilisateur.
string | null
requis
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.
string | null
requis
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.
string | null
requis
L’ID propre à l’appelant pour le trade, unique pour le compte. null si aucun n’a été envoyé.
string | null
requis
Date à laquelle le trade s’est terminé avec succès ou en échec, sous forme d’horodatage ISO 8601. null avant cela.
string
requis
Date de création du trade, sous forme d’horodatage ISO 8601.
string | null
requis
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.
string | null
requis
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_failed
string | null
requis
La 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.
string | null
requis
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, unknown
string | null
requis
perpetual ou spot pour un ordre, perpetual pour une clôture. null pour un dépôt ou un retrait.Options disponibles : perpetual, spot
integer | null
requis
L’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.
string | null
requis
Le marché, par exemple BTC pour un perpétuel ou XAUT pour le spot. null pour un dépôt ou un retrait.
object
requis
Annotations libres de type chaîne vers chaîne stockées sur le trade.
string
requis
string | null
requis
market, limit, take_profit ou stop_loss pour un ordre. null sinon.Options disponibles : market, limit, take_profit, stop_loss
string | null
requis
Pour un take-profit ou un stop-loss envoyé avec un ordre, le trade de cet ordre, préfixé par tint_. null sinon.
object | null
requis
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

string
requis
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.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
Nombre de décimales du montant. Il s’agit de la précision à laquelle le prélèvement lui-même est effectué.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais délibérément pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, ce qui donne 2 et 0. Utilisez cette valeur pour formater le nombre selon vos propres paramètres régionaux.
boolean | null
requis
Indique si l’ordre peut uniquement réduire une position. null pour les autres types.
string | null
requis
buy ou sell pour un ordre. null sinon.Options disponibles : buy, sell
string | null
requis
La taille de l’ordre en unités du marché, sous forme de chaîne décimale. null pour les autres types.
string
requis
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, failed
string | null
requis
partial_fill lorsque l’ordre n’a été exécuté que pour une partie de sa taille. null sinon.Options disponibles : partial_fill
string | null
requis
Ce 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, crediting
object | null
requis
Le 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

string
requis
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.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
Nombre de décimales du montant. Il s’agit de la précision à laquelle le prélèvement lui-même est effectué.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais délibérément pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, ce qui donne 2 et 0. Utilisez cette valeur pour formater le nombre selon vos propres paramètres régionaux.
string
requis
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, withdraw
string
requis
Date de la dernière modification du trade, sous forme d’horodatage ISO 8601.
string | null
requis
L’utilisateur propriétaire du portefeuille de trading, préfixé par user_. null lorsqu’il appartient à un compte.
Trade