Skip to main content
En 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, SOL og XAUT (guld).
  • Perpetuals: f.eks. BTC samt aktie- og råvare-perpetuals fra Hyperliquids xyz-børs, f.eks. xyz:TSLA. Send id som market, når du opretter en trade.
Det samme symbol kan optræde to gange, én gang som perpetual og én gang som spot, så brug 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.
Markedslisten er i beta ligesom resten af handels-API’et og kan ændres uden en ny API-versionsdato.

Attributter

string
påkrævet
Trade-id med præfikset tint_.
string | null
påkrævet
Den konto, der ejer handels-wallet’en, med præfikset biz_. null, når en bruger ejer den.
string | null
påkrævet
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.
string | null
påkrævet
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.
string | null
påkrævet
Kalderens eget id for traden, unikt for kontoen. null, når der ikke blev sendt noget.
string | null
påkrævet
Hvornår traden endte som gennemført eller mislykket, som et ISO 8601-tidsstempel. null før da.
string
påkrævet
Hvornår traden blev oprettet, som et ISO 8601-tidsstempel.
string | null
påkrævet
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.
string | null
påkrævet
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_failed
string | null
påkrævet
Den 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.
string | null
påkrævet
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, unknown
string | null
påkrævet
perpetual eller spot for en ordre, perpetual for en close. null for en deposit eller withdraw.Tilgængelige muligheder: perpetual, spot
integer | null
påkrævet
Den cross-gearing, der er sat før en åbnende perpetual-ordre. null for en spotordre, close, deposit, withdraw eller reduce-only-ordre.
string | null
påkrævet
Markedet, for eksempel BTC for en perpetual eller XAUT for spot. null for en deposit eller withdraw.
object
påkrævet
Frie streng-til-streng-annotationer gemt på traden.
string
påkrævet
string | null
påkrævet
market, limit, take_profit eller stop_loss for en ordre. Ellers null.Tilgængelige muligheder: market, limit, take_profit, stop_loss
string | null
påkrævet
For en take-profit eller stop-loss sendt med en ordre: den ordres trade, med præfikset tint_. Ellers null.
object | null
påkrævet
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

string
påkrævet
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.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
boolean | null
påkrævet
Om ordren kun kan reducere en position. null for andre typer.
string | null
påkrævet
buy eller sell for en ordre. Ellers null.Tilgængelige muligheder: buy, sell
string | null
påkrævet
Ordrestørrelsen i markedets enheder som en decimalstreng. null for andre typer.
string
påkrævet
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, failed
string | null
påkrævet
partial_fill, når ordren kun blev udfyldt for en del af sin størrelse. Ellers null.Tilgængelige muligheder: partial_fill
string | null
påkrævet
Hvad 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, crediting
object | null
påkrævet
Den pris i USD, hvor en take-profit eller stop-loss sender sin markedsordre. null for andre ordrer og typer.

Egenskaber

string
påkrævet
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.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
string
påkrævet
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, withdraw
string
påkrævet
Hvornår traden sidst blev ændret, som et ISO 8601-tidsstempel.
string | null
påkrævet
Den bruger, der ejer handels-wallet’en, med præfikset user_. null, når en konto ejer den.
Trade