En handelsbot för Hyperliquid-perpetualer hanterar derivatexponering genom order, avslut och säkerhetstillgångar. Att köpa ett evigt terminskontrakt innebär inte att förvärva motsvarande spottoken för uttag. Positionens värde ändras med kontraktet och driftkraven omfattar marginal, finansiering och möjlig likvidation. Dessa egenskaper gör ett flöde för spotinnehav otillräckligt i sig.
Tillförlitlig automation börjar med en beständig beskrivning av den avsedda positionsförändringen. Därefter verifierar den instrument och konto, kontrollerar tillämpliga resurser, skickar en avgränsad åtgärd och stämmer av vad som faktiskt hände. Strategin bör fortsätta förstå sina förpliktelser när en order bara fylls delvis, en annullering tävlar med en affär eller processen startar om.
Detta är allmän utbildning om mekaniken för eviga terminskontrakt, inget påstående att någon särskild programvara stöder den. Alla räkneexempel är hypotetiska och utelämnar komplexitet endast där det uttryckligen anges. Ingen hävstångsnivå, finansieringsränta eller förväntad avkastning rekommenderas.
Definiera orderlivscykeln för en handelsbot för Hyperliquid-perpetualer
Livscykeln börjar med en avsedd förändring i exponering med riktning: exempelvis öka en lång position, minska en kort eller stänga ett angivet belopp. Avsikten bör identifiera instrument, konto, högsta storlek, prisbegränsning och policyversion. En allmän köpetikett beskriver inte hela det ekonomiska målet.
Håll inskickade, accepterade, vilande, delvis fyllda, slutförda och annullerade utfall åtskilda. Det exakta API-underlaget avgör vilka etiketter som gäller. Ett lyckat transportsvar bevisar inte i sig att hela den avsedda kvantiteten blev en position.
Översikten över genomförande på Hyperliquid förklarar vikten av att välja rätt tjänsteyta och konto. För eviga terminskontrakt ska ramverket kopplas till en positionsbok i stället för att ersättas med ett spotsaldo. Boken måste bevara både aktuell exponering och den ytterligare exponering som återstående aktiva order kan skapa.
Fastställ exakt kontrakt och handelsplats
En tillgångssymbol kan förekomma i mer än en produkt eller marknadsmiljö. Boten bör fastställa den faktiska perpetualidentifieraren, relevant handelsplats eller driftsättning, noterings- eller säkerhetstillgång och stödd storleks- och prisprecision. En bekant kortsymbol räcker inte för korrekt orderkonstruktion.
Aktuell Hyperliquid-dokumentation skiljer bland annat validerardrivna eviga terminskontrakt och HIP-3-marknader från andra delar av ekosystemet. Kontraktsparametrar och tillgängliga relationer för säkerhetstillgångar bör hämtas ur faktiska marknadsmetadata. Tillämpa inte en ihågkommen parameter från ett instrument universellt på varje kontrakt med liknande namn.
Bevara metadata som användes för att auktorisera varje åtgärd. Om en marknadskonfiguration ändras bör den gamla posten förbli tolkningsbar. En senare uppslagning kan förklara aktuellt beteende utan att återskapa villkoren när en tidigare order förbereddes. Skillnaden spelar roll vid undersökning av en avvisning eller oväntad kvantitet.
Läs det aktiva kontoläget
Aktuell dokumentation som nås genom Hyperliquids officiella webbplats beskriver standardkonton, enhetliga konton och konton med portföljmarginal. Deras saldo- och säkerhetsrelationer skiljer sig. En bot bör läsa aktivt läge i stället för att anta att spot- och perpetualresurser alltid är separerade eller alltid delas.
I enhetliga upplägg och upplägg med portföljmarginal kan den dokumenterade saldovyn och reservationer omfatta verksamheter som en rapport enbart för spot eller per DEX inte skulle fånga korrekt. En strategi kan därför se en attraktiv lokal möjlighet medan det bredare kontot redan har bundit resurserna som krävs för den.
Behandla kontoläget som en del av driftavtalet. Ett lägesbyte kan ändra tolkningen av saldon och gränser även när samma strategi är aktiv. Stäm av kontot efter ett sådant byte innan ny exponering auktoriseras utifrån antaganden som hörde till det tidigare upplägget.
Skilj strategigränser från börsmarginal
Att en börs accepterar en order fastställer inte att den passar användarens riskpolicy. Plattformens marginalkrav och strategins högsta tillåtna exponering besvarar olika frågor. En försiktig intern gräns kan avvisa en order som kontot tekniskt har tillräcklig säkerhet för att lägga.
I ett förenklat fiktivt exempel skapar tre enheter av ett linjärt evigt terminskontrakt vid 200 en nominell exponering på 600. Om exemplet avsätter 120 i marginal är det fem gångers hävstång mellan nominellt belopp och marginal vid inträde. En ogynnsam prisrörelse på tio procent skapar en prisförlust på sextio enheter före avgifter och finansiering och förbrukar hälften av det illustrativa marginalbeloppet.
Beräkningen är ingen formel för likvidationspris. Faktisk likvidation beror på instrument, marginalläge, kontotillstånd och underhållskrav. Exemplet visar varför en liten säkerhetsavsättning inte gör den ekonomiska positionen liten. Positionsstorlek och tillåten förlust behöver egna uttryckliga gränser.
Välj orderbeteende som passar avsikten
En limit anger en prisgräns medan giltighetsvillkoret avgör vad som händer med kvantiteter som inte genomförs omedelbart. Hyperliquids aktuella orderdokumentation skiljer vilande beteende, omedelbart-eller-annullera och enbart orderläggande beteende åt. Adaptern bör bevara användarens avsedda kombination i stället för att översätta varje begäran till ett standardval.
En omedelbart-eller-annullera-order kan fyllas delvis och få återstoden annullerad. En enbart orderläggande instruktion syftar till att undvika att omedelbart ta befintlig likviditet; den garanterar inte att en vilande order senare fylls eller blir lönsam. Skillnaden spelar roll vid uppskattning av både exponering och genomförandekostnader.
Guiden till API-hantering på Hyperliquid förklarar varför utfall måste tolkas per åtgärd. Strategin bör reagera på det accepterade resultatet för den faktiska ordern. Den bör inte härleda en full position från att en begäran innehöll önskad kvantitet.
Bevara decimalavsikten genom konstruktionen
Pris- och storleksbegränsningar bör behålla avsedd precision från strategibeslut till signerad åtgärd. Godtycklig avrundning kan öka exponering, flytta en limit över spreaden eller skapa en ogiltig begäran. Korrekt avrundningsriktning beror på vilken gräns värdet representerar.
Ett högsta tillåtet köpbelopp bör exempelvis inte avrundas uppåt bara för att passa en visningspreferens. En stängningsinstruktion bör kontrolleras mot aktuell position och stött kvantitetssteg. Gränssnittet kan visa ett kortare tal medan den beständiga posten bevarar det exakta auktoriserade värdet.
Validering bör ske före signering. Om en kvantitet inte kan representeras enligt marknadens aktuella regler bör systemet ge en uttrycklig avvisning eller ett separat motiverat minskat belopp. Tyst justering efter auktorisering gör det svårt att fastställa om den genomförda åtgärden fortfarande följer användarens policy.
Håll signeraren åtskild från handelskontot
En delegerad agent kan signera åtgärder för ett konto utan att vara det konto vars positioner och saldon ska efterfrågas. Den officiella dokumentationen för API-plånböcker framhåller skillnaden. Att läsa agentadressen som om den innehöll handelskontot kan ge ett tomt resultat och ett falskt intryck av att ingen exponering finns.
Lagra signeraridentitet och ekonomisk kontoidentitet i olika fält. Orderposten bör också identifiera eventuellt tillämpligt underkonto eller annan stödd omfattning. Det hindrar en lyckad autentiseringskontroll från att misstas för bekräftelse på att strategin arbetar med avsedd portfölj.
Samordna protokollets noncekrav per signeringsbefogenhet. HyperCores noncemodell för signerade åtgärder bör inte ersättas med en antagen EVM-transaktionssekvens. Flera arbetare som delar signerare behöver en samordnad modell, medan separat signeringsbefogenhet kräver egen behörighets- och livscykelhantering.
Behandla ett obesvarat inskickande som olöst
Ett förlorat svar lämnar en fråga om den ursprungliga åtgärden. Det fastställer inte att åtgärden misslyckades eller att en ny order är säker. Bevara den beständiga avsikten och tillgängliga orderidentifierare före externt inskickande så att återhämtningen kan undersöka samma ekonomiska begäran.
Använd aktuellt konto- och orderunderlag för att avgöra om åtgärden skapade en vilande order, fylldes, avvisades eller förblir okänd. En klientorderidentifierare kan hjälpa till att koppla samman poster men bör inte beskrivas som en universell garanti att varje upprepad nyttolast saknar ytterligare effekt. Följ den faktiska slutpunktens dokumenterade beteende.
Behåll lämpligt resurs- och exponeringsutrymme medan utfallet är olöst. Att frigöra det omedelbart kan låta en annan arbetare auktorisera en andra position. Återhämtningens mål är att fastställa vad kontot redan kan innehålla, inte bara att få ett lyckat svar från en ny begäran.
Bygg exponering från avslut och återstående order
Begärd kvantitet, fylld kvantitet och öppen återstod är separata värden. Om en hypotetisk order begär fem enheter och fyller två följt av en halv enhet är positionsförändringen 2,5 och återstående begärd kvantitet 2,5 tills slutligt ordertillstånd fastställts.
Kontots riskgranskning bör omfatta både aktuell exponering på 2,5 enheter och återstodens möjliga effekt. En annulleringsbegäran kan syfta till att ta bort den senare, men posten bör inte radera den innan accepterat ordertillstånd bekräftar vad som hände.
Ta bort dubbletter av avslutsunderlag när flöden spelas om eller historiska frågor överlappar. Att räkna samma halvenhetsavslut två gånger skulle överskatta positionen och kan leda till en för stor stängningsåtgärd. Bevara stabil avslutsidentitet och stäm av totaler mot den auktoritativa kontovyn i stället för att anta att varje mottaget meddelande beskriver en ny affär.
Hänvisa och tjäna USDC
Hänvisa och tjäna USDCVårt affiliateprogram betalar i realtid.
Utforma enbart reducerande avslut för Hyperliquid-perpetualer
Enbart reducerande avslut i en handelsbot för Hyperliquid-perpetualer bör uttrycka avsikten att minska en befintlig position utan att öppna exponering i motsatt riktning. De aktuella orderalternativen omfattar denna kontroll. Den är användbar när en annan åtgärd kan ha ändrat positionen innan avslutet genomförs.
Anta att ett fiktivt konto var långt tre enheter när ett avslut förbereddes, men att en annan auktoriserad försäljning minskat det till en. En obegränsad försäljning av tre kan stänga den återstående långa positionen och skapa en kort position på två enheter. En korrekt tillämpad enbart reducerande begränsning motverkar den oönskade vändningen, med förbehåll för börsens faktiska acceptans- och genomföranderegler.
Enbart reducerande garanterar inte att ett avslut slutförs eller får ett visst pris. Ordern kan fortfarande möta otillräcklig matchande likviditet, ogiltiga parametrar eller andra avvisningsvillkor. Boten måste stämma av återstående position efter försöket i stället för att behandla flaggans närvaro som bevis på att risken försvunnit.
Skilj en avslutssignal från ett genomfört avslut
Ett stopp- eller vinsthemtagningsvillkor kan aktivera en order utan att slutföra en avyttring. Utlösningsreferens, prisvillkor, resulterande ordertyp och storlek bör vara uttryckliga. Olika val skapar olika avvägningar mellan priskontroll och sannolikhet för genomförande under föränderliga förhållanden.
En utlöst limitorder kan förbli ofylld om marknaden rör sig utanför dess godtagbara intervall. Ett marknadsinriktat avslut kan få sämre genomförande än den observerade utlösningsnivån. Ingetdera bör presenteras som en garanterad högsta förlust eller garanterad realiserad vinst.
Följ positionen genom aktivering och efterföljande avslut. Om bara en del stängs kräver återstående kvantitet fortsatt hantering. Avslutskontrollen bör också beakta manuell aktivitet eller en annan strategis åtgärd så att gamla utlösningsstorlekar inte tyst blir oförenliga med aktuellt konto.
Hantera annullering som en kapplöpning med marknaden
En order kan fyllas medan en annulleringsbegäran är på väg. Den korrekta slutposten kan därför innehålla ett delavslut och en annullerad återstod. Utfallen är förenliga; annulleringen tar inte retroaktivt bort affären som redan skedde.
Vid orderersättning ska det fastställas vad som återstår av den gamla instruktionen innan ersättningens storlek bestäms. En lokalt önskad kvantitet och börsens aktuella återstod kan skilja sig under intervallet. Att behandla ersättningen som en orelaterad fullstor order kan skapa överexponering.
Guiden till operativ återhämtning på Hyperliquid förklarar varför förpliktelser behöver tydligt ägarskap. En komponent bör avgöra hur gammal order, mellanliggande avslut och föreslagen ändring hänger samman. Flera arbetare som självständigt reparerar samma annullering kan skapa mer osäkerhet än den ursprungliga fördröjningen.
Håll finansieringsredovisningen för Hyperliquid-perpetualer separat
Finansiering är en kassaflödeskomponent i perpetualexponering, skild från vinst eller förlust orsakad av in- och utträdespriser. Aktuell finansieringsdokumentation beskriver betalningar mellan innehavare av långa och korta positioner och använder orakelbaserat nominellt belopp i betalningsberäkningen. Ersätt inte det med en visad marknadsvärdering utan att kontrollera faktisk konvention.
För ett fiktivt intervall representerar två enheter till ett orakelpris på 500 ett nominellt finansieringsbelopp på 1 000. En antagen betalningsränta på 0,01 % ger en betalning på 0,1. Sex identiska intervall skulle totalt ge 0,6, men verkliga räntor, priser och positionsstorlekar kan ändras mellan observationer.
Exempelräntan är påhittad och förutspår ingen betalningsriktning. Registrera faktiska krediteringar och debiteringar från kontounderlag, kopplade till relevant period och position. En finansieringsprognos kan informera ett beslut men är inte samma sak som finansiering som redan tjänats in eller betalats.
Stäm av prisresultat, avgifter och finansiering
Håll komponenterna separata innan nettoresultatet beräknas. I en förenklad hypotetisk lång position ger två enheter köpta vid 500 och sålda vid 520 fyrtio i bruttoprisvinst. Om registrerade handelskostnader totalt är tre och nettofinansieringen är en debitering på 1,2 är resultatet 35,8 före andra tillämpliga kostnader.
En lönsam prisrörelse kan därför samexistera med en mindre kontovinst och ett oförändrat prisutfall kan ändå förlora pengar efter kostnader. Boken bör synliggöra skillnaderna i stället för att pressa in alla saldoändringar i en enda siffra för realiserade affärer.
Använd de faktiska säkerhets- och avgiftstillgångarna som rapporteras för relevant marknad och konto. Om omräkning till en rapporteringsvaluta behövs ska värderingstidpunkt och ursprungliga kvantiteter bevaras. Förändringar i rapporteringstillgångens värde bör inte misstas för förbättrat genomförande av själva perpetualstrategin.
För en bok över delstängningar
Ett delavslut bör fördela positionens ekonomi konsekvent och samtidigt bevara återstående exponering. Betrakta en påhittad lång position på två enheter öppnad vid 500. Stängning av 0,75 vid 510 skapar en prisvinst på 7,5. Återstående 1,25 som senare stängs vid 498 förlorar 2,5, vilket lämnar fem i bruttoprisvinst över hela positionen.
Om sammanlagda avgifter är 1,8 och finansieringen en debitering på 0,4 är det fullständiga nettoresultatet 2,8. Att bara rapportera första lönsamma avyttringen skulle väsentligt överdriva utfallet. Att rapportera hela tvåenhetspositionen som stängd efter första avslutet skulle också radera återstående risk.
Kontometoder kan skilja sig i hur de presenterar genomsnittligt ingångspris och realiserade komponenter, så lokal rekonstruktion bör följa dokumenterad konvention och stämmas av mot kontot. Bevara underliggande avslut och kassaflöden även när användarrapporten visar en enklare sammanfattning.
Övervaka marginal utan att hitta på en fast likvidationsbuffert
Likvidationsrisk beror på aktuell exponering, säkerhetsrelationer och underhållsregler. Ett procentavstånd från ett gammalt ingångspris är inget fullständigt mått. Andra positioner, finansiering och ändrat kontovärde kan påverka tillgängliga resurser i det aktiva marginalupplägget.
Använd relevant aktuellt kontounderlag och instrumentparametrar. En beräknad uppskattning bör ange sina antaganden och inte visas som garanti att likvidation inte kan ske före ett visst pris. Snabba förändringar och olika referenspriser kan göra en förenklad gräns missvisande.
Strategin bör definiera vad den gör när nödvändigt marginalunderlag saknas. Att fortsätta öka exponeringen för att senast registrerad buffert såg betryggande ut kan förstärka osäkerhet. Att pausa ny risk medan observation och auktoriserad positionshantering fortsätter är en annan åtgärd än att anta att en öppen position blivit säker bara för att boten pausats.
Rekonstruera kontot före återupptagning efter omstart
Uppstart bör återhämta beständiga avsikter, accepterade orderidentifierare, öppna återstoder, avslut, finansieringshändelser och relevanta överföringar. Den bör sedan jämföra rekonstruktionen med aktuellt kontotillstånd. En fungerande anslutning ensam fastställer inte att strategin känner sina befintliga förpliktelser.
Manuell aktivitet måste ingå. Om användaren minskade en position medan processen var offline bör boten inte automatiskt återställa den gamla storleken för att passa sitt inaktuella lokala minne. Den externa kontoändringen är belägg för ändrat drifttillstånd och kan kräva ett nytt policybeslut.
Återuppta nya positionsöppningar först när nödvändiga poster stöder dem. Oförklarade skillnader bör förbli synliga med en definierad undersökningsomfattning. Att tyst skriva över den lokala boken med en aktuell totalsiffra kan dölja dubbla avslut, saknade kostnader eller en annullerad order som fylldes delvis innan den försvann från listan över öppna order.
Öva ett avbrutet avslut
En användbar fiktiv övning börjar med en lång position på tre enheter och en enbart reducerande begäran att stänga två. Anslutningen bryts efter inskickandet. Under luckan fylls 1,5 enheter och den återstående halvenhetsordern annulleras senare. Korrekt resulterande position är en lång position på 1,5 enheter, om ingen annan aktivitet skett.
Återhämtningen bör hitta både avslutet och den annullerade återstoden. Den bör varken anta att de avsedda två enheterna stängdes eller skicka ett nytt tvåenhetsavslut enbart för att ursprungligt svar saknades. Ytterligare minskning bör baseras på aktuell position på 1,5 enheter och aktiv policy.
Utöka övningen genom att spela om samma avslutsmeddelande. Exponeringen bör förbli oförändrad efter dubblettrensning. Scenariot prövar flera viktiga gränser samtidigt: beständig identitet, delvis genomförande, annullering, omstart och skydd mot oavsiktlig vändning. Testet lyckas när slutkontot förklaras, inte när varje begäran besvaras snabbt.
Utvärdera automation genom positionen den lämnar
En perpetualbot bör bedömas efter om dess positions- och resursposter förblir korrekta under vanlig och avbruten drift. Snabba begäranden är användbara först när appen kan identifiera kontot, tolka varje utfall och förklara exponeringen som återstår.
Granska slutförda och olösta försök tillsammans. Registrera hur ofta strategin krävde återhämtning, vilka antaganden som ändrades och om interna gränser höll vid samtidighet. Håll handelsresultat åtskilda från operativ korrekthet så att en gynnsam marknadsrörelse inte döljer en bristfällig orderlivscykel.
En begriplig handelsbot för Hyperliquid-perpetualer kopplar en avgränsad avsikt till faktiska avslut, erkänner finansiering som eget kassaflöde och hanterar avslut mot aktuella positioner. Dessa principer tar inte bort derivatrisk men ger användaren en sammanhängande grund för att avgöra vad kontot får göra härnäst.