Skip to main content
Een 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, SOL en XAUT (goud).
  • Perpetuals: zoals BTC, en perpetuals op aandelen en grondstoffen van de xyz-exchange van Hyperliquid, zoals xyz:TSLA. Stuur de id mee als market wanneer je een trade aanmaakt.
Hetzelfde symbool kan twee keer voorkomen, één keer als perpetual en één keer als spot, dus gebruik 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.
De marktlijst is, net als de rest van de trading-API, in bèta en kan zonder nieuwe API-versiedatum veranderen.

Attributen

string
vereist
Trade-ID, met prefix tint_.
string | null
vereist
Het account dat eigenaar is van de trading-wallet, met prefix biz_. null als een gebruiker de eigenaar is.
string | null
vereist
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.
string | null
vereist
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.
string | null
vereist
Het eigen ID van de aanroeper voor de trade, uniek binnen het account. null als er geen is meegestuurd.
string | null
vereist
Wanneer de trade is geëindigd als voltooid of mislukt, als ISO 8601-tijdstempel. Daarvoor null.
string
vereist
Wanneer de trade is aangemaakt, als ISO 8601-tijdstempel.
string | null
vereist
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.
string | null
vereist
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_failed
string | null
vereist
De 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.
string | null
vereist
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, unknown
string | null
vereist
perpetual of spot voor een order, perpetual voor een close. null voor een deposit of withdraw.Beschikbare opties: perpetual, spot
integer | null
vereist
De cross-leverage die vóór een openende perpetual order is ingesteld. null voor een spotorder, close, deposit, withdraw of reduce-only order.
string | null
vereist
De markt, bijvoorbeeld BTC voor een perpetual of XAUT voor spot. null voor een deposit of withdraw.
object
vereist
Vrije string-naar-string-annotaties die bij de trade zijn opgeslagen.
string
vereist
string | null
vereist
market, limit, take_profit of stop_loss voor een order. Anders null.Beschikbare opties: market, limit, take_profit, stop_loss
string | null
vereist
Voor een take-profit of stop-loss die met een order is meegestuurd, de trade van die order, met prefix tint_. Anders null.
object | null
vereist
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

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. "10.00" is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
Valutacode volgens ISO 4217 van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen je moet TONEN. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso’s geschreven, dus het is 2 en 0. Formatteer het getal hiermee in je eigen locale.
boolean | null
vereist
Of de order een positie alleen kan verkleinen. null voor andere typen.
string | null
vereist
buy of sell voor een order. Anders null.Beschikbare opties: buy, sell
string | null
vereist
De orderomvang in eenheden van de markt, als decimale string. null voor andere typen.
string
vereist
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, failed
string | null
vereist
partial_fill als de order slechts voor een deel van de omvang is uitgevoerd. Anders null.Beschikbare opties: partial_fill
string | null
vereist
Wat 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, crediting
object | null
vereist
De prijs in USD waarbij een take-profit of stop-loss de marktorder verstuurt. null voor andere orders en typen.

Eigenschappen

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. "10.00" is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
Valutacode volgens ISO 4217 van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen je moet TONEN. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso’s geschreven, dus het is 2 en 0. Formatteer het getal hiermee in je eigen locale.
string
vereist
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, withdraw
string
vereist
Wanneer de trade voor het laatst is gewijzigd, als ISO 8601-tijdstempel.
string | null
vereist
De gebruiker die eigenaar is van de trading-wallet, met prefix user_. null als een account de eigenaar is.
Trade