order på en perpetual handler fra handelssaldoen og bridger først den USDT0, den har brug for, fra wallet’en, når saldoen ikke rækker; en order på spot bytter mellem USDT0 og aktivet i wallet’en. En close lukker hele positionen i ét marked; når kontoen derefter er flad, sender en withdraw-trade handelssaldoen tilbage til wallet’en. En deposit eller withdraw flytter penge mellem wallet’en og handelssaldoen. Perpetuals handles på Hyperliquid.
Brug Trades API’et til at vise de markeder, du kan handle på, afgive ordrer, lukke positioner og flytte midler samt følge hver trade, indtil den er færdig. Trades kører i baggrunden; en ordre, der bridgede penge ind og ikke bliver udfyldt, sender pengene tilbage til wallet’en, og funds_location angiver, hvor pengene er.
Handels-API’et, inklusive include_trading på konti og brugere, er i beta. Det kan ændres uden en ny API-versionsdato.
Endpoints
Markeder
Vis markeder returnerer alle markeder, du kan handle på Whop.- Spot: angivet efter symbol:
BTC,SOLogXAUT(guld). - Perpetuals: f.eks.
BTCsamt aktie- og råvare-perpetuals fra Hyperliquidsxyz-børs, f.eks.xyz:TSLA. Sendidsommarket, når du opretter en trade.
id sammen med instrument_type til at skelne dem. Resultaterne sorteres efter id og derefter instrument_type.
Dette endpoint er offentligt: der kræves ingen API-nøgle, og hver IP-adresse kan foretage op til 60 anmodninger i minuttet.
En perpetual-ordres size kan højst have size_decimals decimaler, og dens leverage kan højst være max_leverage, som er null for et spotmarked.
Attributter
Den konto, der ejer handels-wallet’en, med præfikset
biz_. null, når en bruger
ejer den.Den USDT0, som en deposit, et spotkøb eller en perpetual-ordre med utilstrækkelig handelssaldo
sender fra wallet’en, eller den USDC, som en withdraw sender tilbage, i
native enheder som en decimalstreng. En withdraw af
all viser, hvad den sendte, når
den er færdig. Ellers null.Ordrens gennemsnitlige udfyldelsespris i USD som en decimalstreng. For spot er det
den pris, swappet blev noteret til.
null, når den ikke er kendt.Kalderens eget id for traden, unikt for kontoen.
null, når der ikke
blev sendt noget.Hvornår traden endte som gennemført eller mislykket, som et ISO 8601-tidsstempel.
null
før da.Id, som Whop sender til børsen med denne trades ordre, så børsens ordreopdateringer
kan matches med traden. På Hyperliquid er det ordrens
cloid,
rapporteret i orderUpdates, en hexstreng på 32 tegn med præfikset 0x. Ikke
kalderens client_order_id. null for en deposit eller withdraw.Hvorfor traden mislykkedes, eller
null.Tilgængelige muligheder: 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_failedDen størrelse, ordren blev udfyldt med, i markedets enheder som en decimalstreng. For et
spotkøb er det det beløb, swappet blev noteret til at levere.
null, indtil den udfyldes.Hvor pengene er, når traden ikke blev gennemført som ønsket:
wallet, trading_account eller unknown, mens en person tjekker det. Ellers null.Tilgængelige muligheder: wallet, trading_account, unknownperpetual eller spot for en ordre, perpetual for en close. null for en deposit eller withdraw.Tilgængelige muligheder: perpetual, spotDen cross-gearing, der er sat før en åbnende perpetual-ordre.
null for en spotordre,
close, deposit, withdraw eller reduce-only-ordre.Markedet, for eksempel
BTC for en perpetual eller XAUT for spot. null for en
deposit eller withdraw.market, limit, take_profit eller stop_loss for en ordre. Ellers null.Tilgængelige muligheder: market, limit, take_profit, stop_lossFor en take-profit eller stop-loss sendt med en ordre: den ordres trade,
med præfikset
tint_. Ellers null.Ordrens limitpris i USD. En markedsordres pris er midterprisen flyttet med
slippage_bps; en take-profits eller stop-loss’ pris er den dårligste pris, dens markedsordre må udfyldes til, når den er udløst. null for andre typer.Egenskaber
Egenskaber
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er
"10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
Ordrestørrelsen i markedets enheder som en decimalstreng.
null for andre
typer.pending, indtil traden starter. processing, mens den kører, også mens en ordre, der ikke blev udfyldt, sender de penge, den bridgede ind, tilbage til wallet’en. completed, når den gjorde det, der blev bedt om. failed, når den ikke gjorde; funds_location angiver, hvor pengene er. in_review, når resultatet er ukendt, og en person tjekker det.Tilgængelige muligheder: pending, processing, in_review, completed, failedpartial_fill, når ordren kun blev udfyldt for en del af sin størrelse. Ellers null.Tilgængelige muligheder: partial_fillHvad en aktiv trade gør lige nu:
depositing, mens wallet’ens USDT0 sendes til bridgen, landing, når den er sendt og indtil den når handelssaldoen, placing, mens ordren eller close er hos handelsstedet, withdrawing, mens USDC er på vej tilbage til wallet’en, returning, mens penge, som en ikke-udfyldt ordre bridgede ind, går tilbage. En spotordre er quoting, mens swappet prissættes, swapping, mens det kører onchain, og crediting, indtil den nye saldo vises i wallet’en. null, når traden ikke længere er pending eller processing.Tilgængelige muligheder: depositing, landing, placing, withdrawing, returning, quoting, swapping, creditingDen pris i USD, hvor en take-profit eller stop-loss sender sin markedsordre.
null for andre ordrer og typer.Egenskaber
Egenskaber
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er
"10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
order afgiver én ordre: en perpetual-ordre handler fra handelssaldoen, en spotordre bytter mellem USDT0 og aktivet i wallet’en. deposit bridger USDT0 fra wallet’en til handelssaldoen. withdraw sender USDC fra handelssaldoen tilbage til wallet’en. close lukker hele positionen i ét marked med en reduce-only-markedsordre; når kontoen derefter er flad, sender en withdraw-trade handelssaldoen tilbage til wallet’en.Tilgængelige muligheder: close, order, deposit, withdrawTrade

