order op een perpetual handelt vanuit het handelssaldo, waarbij eerst de benodigde USDT0 vanuit de wallet wordt overgebracht als het saldo tekortschiet; een order op spot wisselt tussen USDT0 en het asset in de wallet. Een close sluit de volledige positie in één markt; als het account daarna geen posities meer heeft, stuurt een withdraw-trade het handelssaldo terug naar de wallet. Een deposit of withdraw verplaatst geld tussen de wallet en het handelssaldo. Perpetuals worden verhandeld op Hyperliquid.
Gebruik de Trades API om de markten weer te geven waarop je kunt handelen, orders te plaatsen, posities te sluiten en geld te verplaatsen, en om elke trade te volgen totdat deze is afgerond. Trades worden op de achtergrond uitgevoerd; een order die geld heeft overgebracht en niet wordt uitgevoerd, stuurt dat geld terug naar de wallet, en funds_location geeft aan waar het geld zich bevindt.
De trading-API, inclusief include_trading op accounts en gebruikers, is in bèta. Deze kan zonder nieuwe API-versiedatum veranderen.
Endpoints
Markten
Markten weergeven retourneert elke markt waarop je op Whop kunt handelen.- Spot: weergegeven op symbool:
BTC,SOLenXAUT(goud). - Perpetuals: zoals
BTC, en perpetuals op aandelen en grondstoffen van dexyz-exchange van Hyperliquid, zoalsxyz:TSLA. Stuur deidmee alsmarketwanneer je een trade aanmaakt.
id samen met instrument_type om ze van elkaar te onderscheiden. Resultaten worden gesorteerd op id en daarna op instrument_type.
Dit endpoint is openbaar: er is geen API-sleutel nodig en elk IP-adres kan maximaal 60 verzoeken per minuut doen.
De size van een perpetual order mag maximaal size_decimals decimalen hebben, en de leverage mag maximaal max_leverage zijn, wat null is voor een spotmarkt.
Attributen
Het account dat eigenaar is van de trading-wallet, met prefix
biz_. null
als een gebruiker de eigenaar is.De USDT0 die een deposit, een spotaankoop of een perpetual order met
onvoldoende handelssaldo vanuit de wallet verstuurt, of de USDC die een
withdraw terugstuurt, in native eenheden, als decimale string. Een withdraw van
all toont na afloop wat er is verstuurd. Anders null.De gemiddelde uitvoeringsprijs van de order, in USD, als decimale string. Voor
spot de prijs waartegen de swap is geoffreerd.
null als deze niet bekend is.Het eigen ID van de aanroeper voor de trade, uniek binnen het account.
null
als er geen is meegestuurd.Wanneer de trade is geëindigd als voltooid of mislukt, als ISO
8601-tijdstempel. Daarvoor
null.ID dat Whop met de order van deze trade naar de exchange stuurt, zodat
orderupdates van de exchange aan de trade kunnen worden gekoppeld. Op
Hyperliquid de
cloid van de order die in orderUpdates wordt gerapporteerd,
een hexadecimale string van 32 tekens met prefix 0x. Niet de
client_order_id van de aanroeper. null voor een deposit of withdraw.Waarom de trade is mislukt, of
null.Beschikbare opties: 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_failedDe uitgevoerde omvang van de order, in eenheden van de markt, als decimale
string. Voor een spotaankoop het bedrag dat volgens de offerte van de swap zou
worden geleverd.
null totdat de order is uitgevoerd.Waar het geld is als de trade niet is voltooid zoals gevraagd:
wallet, trading_account, of unknown zolang een medewerker het controleert. Anders null.Beschikbare opties: wallet, trading_account, unknownperpetual of spot voor een order, perpetual voor een close. null voor een deposit of withdraw.Beschikbare opties: perpetual, spotDe cross-leverage die vóór een openende perpetual order is ingesteld.
null
voor een spotorder, close, deposit, withdraw of reduce-only order.De markt, bijvoorbeeld
BTC voor een perpetual of XAUT voor spot. null
voor een deposit of withdraw.market, limit, take_profit of stop_loss voor een order. Anders null.Beschikbare opties: market, limit, take_profit, stop_lossVoor een take-profit of stop-loss die met een order is meegestuurd, de trade
van die order, met prefix
tint_. Anders null.De limietprijs van de order in USD. De prijs van een marktorder is de middenprijs verschoven met
slippage_bps; die van een take-profit of stop-loss is de slechtste prijs waartegen de marktorder na activering mag worden uitgevoerd. null voor andere typen.Eigenschappen
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string.
"10.00" is
bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg
afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling
zelf wordt uitgevoerd.
De orderomvang in eenheden van de markt, als decimale string.
null voor
andere typen.pending totdat de trade begint. processing terwijl deze loopt, ook terwijl een niet-uitgevoerde order het overgebrachte geld terugstuurt naar de wallet. completed als de trade heeft gedaan wat gevraagd werd. failed als dat niet zo is; funds_location geeft aan waar het geld is. in_review als de uitkomst onbekend is en een medewerker het controleert.Beschikbare opties: pending, processing, in_review, completed, failedpartial_fill als de order slechts voor een deel van de omvang is uitgevoerd. Anders null.Beschikbare opties: partial_fillWat een lopende trade nu doet:
depositing terwijl de USDT0 van de wallet naar de bridge wordt gestuurd, landing na het versturen en totdat het geld het handelssaldo bereikt, placing terwijl de order of close bij het handelsplatform ligt, withdrawing terwijl USDC terug naar de wallet gaat, returning terwijl geld dat een niet-uitgevoerde order heeft overgebracht teruggaat. Een spotorder is quoting terwijl de swap wordt geprijsd, swapping terwijl deze onchain wordt uitgevoerd, en crediting totdat het nieuwe saldo in de wallet zichtbaar is. null zodra de trade niet meer pending of processing is.Beschikbare opties: depositing, landing, placing, withdrawing, returning, quoting, swapping, creditingDe prijs in USD waarbij een take-profit of stop-loss de marktorder verstuurt.
null voor andere orders en typen.Eigenschappen
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string.
"10.00" is
bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg
afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling
zelf wordt uitgevoerd.
order plaatst één order: een perpetual order handelt vanuit het handelssaldo, een spotorder wisselt tussen USDT0 en het asset in de wallet. deposit brengt USDT0 over van de wallet naar het handelssaldo. withdraw stuurt USDC van het handelssaldo terug naar de wallet. close sluit de volledige positie in één markt met een reduce-only marktorder; als het account daarna geen posities meer heeft, stuurt een withdraw-trade het handelssaldo terug naar de wallet.Beschikbare opties: close, order, deposit, withdrawTrade

