For at udføre Kalshi-handler automatisk behøver et program mere end et signal og tilladelse til at sende anmodninger. Det har brug for udførelsesregler, som angiver, hvilken kontrakt der skal handles, hvor meget eksponering der er tilladt, hvilke priser der er acceptable, og hvad der skal ske, når kontoudfaldet afviger fra den oprindelige plan.
Udførelseskvalitet handler delvis om at opnå en acceptabel pris, men også om at vide, hvad der skete. En billig gennemførelse kan stadig være driftsmæssigt problematisk, hvis botten gentager den efter en timeout eller overser en aktiv rest.
Denne vejledning følger en godkendt beslutning om en hændelseskontrakt på et forudsigelsesmarked gennem kontroller, indsendelse og rekonstruktion. Den vedrører ikke andre Kalshi-produkttyper. Taleksemplerne er illustrative, og aktuel API-adfærd bør altid kontrolleres mod den relevante officielle reference.
Definér instruktionen, før Kalshi-handler udføres automatisk
Instruktionen bør udtrykke en økonomisk hensigt uafhængigt af et bestemt anmodningsformat. Identificér kontrakt, ønsket retning, maksimal yderligere mængde, prisgrænse og begrundelsen for, at handlingen stadig er gyldig. Angiv også, hvornår bemyndigelsen udløber.
En retningsbetegnelse som køb er ufuldstændig uden et udfald og en kontosammenhæng. Implementeringen skal omsætte den tilsigtede eksponering til handelsstedets aktuelle repræsentation og derefter verificere, at den omsatte handling har den tilsigtede økonomiske virkning.
Den maksimale yderligere mængde er noget andet end en ønsket slutposition. Hvis kontoen allerede har ti kontrakter, og målet er 80, overskrider et køb af yderligere 80 målet. En målbaseret instruktion skal trække verificerede beholdninger fra og tage højde for relevante aktive ordrer.
Hold beslutningsidentiteten stabil, selv hvis systemet gør flere tekniske forsøg på at udføre den. Genforsøg, ændringer og annulleringsforsøg bør forblive sporbare til den økonomiske bemyndigelse, der begrundede dem.
Vejledningen om algoritmisk handel på forudsigelsesmarkeder adskiller strategiregler fra implementering. En udførelsesinstruktion er broen mellem dem: konkret nok til at begrænse en handling, men tydelig nok til, at en kontrollant kan forstå den uden at afkode en netværksmeddelelse.
Udfør Kalshi-handler automatisk med markedskontroller
Udfør Kalshi-handler automatisk med markedskontroller, der skelner den valgte kontrakt fra den bredere børs. En fungerende forbindelse beviser ikke, at det konkrete marked aktuelt accepterer den tilsigtede handling.
Kontrollér markedets aktuelle handelstilstand, relevante lukketid og enhver betingelse, der ugyldiggør strategiens bemyndigelse. En kontrakt kan stadig være genkendelig og læsbar, efter at dens normale handelsmulighed er slut. At finde den er ikke i sig selv tilladelse til indsendelse.
Den bredere børs kan også pålægge begrænsninger. Kalshis dokumentation om vedligeholdelse og pauser skelner mellem forskellige afbrydelsesforhold. Udførelseslogikken bør følge den relevante tilstands aktuelle muligheder frem for at bruge ét udifferentieret online-flag.
Kontrollen er en nylig observation, ikke en lås på fremtidig adfærd. Markedstilstanden kan ændre sig mellem validering og indsendelse. Anmodningsudfaldet skal derfor fortolkes, selv når de forudgående kontroller bestod.
Gem begrundelsen for, at et forslag blev afvist lokalt. Forældede oplysninger, et lukket marked og utilstrækkelige ressourcer kræver forskellige opfølgningshandlinger. En tydelig afvisningsregistrering hjælper ejeren med at forstå, hvorfor automatiseringen ikke handlede, uden at tilskynde til blinde genforsøg mod et utilgængeligt marked.
Udfør Kalshi-handler automatisk med prisgrænser
Udfør Kalshi-handler automatisk med prisgrænser, der beskriver den højeste acceptable købspris eller laveste acceptable salgspris for den tilsigtede eksponering. En prisgrænse beskytter én dimension af anmodningen. Den garanterer ikke en gennemførelse eller et gunstigt resultat.
Brug priser, der er tilgængelige for den ønskede transaktion. Det højeste købsbud er et tilbud om at købe, ikke automatisk en pris, som en anden køber kan erhverve samme udfald til. En midtpris er et nyttigt resumé i nogle analyser, men kan ikke nødvendigvis handles til.
Overvej en hypotetisk købsinstruktion på op til 80 kontrakter med en maksimal pris på 43 cent. De synlige salgstilbud omfatter 25 til 41 cent, 35 til 42 cent og yderligere 20 til 44 cent. Kun de første 60 opfylder prisgrænsen.
Deres samlede købsbeløb ville være 10 dollar og 25 cent plus 14 dollar og 70 cent, altså 24 dollar og 95 cent før omkostninger. De resterende 20 er ikke acceptable, blot fordi strategien oprindeligt ønskede 80.
Strategivejledningen til forudsigelsesmarkeder forklarer, hvorfor værdi afhænger af pris og omkostninger. Udførelseslaget bevarer denne vurdering ved at nægte at udvide den godkendte grænse blot for at rapportere en fuldført mængde.
Vælg, hvad en ugennemført rest skal gøre
Gyldighedsbetingelser for en ordre afgør, om ugennemført mængde kan forblive aktiv eller skal ophøre efter den valgte udførelsesbetingelse. Beslutningen hører til i reglerne før indsendelse, fordi den ændrer, hvor længe kontoen er udsat for fremtidige gennemførelser.
En hvilende ordre kan vente på likviditet, men kan blive gennemført, efter at de oprindelige oplysninger er blevet mindre nyttige. Regler om øjeblikkelig udførelse kan undgå en langvarig rest og samtidig acceptere, at kun en del af eller intet af den ønskede mængde erhverves.
En alt-eller-intet-betingelse har et andet formål: den kan kræve, at hele den anmodede mængde er tilgængelig efter ordrens regler. Den lover ikke, at betingelsen opfyldes, og gør ikke en senere uafhængig ordre til en del af samme transaktion.
Læs de aktuelt understøttede valg i referencen for oprettelse af hændelsesordrer. Velkendte betegnelser fra en anden børs eller en ældre klient bør ikke indsættes uden kontrol af deres præcise betydning og gyldige kombinationer.
I eksemplet med 80 kontrakter har forskellen betydning. Ét regelsæt kan ende med 60 gennemførte og ingen aktiv rest, mens et andet kan efterlade 20, der kan gennemføres senere. Begge kan overholde prisgrænsen på 43 cent, men de skaber forskellige løbende forpligtelser.
Reservér ressourcer til hele den bemyndigede anmodning
Før indsendelse skal der tages højde for de ressourcer, som anmodningen kan forbruge, hvis den udføres fuldt inden for sine grænser. Hvis kun de billigste synlige kontrakter tælles, kan det undervurdere den forpligtelse, en aktiv ordre senere må skabe.
I den illustrative anmodning på 80 kontrakter med et loft på 43 cent er det maksimale købsbeløb 34 dollar og 40 cent før udgifter. En antaget udgiftsmargin på 60 cent ville bringe det reserverede beløb efter reglerne op på 35 dollar. Det er undervisningsantagelser, ikke aktuelle gebyrvilkår.
Den synlige mulighed på 60 kontrakter kan koste mindre, men en resterende ordre kan stadig have betydning. Ressourcer reserveret til denne mulighed bør ikke samtidig bemyndige en anden strategi til at bruge det samme beløb.
Skeln tilgængelige kontoressourcer fra en lokal prognose for tilgængelighed. En anden ordre, en manuel handling eller en kontoopdatering kan ændre, hvad der stadig kan bruges. Reservationslogikken bør kombinere verificeret kontodokumentation med programmets udestående forpligtelser.
En afvist anmodning bør først frigive sin lokale reservation, når udfaldet er tilstrækkeligt forstået. En usikker timeout kan stadig repræsentere en accepteret ordre. Hvis hele dens budget straks returneres til den tilgængelige pulje, kan næste instruktion overforpligte kontoen.
Kontrollér for modstridende aktive ordrer
En konto kan indeholde flere strategier eller manuelle ordrer i samme kontrakt. En ny anmodning bør vurderes mod disse eksisterende forpligtelser frem for, som om den var den eneste aktivitet på handelsstedet.
Modsatrettede ordrer kan skabe utilsigtet selvhandel eller forbruge kapacitet på måder, strategien ikke forventede. Ordrer i samme retning kan akkumulere eksponering ud over en tilsyneladende grænse pr. ordre. Det relevante spørgsmål er, hvad kontoen kunne have i beholdningen, efter at alle tilladte ordrer har virket.
Brug handelsstedets understøttede kontrol mod selvhandel, hvor det er passende, men behandl den ikke som en erstatning for koordinering. En kontrol på handelsstedet kan ændre udførelsesadfærden uden at afgøre, hvilken af to strategier der skal eje det tilgængelige risikobudget.
Ejeren bør definere, om strategier må konkurrere om samme kontrakt, dele en central ressourcefordeler eller kræve eksklusiv styring. Dette styringsvalg påvirker, hvordan udførelseslaget godkender en ny instruktion og løser konflikter.
En nyttig gennemgangsregistrering identificerer de aktive ordrer, der blev overvejet ved godkendelsen af anmodningen. Hvis kontoen senere overskrider en forventet eksponering, hjælper dokumentationen med at skelne en forældet observation fra en fordelingsregel, der aldrig medregnede de samlede forpligtelser.
Indsend en identificeret hensigt frem for et anonymt forsøg
Gem den godkendte hensigt varigt, før anmodningen sendes. Dens identifikator bør forbinde beslutningen, den tekniske anmodning og enhver resulterende ordredokumentation. Ellers kan en procesafbrydelse efterlade en aktiv ordre uden en varigt gemt forklaring på, hvorfor den findes.
Brug den dokumenterede mekanisme til klientordreidentitet konsekvent. Dens præcise adfærd skal følge af API'et. Den bør ikke beskrives som en universel garanti for, at vilkårligt gentagne anmodninger aldrig kan skabe dobbelt økonomisk aktivitet.
En beslutning om genforsøg skal skelne et forsøg, der med sikkerhed ikke bestod validering, fra et forsøg med ukendt resultat. Det første kan tillade en rettet anmodning under samme økonomiske regler. Det andet kræver afstemning, før en ny handling bemyndiges.
Registrér nok kontekst til at rekonstruere forsøget, herunder kontoområde, kontrakt, tilsigtet mængde og prisgrænse. Følsomme legitimationsoplysninger hører ikke til i almindelige aktivitetslogfiler, selv når anmodningsdiagnostik er nyttig.
Vejledningen om bot-API'er til forudsigelsesmarkeder beskriver, hvordan en klientgrænseflade kan bevare disse betydninger. Det vigtige resultat er en varig forbindelse fra ejerens bemyndigelse til hvert forsøg, der gøres på dens vegne.
Fortolk svaret uden at udvide dets betydning
Et vellykket svar er dokumentation om anmodningen efter endepunktets dokumenterede svarstruktur. Det bør ikke ophøjes til en påstand om, at hele den ønskede position er erhvervet, medmindre de rapporterede fakta fastslår dette resultat.
Aktuelle svarfelter kan omfatte identifikatorer, gennemførte mængder og en resterende mængde uden at returnere alle detaljer, som kontoregnskabet behøver. Klienten bør bevare svaret og indhente den yderligere dokumentation, der er nødvendig for at forklare ordrens senere tilstand.
En øjeblikkelig afvisning bør bevare sin årsag. En forkert udformet anmodning, et ressourceproblem og et utilgængeligt marked er forskellige fejl. Gentagen indsendelse af en uændret anmodning kan spilde kapacitet og sløre problemet uden at forbedre chancen for et gyldigt resultat.
En transportfejl er igen noget andet. Botten ved måske ikke, om handelsstedet behandlede anmodningen. Dens interne tilstand bør være ukendt frem for afvist eller gennemført, indtil yderligere dokumentation afklarer tvetydigheden.
Udførelsesreglerne bør definere, hvilke svarfakta der tillader hver næste handling. Det forhindrer en generel succesbehandler i at frigive budget, starte en ny ordre eller erklære strategien fuldført, før de faktiske kontokonsekvenser kendes.
Udfør Kalshi-handler automatisk med afstemning af gennemførelser
Udfør Kalshi-handler automatisk med afstemning, der kan genopbygge, hvad der faktisk blev handlet. Hver unik gennemførelse bidrager med mængde og kontantvirkninger, mens ordreoversigter giver yderligere dokumentation om kumulativ udførelse og resterende forpligtelser.
Læg ikke gentagne kumulative totaler sammen, som om de var nye gennemførelser. Hvis én observation viser 25 gennemført, og en senere viser 60, er totalen 60, ikke 85. Inkrementelle hændelser og kumulative øjebliksbilleder kræver forskellige opdateringsregler.
Fjern dubletter blandt inkrementelle hændelser efter deres dokumenterede identiteter, og bevar deres ordreforbindelser. En genforbindelse kan levere oplysninger, der allerede er set. Behandling af dem to gange ville skabe en falsk position og forvrænge det tilsyneladende kontantresultat.
I det løbende eksempel giver 25 kontrakter til 41 cent og 35 til 42 cent 60 erhvervede kontrakter til en gennemsnitspris på cirka 41,58 cent før udgifter. Antagne faktiske udgifter på 30 cent øger den samlede omkostning til 25 dollar og 25 cent.
Hvis kontoen begyndte med ti kontrakter i samme retning, og ingen anden aktivitet fandt sted, har den nu 70 i beholdningen. Dette positionsresultat adskiller sig både fra de anmodede 80 yderligere kontrakter og fra de 60 kontrakter, som denne konkrete instruktion gennemførte.
Brug tidsstempler til at forklare tilsyneladende modstridende dokumentation
Et ordresvar, en strøm af gennemførelser og et kontoøjebliksbillede kan beskrive forskellige tidspunkter. En afvigelse betyder ikke automatisk, at en kilde er forkert, men den bør ikke ignoreres, blot fordi senere konsistens forventes.
Bevar hver observations tidsstempler og omfang. Et saldoøjebliksbillede, der er ældre end en ny gennemførelse, kan ikke modbevise den. En senere kumulativ ordreregistrering kan omfatte aktivitet, som den lokale strøm endnu ikke har leveret.
Kalshi dokumenterer et endepunkt til brugerdataenes tidsstempel, som hjælper med at identificere aktualiteten af bestemte kontodata. Sådan dokumentation kan hjælpe afstemningen. Den gør ikke alle særskilt hentede svar til ét atomart kontoøjebliksbillede.
Vælg en udtrykkelig genopretningsmetode for huller. Programmet kan have brug for aktuel ordretilstand, relevante gennemførelser og en frisk positionsaflæsning med håndtering af sideinddeling eller historisk omfang efter behov. Én tom side bør ikke automatisk fastslå en tom historik.
Lad uafklarede forskelle forblive synlige, og begræns afhængige handlinger, når det er nødvendigt. Målet er en forklarlig kontotilstand, ikke en visning, som altid tvinger de seneste observationer til at stemme overens ved at kassere ubekvem dokumentation.
En bredere vejledning om automatisering af Kalshi-hændelseskontrakter skelner også kontoobservationstidspunkter fra offentliggørelsesplaner, handelsfrister og milepæle for afgørelse.
Annullér en rest uden at slette gennemførelserne
En annulleringsanmodning vedrører den ugennemførte del af en ordre, når annulleringen får virkning. Den omgør ikke en allerede fuldført transaktion, og den resterende mængde kan ændre sig, mens anmodningen er undervejs.
Antag, at den illustrative ordre har 60 gennemførelser og 20 stadig aktive, da annullering anmodes. Hvis yderligere fem gennemføres, før annulleringen lykkes, kan slutresultatet være 65 gennemført og 15 annulleret. Kontoen skal bevare disse fem yderligere gennemførelser.
Positionen ville derefter være 75 kontrakter, hvis den begyndte med ti, og ingen anden aktivitet fandt sted. En rapport, der beholdt den tidligere position på 70 kontrakter, ville undervurdere eksponeringen, selv om selve annulleringen lykkedes.
Hvis annullering ikke kan bekræftes, skal den potentielle rest bevares i risikoregistreringen. At en lokal knap skifter fra aktiv til stoppet, fastslår ikke, at handelsstedet fjernede ordren. Grænsefladen bør skelne den anmodede handling fra dens verificerede resultat.
Efter en bekræftet annullering skal den endelige gennemførte mængde og enhver resterende kontoforpligtelse afstemmes. Det afslutter ordrens livscyklus og bevarer samtidig positionens livscyklus, som kan fortsætte indtil et senere salg eller afregning.
Validér igen før erstatning eller forbedring af en ordre
En ugennemført ordre kan friste programmet til at følge markedet ved gentagne gange at forbedre sin pris. Denne adfærd ændrer økonomien i den oprindelige beslutning og bør kræve udtrykkelige regler frem for at opstå af en genforsøgsløkke.
Vurdér prognosen, aktuelle markedsoplysninger, resterende mængde og kontoeksponering igen før enhver erstatningsordre. En pris, der tidligere var acceptabel, kan være uattraktiv efter nye oplysninger, selv om den endelig ville opnå en gennemførelse.
Mængdeændringer kræver også præcis betydning. En ændringsoperation kan beskrive en revideret samlet tilladt gennemførelsesmængde, mens en reduktionsoperation kan beskrive den aktive rest. Klienten bør bruge den aktuelle operations definition frem for ét generelt størrelsesfelt fælles for alle handlinger.
En annuller-og-erstat-rækkefølge kan omfatte en periode, hvor den gamle ordres udfald er usikkert. Indsendes erstatningen, før denne usikkerhed er løst, kan begge stadig bidrage med gennemførelser. Reglerne skal tage højde for den samlede mulige eksponering.
Registrér begrundelsen for hver økonomisk ændring. En erstatning udløst af en frisk prognose er noget andet end en erstatning udløst af utålmodighed med en ugennemført ordre. Sondringen hjælper med at identificere, om den observerede handelsadfærd faktisk følger den godkendte strategi.
Bevar viden om ordrer gennem en pause eller genstart
En lokal genstart bør ikke nulstille den økonomiske verden. Ordrer, som handelsstedet allerede har accepteret, og positioner, som allerede er i beholdningen, kan overleve den proces, der skabte dem. Genopretning begynder med at rekonstruere disse forpligtelser.
Indlæs uafklarede hensigtsregistreringer, undersøg aktuel kontodokumentation, og identificér eventuelle huller, før nye indsendelser aktiveres. En tom liste i hukommelsen er kun dokumentation for, at processen netop er startet, ikke for, at kontoen ingen aktive ordrer har.
En markedspause kræver tilsvarende disciplin. Fastslå, hvad der stadig er i beholdningen, hvilke ordrevirkninger der kendes, og hvilke handlinger der aktuelt er tilgængelige. Når aktiviteten genoptages, skal det oprindelige signal vurderes igen frem for automatisk at gentage alle tidligere udsatte anmodninger.
Vejledningen om handelsautomatisering på forudsigelsesmarkeder behandler observation og genopretning som løbende ansvar. Udførelsesstyring har gavn af samme tilgang: botten bør fortsat kunne forklare sine forpligtelser, selv når den ikke må skabe nye.
At genetablere forbindelsen kan være et nødvendigt genopretningstrin, men er ikke tilstrækkelig bemyndigelse til at handle. Kontoregistreringen, aktuelle markedsforhold og udførelsesreglerne skal stemme overens, før en frisk instruktion kan fortsætte.
Vurdér udførelsen uden at belønne uønskede gennemførelser
En udførelsesgennemgang bør spørge, om botten fulgte sine godkendte grænser og rapporterede resultatet korrekt. En høj gennemførelsesrate alene kan belønne adfærd, der betaler for meget, venter for længe eller samler mere eksponering end tilsigtet.
Sammenlign den faktiske mængde og det gennemsnitlige anskaffelsesbeløb med de tilladte priser, der var tilgængelige på beslutningstidspunktet, og anerkend samtidig begrænsningerne ved rekonstruktion af historiske ordrebøger. Et vist pristilbud beviser ikke, at samme likviditet ville være forblevet tilgængelig for enhver hypotetisk ordre.
Mål uafklarede anmodninger, forældede observationer, tidsmæssigt konkurrerende annulleringer og håndtering af dublethændelser sammen med prisudfaldene. Disse driftsfakta kan forklare, hvorfor en strategis rapporterede position afveg fra den tilsigtede, selv når selve prognosen var rimelig.
Gennemgå beslutninger, som korrekt førte til ingen handel. Afvisning af et udløbet signal eller en ordre uden for prisgrænsen kan være vellykket udførelsesstyring. Hvis al inaktivitet behandles som fejl, presses systemet til at tilsidesætte sine egne begrænsninger.
Evnen til at udføre Kalshi-handler automatisk demonstreres derfor bedst gennem en fuld forklaring: hvad der var bemyndiget, hvad der blev forsøgt, hvad der blev gennemført, hvad der var tilbage, og hvordan den endelige kontotilstand blev verificeret. Denne forklaring gør automatiseringen vurderbar uden at forveksle hurtig indsendelse med et kontrolleret økonomisk resultat.
Relaterede vejledninger og trinvis gennemgåede eksempler
- Automatiseret bot til Kalshis forudsigelsesmarkeder: tydelige kontrolporte — Forbind adgangskontroller med hele den automatiserede arbejdsgang for forudsigelser.
- Automatiseret handel på Kalshi: kør den daglige cyklus — Forbind markedsdata, daglig drift, ordreregistreringer og senere afregning.