En Kalshi-bot är ett program som omvandlar en definierad handelspolicy till åtgärder i ett behörigt konto. För händelsekontrakt är kärnfrågan om ett precist beskrivet utfall kommer att inträffa. Programmet kan samla belägg, uppskatta en sannolikhet, jämföra uppskattningen med tillgängliga priser och hantera order. Nyttan beror på hur väl stegen hänger ihop.
Automation gör inte en osäker händelse till säker avkastning. En bot kan följa en svag prognos mycket konsekvent, missförstå ett kontrakt i hög hastighet eller fortsätta köpa efter att ägaren ville stoppa. Att förstå kontoarbetsflödet är därför mer användbart än att börja med en funktionslista.
Den här guiden gäller prognosbaserade händelsekontrakt. Exemplen använder enkla kontrakt med antagen dollarutbetalning för vinnande utfall. Faktiska regler, undantagsutfall, åtkomst och kostnader måste kontrolleras för aktuell marknad.
Vad en Kalshi-bot för händelsekontrakt faktiskt gör
En Kalshi-bot för händelsekontrakt har tre skilda uppgifter: observera, besluta och agera. Observation innebär att samla information om händelsen, kontraktet och kontot. Beslut innebär att tillämpa en policy på informationen. Handling innebär att begära en order eller annan kontooperation som stöds. En bra utformning håller uppgifterna tillräckligt åtskilda för att granska var och en.
Anta att händelsen gäller om ett publicerat mått överstiger en angiven tröskel. En observation kan vara en nypublicerad undersökning. Beslutet kan vara att undersökningen ändrar uppskattad chans från 48 % till 53 %. Åtgärden är inte automatiskt att köpa. Programmet behöver fortfarande rätt kontrakt, godtagbart säljpris, tillräckliga resurser och tillåtelse enligt gränserna.
Skillnaden spelar roll när informationen är korrekt men affären dålig. En prognos på 53 % motiverar inte att betala 58 cent för ett enkelt Ja-kontrakt som betalar en dollar bara för att händelsen blivit mer sannolik. En uppskattning måste jämföras med kostnaden för motsvarande exponering.
En bot kan också vara användbar utan nya affärer. Den kan identifiera kontrakt för granskning, kontrollera att dokumenterade avslut stämmer med positioner eller avisera en operatör om en obekant regeländring. Uppgifterna behöver andra behörigheter än orderinlämning. Full handelsbefogenhet för varje komponent gör oavsiktliga fel mer betydelsefulla.
Det bredare ramverket för botar på prognosmarknader förklarar varför regler och avveckling hör till handelsprocessen. På en viss handelsplats blir resonemanget en kontodisciplin: varje föreslagen åtgärd ska besvara vad som handlas, varför nu, hur mycket och under vilka villkor planen blir ogiltig.
Läs kontraktet före priset
En kort marknadstitel hjälper människor att bläddra men är ingen fullständig specifikation. Fullständiga regler bestämmer mätt utfall, relevant period, bekräftelsekälla och hantering av ovanliga omständigheter. Kalshi förklarar skillnaden mellan sammanfattning och fullständigt kontrakt i sin vägledning om regelsammanfattningar.
För ett automatiserat system är den viktiga uppgiften att omvandla läsningen till en kontrollerbar post. Lagra exakt marknadsidentitet, innebörden av Ja, observationsfönstret och olösta frågor. Om en människa inte löst en tvetydighet ska boten inte tyst fylla luckan med sin föredragna tolkning.
Tänk på två hypotetiska kontrakt om samma månadsnummer. Ett hänvisar till först publicerat värde och det andra till en senare revision. En prognos kan informera båda men utbetalningarna behöver inte matcha. Att behandla dem som utbytbara kan skapa en position som beter sig annorlunda än handlaren avsåg.
Tidsgränser kräver samma omsorg. Ett villkor observerat när som helst under en period skiljer sig från ett villkor mätt vid slutet. En händelse vid midnatt i en tidszon kan tillhöra annat datum någon annanstans. Programmet behöver en uttrycklig konvention snarare än operativsystemets förvalda lokaltid.
En praktisk antagningspost anger också vad som leder till avslag. Exempel är saknade regler, okänd källa, en tröskel som inte kan tolkas eller ett kontrakt utanför avsedd produktfamilj. Avslag bevarar strategins innebörd. De är inte missade möjligheter som automatiskt ska åsidosättas när ett pris ser attraktivt ut.
Skilj prognos från noterad sannolikhet
Ett kontraktspris diskuteras ofta som underförstådd sannolikhet. Språket kan vara användbart men ska inte få programmet att behandla visat pris som en fullständig sannolikhetsmodell. Noteringar beror på tillgängliga köpare och säljare, positionsbegränsningar, spread, storlek och tid. Ett senaste avslut kan också vara gammalt.
För ett enkelt binärt kontrakt som betalar en dollar på Ja innebär en egen uppskattning av 60 % chans en förväntad utbetalning på 60 cent per kontrakt före kostnader. Om genomförbart inköpspris är 55 cent är skillnaden fem cent. Skillnaden är en uppskattning utifrån prognosen, inte redan intjänade pengar.
Anta nu att modellosäkerhet antyder ett rimligt sannolikhetsintervall från 51 % till 64 %. Samma köp ser gynnsamt ut i övre änden och ogynnsamt i nedre. En försiktig policy kan kräva att affären förblir godtagbar med mindre optimistisk uppskattning. En annan kan minska storleken när prognososäkerheten växer.
Det viktiga är att regeln anges före resultatet. Att byta uppskattning först efter att man sett om affären vann hindrar meningsfull utvärdering. Lagra prognos, tid, källa och pris för beslutet. Jämför senare prognosen med utfallen utan att ersätta ursprunglig uppskattning.
Förväxla inte träffsäkerhet med lönsamhet. Ett program som köper mycket sannolika utfall nära full utbetalning kan vinna ofta men tjäna för lite på vinnare för att täcka enstaka förluster och kostnader. Omvänt kan en strategi ha många förlustaffärer och ändå gynnsam aritmetik enligt antagandena. Underlaget måste visa både utfallsfördelning och betalda belopp.
Bygg ett kontoarbetsflöde för en Kalshi-bot
Ett kontoarbetsflöde för en Kalshi-bot börjar med en kontovy som skiljer tillgängliga resurser från åtaganden. Kassa, öppna order, befintliga positioner och oavvecklade resultat hänger ihop men inget ersätter helt de andra. En order utan avslut kan ändå spela roll eftersom den kan avslutas medan ett annat beslut fattas.
Föreställ dig ett konto med 200 dollar tilldelade en liten forskningsstrategi. Det innehar redan kontrakt som kostade 24 dollar och två vilande order kan kräva ytterligare 18 dollar om de matchas helt. Ett nytt förslag som kostar 20 dollar bedöms inte bara mot ursprungliga 200. Strategin måste beakta aktuella åtaganden och förlustkoncentrationen som ny exponering skapar.
Kontoposten ska också skilja avsedd order från accepterad order och från avslut. Avsikt finns lokalt före inlämning. Accepterande är belägg för att handelsplatsen erkände begäran. Ett avslut är en ekonomisk transaktion. Att behandla första lyckade svaret som bevis för hela önskade positionen ger felaktiga följdåtgärder.
Delavslut gör skillnaden synlig. Om önskat köp är 40 kontrakt och 12 avslutas äger kontot 12, inte 40. Om återstående order är aktiv finns fortfarande möjlig exponering från ytterligare 28. Programmet ska kunna visa båda fakta utan att slå ihop dem till en missvisande status.
Arbetsflödet för automatiserad handel på prognosmarknader utvecklar den bredare driftloopen. En första Kalshi-implementation kan vara snäv men behöver ändå ett tillförlitligt förhållande mellan beslut, accepterade begäranden, avslut och slutligt kontotillstånd.
Följ en hypotetisk position genom kontot
Tänk på ett illustrativt köp av 50 Ja-kontrakt till 40 cent vardera. Köpesumman är 20 dollar. Anta totala ingångskostnader på 50 cent för övningen; det är inget påstående om aktuella Kalshi-avgifter. Dokumenterad anskaffningskostnad är därför 20 dollar och 50 cent.
Senare säljer programmet 20 av kontrakten till 55 cent vardera med antagna försäljningskostnader på 20 cent. Bruttointäkten är 11 dollar och nettointäkten 10 dollar och 80 cent. Med proportionell kostnadsfördelning i undervisningsexemplet bär såld del 20/50 av ursprungliga 20 dollar och 50 cent, alltså 8 dollar och 20 cent.
Realiserad vinst på försäljningen är 2 dollar och 60 cent. Återstående 30 kontrakt bär 12 dollar och 30 cent i fördelad anskaffningskostnad. Deras aktuella marknadsvärde är ett separat mått. Det ska inte läggas till realiserad vinst som om kontrakten redan sålts.
Om återstående enkla binära Ja-position avvecklas till en dollar per kontrakt utan fler antagna kostnader får den 30 dollar. Total nettointäkt från försäljning och avveckling är 40 dollar och 80 cent. Efter avdrag för ursprungliga 20 dollar och 50 cent blir total vinst 20 dollar och 30 cent.
Om Ja i stället avvecklas till noll är totalresultatet de 10 dollar och 80 cent från tidigare försäljning minus ursprunglig kostnad, en förlust på 9 dollar och 70 cent. Delförsäljningen ändrade återstående risk men garanterade inte lönsamt totalutfall. En kontojournal ska göra båda möjliga förloppen lätta att förstå före händelsens avgörande.
Ange Kalshi-botens riskgränser i ekonomiska termer
Kalshi-botens riskgränser ska beskriva belopp kontot kan förlora, inte bara antal begäranden ett program skickar. En gräns på tio order säger lite om en order är mycket större än de andra. Ett kontraktsantal behöver också sammanhang eftersom betalning på 15 cent respektive 85 cent ger olika inköpskostnad för samma enkla binära kvantitet.
Börja med högsta strategitilldelning och dela sedan gränsen i mindre kontroller. Ett marknadstak begränsar ett kontrakt. Ett händelsetak täcker relaterade kontrakt. Ett källtak hanterar flera positioner som beror på samma publicering eller resultatmyndighet. Kontrollerna besvarar olika frågor och ska inte ersättas med en bred saldokontroll.
Korrelation kan få skenbart diversifierade positioner att bete sig lika. En strategi kan inneha flera kontrakt med olika titlar som alla förlorar när samma ekonomiska tal överraskar åt ett håll. Enbart marknadsantalet kan dölja gemensam exponering. Skriv några rimliga händelsescenarier och beräkna sammanlagd effekt.
Öppna order hör till scenarierna. Om en bot redan innehar 25 kontrakt och har köpbud på ytterligare 25 lämnar en köpgräns utifrån enbart avslutade positioner utrymme för oavsiktlig överdimensionering. Osäkra inlämningar kräver också tillfällig kapacitet tills resultaten lösts. Annars kan en nätverksfördröjning få samma pengar att verka tillgängliga två gånger.
En stopppolicy ska ange vad som händer efter nådd gräns. Att pausa nya ingångar, begära annullering av aktiva order och fortsätta kontoavstämning är olika åtgärder. Att bara avsluta processen kan lämna order på handelsplatsen och ta bort just den observatör som behövs för att upptäcka senare avslut.
Skilj testning från belägg för en fördel
Testning kan visa att ett program tillämpar regler korrekt. Den kan inte ensam visa att reglerna har en lönsam fördel. Ett lyckat test av köp, delförsäljning och omstart fastställer användbara tekniska fakta men validerar inte prognosen bakom köpet.
Börja med kontrollerade exempel vars förväntade resultat är kända. Ge redovisningssystemet scenariot med 50 kontrakt ovan och verifiera aritmetiken. Ändra försäljningskvantiteten, lägg till ett avslut och kontrollera att återstående innehav och kostnader rör sig tillsammans. Det är mer informativt än att se ett rimligt saldo på en instrumentpanel.
Testa sedan fall som ska leda till ingen affär. Ge programmet en gammal notering, en okänd kontraktsregel, kvantitet över taket eller ett kontosvar som inte kan tolkas. Resultatet ska vara ett förklarat avslag. En bot som bara visar lyckade ingångar har inte visat att gränserna fungerar.
Dokumenterade marknadsobservationer kan sedan stödja en simulerad beslutsstudie. Bevara ordningen i vilken information blev tillgänglig. Låt inte senare avvecklingsinformation påverka tidigare beslut. Inkludera affärer som skulle ha avvisats eller förblivit utan avslut i stället för att räkna varje attraktiv historisk notering som ett färdigt köp.
Kalshis dokumentation om demomiljön beskriver låtsasmedel och påpekar att demobeteende kan skilja sig från verkliga marknader. Det gör miljön användbar för anslutnings- och arbetsflödesövningar medan verklig utförandekvalitet är en separat fråga. Ett gynnsamt demosaldo ska inte presenteras som prognos för verkliga resultat.
Vet vad som kräver mänsklig bedömning
Vissa gränser hanteras bättre genom granskning än allt mer komplicerad automation. En väsentlig regeländring, ett obekant avvecklingsundantag eller en avvikelse som inte förklaras av kända avslut kan kräva en person som avgör om strategin fortfarande gäller. Programmet ska förenkla granskningen genom relevanta bevarade belägg.
Ett användbart granskningspaket innehåller kontraktsidentitet, aktuella och tidigare godkända regelbeskrivningar, kontoavvikelsen och senaste åtgärder. Hemligheter ska utelämnas. En operatör som försöker förstå ett problem behöver beslutsposter och tidsstämplar, inte en privat nyckel inklistrad i ett supportmeddelande.
Guiden till handels-API:er för prognosmarknader förklarar gränsen mellan offentliga observationer och autentiserade kontoåtgärder. I en första implementation hjälper en snäv gräns till att säkerställa att ett datainsamlingsfel inte direkt kan godkänna en större affär.
Mänsklig granskning har också en kapacitetsgräns. En strategi med hundratals oförklarade aviseringar varje dag är inte väl övervakad bara för att den har en aviseringsfunktion. Välj ett marknadsuniversum och en handelsfrekvens som ägaren kan förstå. Varningar som ständigt ignoreras ska utlösa omarbetning av arbetsflödet, inte en större meddelandelista.
Före utvidgning ska ägaren kunna förklara en fullständig affär från ursprunglig prognos till slutligt kontoresultat. Förklaringen ska tåla delavslut, annullerad återstod och fördröjd avveckling. Förmågan att rekonstruera en vanlig position är grunden för att förstå ovanliga händelser senare.
Håll finansiering skild från handelsresultat
Ett kontosaldo kan stiga utan att strategin tjänar något. En ny insättning är ytterligare finansiering medan avvecklingsintäkter inkluderar återbetalning av pengar som ursprungligen bands i en vinnande position. En bot som kallar varje ökning vinst vilseleder ägaren även om varje enskild orderpost är korrekt.
Håll en separat förteckning över externa kassaflöden och intern handelsaktivitet. Anta att ett konto börjar med 100 dollar, får en insättning på 50 dollar och slutar med 142 dollar efter att alla positioner stängts. Utan andra justeringar är handelsresultatet en förlust på åtta dollar, inte en vinst på 42 dollar. Insättningen ändrade tillgängligt kapital, inte strategins kvalitet.
Samma skillnad gäller ett uttag. Att ta ut pengar minskar saldot utan att nödvändigtvis vara en handelsförlust. Håll insättningar, uttag, avgifter, realiserade resultat och olösta positioner synliga som separata kategorier före sammanfattning.
Välj ett rapporteringsintervall som passar strategin. En daglig rapport kan visa utestående åtaganden och kända kostnader och samtidigt erkänna att vissa utfall är olösta. Den ska inte tvinga varje öppen position till en slutlig vinst eller förlust bara för att ge ett prydligt dagstal. Ärlig redovisning lämnar osäkerhet synlig tills relevanta belägg anländer.
Använd en liten beslutspost för att bedöma framsteg
En kort beslutspost kan göra en enkel bot mer användbar än ett mycket mer komplicerat system med dåliga belägg. Bevara för varje möjlighet kontrakt, observationstid, prognos, säljpris, föreslagen storlek, godkännanderesultat och slutlig åtgärd. Lägg till skälet när policyn avstår från handel.
Granska posterna i grupper. Om de flesta avslag kommer från oklara regler behöver antagningsprocessen uppmärksamhet. Om godkända möjligheter försvinner innan order anländer kan utförandetiden vara begränsningen. Om avslut sker som avsett men prognoser ständigt är optimistiska gäller problemet forskningskvalitet. Varje problem kräver ett annat svar.
Skilj kontrollerbara fel från vanlig osäkerhet. Ett korrekt utfört förlorande kontrakt är inte nödvändigtvis ett programfel. Att köpa fel kontrakt, överstiga godkänd kvantitet eller förlora beläggen för att förklara ett saldo är ett driftfel även om affären råkar vinna. Vinst ska inte sudda ut ett processfel.
En användbar första milstolpe är därför begränsad och konkret: boten kan förklara varje åtgärd, varje utestående åtagande och varje avvecklat resultat inom sitt lilla mandat. Utvidgning blir ett avsiktligt val med belägg om befintligt arbetsflöde. Hastighet, fler marknader och mer avancerade prognoser kan sedan utvärderas mot en process som redan är begriplig.
Relaterade guider och genomarbetade exempel
- Handelsprogramvara för Kalshi: håll beslut granskningsbara — Definiera programkrav för bevarade data, uppgraderingar och incidentutredning.
- Bästa handelsboten för Kalshi: jämför beläggen — Jämför verktyg för händelsekontrakt med demonstrerat beteende och tydliga avvägningar.