Calibrain Harness ni Nini?
Calibrain Harness ni mfumo wa majaribio ya mbele wa chanzo huria kwa miundo ya uainishaji wa kasi kubwa. Huunganisha modeli inayotumika na data ya soko la perpetual futures, huuliza maswali yanayoweza kupewa lebo kwenye kila mshumaa uliofungwa, hubadilisha uwezekano unaorudishwa kuwa thamani inayotarajiwa, na kwa hiari hutekeleza miamala inayokidhi vigezo kwenye Bybit testnet pekee.
Mradi huu unaunganisha zana mbili zinazohusiana: roboti ya biashara na mfumo wa kutathmini modeli. Kila utabiri huhifadhiwa na baadaye kulinganishwa na matokeo ya soko, ikijumuisha utabiri ambao haukuleta miamala. Hii hutenganisha ubora wa modeli na athari za ada, mtelezo wa bei, utekelezaji na kanuni za sera.
Muhimu: Calibrain Harness iko katika maendeleo endelevu na ni programu ya utafiti, si ushauri wa kifedha. Kihudumu chake cha biashara kimewekwa moja kwa moja kutumia Bybit testnet, na hakuna swichi ya mainnet. Miingiliano, mipangilio ya msingi na seti za maswali zinaweza kubadilika kati ya commits.
Jinsi Mfumo Unavyofanya Kazi
Badala ya kuuliza modeli ijibu “nunua, uza au subiri,” mfumo huuliza maswali yanayoweza kupewa lebo kwa njia ya kiobjektivu kutokana na data ya bei ya baadaye. Mfano mmoja ni ni mpaka upi utakaoguswa kwanza katika kipindi maalum: lengo chanya au stop hasi.
- Data ya umma ya soko la mainnet, habari, muktadha wa uchumi mkuu, taarifa za kitabu cha oda na data ya derivatives hukusanywa.
- Kijenzi cha vipengele huunda hali fupi yenye vitengo vilivyoainishwa na kuongeza viwango vya msingi vya kihistoria vya chombo na mabano husika.
- Kairos au Jev hupokea hali hiyo pamoja na maswali saba yenye aina maalum yanayoweza kupewa lebo.
- Jibu huthibitishwa kwa ukali. Jibu lisilo sahihi hurekodiwa kama hitilafu badala ya kutafsiriwa kuwa utabiri hasi.
- Uwezekano wa modeli huchanganywa na viwango vya msingi vya kihistoria kupitia safu ya urekebishaji.
- Sera hukokotoa thamani inayotarajiwa katika R, hutumia vizuizi vya kuingia na huamua ukubwa wa hatari.
- Ikiwa biashara ya kiotomatiki imewashwa, oda zinazokidhi vigezo hutumwa kwa Bybit testnet.
- Maombi, majibu, lebo, runs na miamala huhifadhiwa katika SQLite kwa ajili ya tathmini na ripoti.
Ishara na lebo hutumia data ya mainnet kwa sababu data ya soko la testnet inaweza kuwa ya kubuniwa au kutofautiana. Hata hivyo, oda huwekwa kwenye testnet pekee na ukubwa wake huamuliwa kulingana na kina cha kitabu kinachopatikana.
Vipengele Muhimu
Miundo Mingi ya Uainishaji
Kwa sasa mfumo unaunga mkono Kairos, unaotolewa na DMind kupitia Minara Cloud, na Jev, unaotolewa na TypeSafe. Zote hutumia mtindo uleule wa ombi wa System One, seti ya maswali, uthibitishaji, sera na mchakato wa tathmini.
Maamuzi, uzani wa urekebishaji, tathmini na ripoti hubaki zimetenganishwa kwa kila modeli. Kubadilisha modeli inayotumika huanzisha run mpya na kunaruhusiwa tu roboti ikiwa haina nafasi wazi, hivyo kuzuia matokeo ya miundo tofauti kuchanganywa.
Terminal ya Mtindo wa Bloomberg
Terminal ya Next.js hupokea masasisho ya moja kwa moja kupitia WebSocket moja. Huonyesha chati, ishara za modeli, thamani inayotarajiwa iliyorekebishwa na ghafi, nafasi, taarifa za akaunti, kitabu cha oda na mwonekano wa kina, ramani za soko, habari, liquidations, data ya derivatives na jedwali la maamuzi lenye kila ombi na jibu la modeli.
Urekebishaji na Tathmini Zilizojengwa Ndani
Calibrain Harness huchanganya uwezekano wa modeli na viwango vya msingi vya chombo kwa kutumia fomula w · model + (1 − w) · base rates. Uzani huanza kwa 0.5 na huwekwa upya kila dakika 15 baada ya swali kukusanya angalau matokeo 100 yenye lebo.
Tathmini inajumuisha alama za Brier na uwezekano uliopangwa, uwezo dhidi ya climatology na viwango vya msingi vilivyotolewa, AUC, utegemezi, hitilafu inayotarajiwa ya urekebishaji, uchanganuzi wa probability integral transform, upangaji wa EV, uchunguzi wa uthabiti, ubora wa utekelezaji na matokeo ya biashara kwa kila run.
Vidhibiti vya Utekelezaji wa Testnet
Maingizo hutumia oda za limit za IOC zilizowekewa kikomo kulingana na bei bora ya testnet. Malengo yanaweza kubaki kama limit za reduce-only, huku stop zinazosimamiwa zikianzishwa kwa kutumia bei zinazotekelezeka za mainnet na kufungwa kupitia oda za reduce-only IOC zenye kikomo kwenye testnet. Mfumo pia unajumuisha stop za muda, kinga ya bei ya mark, kikomo cha hasara ya kila siku, vikomo vya nafasi, vikomo vya hatari ya jalada na swichi ya kuzima.
Mahitaji ya Awali
Kabla ya usakinishaji, andaa yafuatayo:
- Python 3.12.
- Node.js 20 au mpya zaidi pamoja na npm.
- Ufunguo wa API wa Kairos kutoka Minara Cloud au ufunguo wa API wa Jev kutoka konsoli ya TypeSafe.
- Vitambulisho vya API vya Bybit testnet kutoka usimamizi wa API wa Bybit testnet.
Ufunguo wa Bybit unapaswa kuwa na ruhusa za Contract kwa oda na nafasi. Usipe ruhusa ya kutoa fedha.
Sakinisha Calibrain Harness
1. Nakili Hazina
git clone https://github.com/zadescoxp/calibrain-harness.git
cd calibrain-harness
2. Unda Mazingira ya Python
Unda mazingira pepe ya Python 3.12, sakinisha vitegemezi na nakili usanidi wa mfano:
python3.12 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env
Ongeza vitambulisho kwenye .env, au viweke baadaye kupitia amri ya KEYS ya terminal. Programu husoma funguo kutoka kwenye faili hili, ambalo limewekewa gitignore na linatarajiwa kuwa na ruhusa za mmiliki pekee. Funguo hazihifadhiwi kwenye hifadhidata wala kutumwa kwa ukamilifu kwenye kivinjari.
3. Jenga Kiolesura cha Terminal
cd web-next
npm ci
npm run build
cd ..
Hii huunda terminal tuli katika web-next/out. Huduma ya Python hutoa kiolesura, API na WebSocket, kwa hiyo mchakato tofauti wa uzalishaji wa Node.js hauhitajiki.
4. Anzisha Huduma
.venv/bin/python -m ctb.server
Fungua http://127.0.0.1:8800. Seva inaunganishwa ndani ya kompyuta kwenye 127.0.0.1 na inakataa maandishi ya kuvuka asili.
Ikiwa kiolesura hakijajengwa, anwani itaonyesha ukurasa mfupi wenye amri ya kujenga. API na WebSocket ya moja kwa moja vitaendelea kupatikana.
Sanidi Modeli na Vitambulisho
Chagua Kairos au Jev kwa kutumia CTB_MODEL_PROVIDER katika .env:
CTB_MODEL_PROVIDER=kairos
KAIROS_API_KEY=your_kairos_key
Kwa Jev, tumia:
CTB_MODEL_PROVIDER=jev
TYPESAFE_API_KEY=your_typesafe_key
CTB_JEV_MODEL=jev-1.14.0
Modeli ya Jev iliyoandikwa kwenye nyaraka imefungwa kwenye jev-1.14.0, ingawa CTB_JEV_MODEL inaweza kuibadilisha. Vitambulisho vya Kairos lazima viwe vya kikundi cha Minara Cloud kilichowezeshwa kwa Kairos.
Ongeza vitambulisho vya Bybit testnet kwa kutumia majina ya vigezo yaliyotolewa na .env.example. Usifanye kamwe commit ya .env au faili zilizo chini ya data/.
Anza kwa Hali ya Kutazama Pekee
Bot huanza bila kuweka oda. Katika hali hii, inaendelea kukusanya data ya soko, kuita modeli iliyochaguliwa, kurekodi maamuzi, na kuweka lebo kwenye utabiri. Hii ndiyo njia inayopendekezwa kuanzia kwa sababu inakuruhusu kuthibitisha muunganisho na kuchunguza tabia ya modeli bila kufungua nafasi za testnet.
- Anzisha huduma ya Python.
- Fungua terminal kwenye
127.0.0.1:8800. - Thibitisha kuwa data ya soko na maamuzi ya modeli yanaonekana.
- Kagua hitilafu na muda wa kusubiri kwenye skrini za LOG na EVAL.
- Washa AUTO-TRADE tu pale usanidi unapofanya kazi kwa usahihi.
Tumia Terminal
Skrini Kuu
- MON, F1: Huonyesha orodha ya ufuatiliaji, chati, alama za modeli, akaunti, nafasi, ramani ya soko, kitabu cha oda, habari, derivatives, data ya mtiririko, na daftari la maamuzi.
- EVAL, F2: Huonyesha urekebishaji, matokeo, upangaji wa EV, alama za maswali, uchunguzi wa uthabiti, vipimo vya uendeshaji, P&L, na ubora wa utekelezaji. Matokeo yanaweza kuchujwa kwa modeli, uendeshaji, ishara, seti ya maswali, na kipindi cha muda.
- TRADES, F3: Huorodhesha uendeshaji na miamala binafsi, ikijumuisha bei za marejeleo, ujazaji, mteremko wa bei, na R halisi.
- NEWS, F4: Huonyesha vichwa vya habari na utabiri wa
news_returnwa Kairos. Utabiri wa mapato kutokana na habari unapatikana tu kwa Kairos. - LOG, F5: Huonyesha matukio ya mfumo na hitilafu.
Mifano ya Mstari wa Amri
Bonyeza / ili kufungua mstari wa amri wa terminal. Amri za kawaida ni pamoja na:
BTCauETHkupakia ishara.ASKauPRBkuuliza modeli mara moja na kuendesha uchunguzi wa uthabiti.1Mhadi4Hkubadilisha kipindi cha muda cha chati.TF 5Mkuweka kipindi cha muda cha biashara.UNIVkuchagua mkusanyiko wa ishara.POS 10kuweka idadi ya juu zaidi ya nafasi.KEYSkudhibiti vitambulisho.HELPkuonyesha msaada wa terminal.
Unaweza kubadilisha kati ya Kairos na Jev kupitia MODEL kwenye upau wa vitufe vya kazi. Bot lazima isiwe na nafasi wazi kabla ya kubadilisha.
Washa Biashara ya Testnet kwa Uangalifu
Baada ya kuchunguza maamuzi na kuthibitisha usanidi, tumia AUTO-TRADE kwenye upau wa amri kuruhusu oda za testnet. Hali kali hufanya biashara tu wakati utabiri uliorekebishwa unapopita vizingiti vyote vilivyos_configurewa, ikijumuisha thamani ya chini inayotarajiwa, ubora wa usanidi, makubaliano ya mwelekeo, makubaliano ya mgawanyo wa mapato, tofauti ya jukwaa, hali ya nafasi, na ruhusa za upande wa kuuza.
Hali ya uchunguzi imezimwa kwa chaguo-msingi. Kuweka CTB_EXPLORATION=1 huruhusu mfumo kufanya biashara upande unaopendelewa na modeli kwa hatari iliyopunguzwa wakati vizingiti vikali vinaizuia. Madhumuni yake ni kukusanya data halisi ya utekelezaji, si kuashiria kuwa sera kali imepata faida chanya.
Uwezo wa biashara wa testnet unaweza kuwa mdogo sana na unaweza kutenda tofauti na mainnet. Majaribio ya awali ya mbele ya mradi yaligundua kuwa ubora wa utekelezaji unaweza kutawala P&L ya testnet. Chukulia matokeo ya testnet kama data ya utafiti badala ya ushahidi wa faida ya baadaye.
Tumia Swichi ya Dharura
Kitufe cha KILL cha terminal hufunga nafasi za bot, hughairi oda, na kusimamisha mfumo. Kitendo hicho kinaweza pia kuanzishwa kutoka saraka ya mradi:
touch KILL
Nafasi zilizofunguliwa mwenyewe kwenye testnet kwa kawaida huonyeshwa lakini hazisimamiwi na bot. Swichi ya dharura ndiyo hali iliyoandikwa kuwa ya kipekee.
Endesha Majaribio na Ukaguzi wa Awali
Endesha majaribio ya unit bila ufikiaji wa mtandao:
.venv/bin/python -m pytest -q tests
Tuma ombi moja halisi kwa modeli inayotumika na uthibitishe jibu lake:
.venv/bin/python scripts/kairos_smoke.py SOLUSDT
Lenga Jev moja kwa moja:
.venv/bin/python scripts/kairos_smoke.py SOLUSDT --model jev
Jaribu njia ya utekelezaji ya testnet yenye ukubwa wa chini kwa kufungua nafasi ndefu, kuthibitisha stop, na kuifunga:
.venv/bin/python scripts/testnet_smoke.py SOLUSDT long
Hati hizi za ukaguzi hutuma maombi halisi ya nje, kwa hiyo thibitisha ishara iliyochaguliwa na vitambulisho kabla ya kuziendesha.
Elewa Chaguo Muhimu za Usanidi
Muda wa Maamuzi na Mabano
CTB_DECISION_TFkwa chaguo-msingi ni 5, ikimaanisha maamuzi hufanywa kwenye mishumaa iliyofungwa ya dakika tano.CTB_HORIZON_BARSkwa chaguo-msingi ni 24, hivyo kutoa upeo wa saa mbili katika muda-msingi.CTB_ATR_TFkwa chaguo-msingi ni 15 kwa ukubwa wa stop.CTB_SL_ATRnaCTB_TP_ATRkwa chaguo-msingi ni ATR 1.5 na 2.5.CTB_MIN_SL_BPnaCTB_MAX_SL_BPkwa chaguo-msingi huweka umbali wa stop kati ya pointi za msingi 40–300.
Vigezo Madhubuti vya Sera
CTB_MIN_EDGE_R=0.15huweka kiwango cha chini cha kawaida cha faida iliyosawazishwa.CTB_MIN_SETUP_QUALITY=1.5hudhibiti kizingiti cha ubora wa usanidi.CTB_MIN_DIRECTION_MARGIN=0.03huhitaji mwelekeo uliosawazishwa ulingane na upande uliopendekezwa kwa tofauti iliyobainishwa.
Vikomo vya Hatari
CTB_RISK_PER_TRADE_PCT=0.5hufafanua asilimia inayokusudiwa ya salio kupotea ikiwa stop itaguswa.CTB_MAX_POSITIONS,CTB_MAX_SAME_SIDE, naCTB_MAX_OPEN_RISK_PCThuweka mipaka ya mwonekano wa hatari wa jalada.CTB_MAX_LEVERAGE=3naCTB_MAX_NOTIONAL_USDT=5000hutoa vikomo vikali kwa chaguo-msingi.CTB_DAILY_LOSS_LIMIT_PCT=3huweka kikomo cha kawaida cha hasara ya kila siku.
Gharama na Utekelezaji
CTB_TAKER_FEE_BP=5.5naCTB_SLIPPAGE_BP=2huingizwa kwenye modeli ya gharama inayotumika kwa thamani inayotarajiwa na lebo.CTB_MAX_ENTRY_SLIP_BP=10huweka kikomo cha kawaida cha bei ya kuingia.CTB_EXIT_MODE=managedhuwezesha mchakato wa kutoka unaodhibitiwa ulioandikwa.
Badilisha kundi moja la mipangilio kwa wakati mmoja na anza uendeshaji mpya unapolinganisha sera. Kila uendeshaji huhifadhi nakala ya usanidi wake, hivyo kurahisisha uchanganuzi wa baadaye.
Vidokezo vya Juu vya Tathmini
Linganisha Modeli na Misingi Yake ya Ulinganisho
Utabiri unaoonekana kuwa wenye faida si lazima uwe na manufaa. Kagua ikiwa modeli inaizidi klimatolojia na viwango halisi vya kihistoria vilivyojumuishwa kwenye ingizo lake. Tabaka la usawazishaji hupunguza ushawishi wa modeli wakati matokeo yenye lebo yanaonyesha kuwa inaongeza taarifa kidogo.
Tenganisha Ujuzi wa Utabiri na Matokeo ya Biashara
Tumia EVAL kukagua maamuzi yote yenye lebo, si biashara pekee. Vipimo vya utabiri hupima ujuzi wa modeli wa uwezekano, huku P&L ya testnet ikipima athari zilizounganishwa za modeli, sera, gharama, upangaji wa hatari, na utekelezaji.
Hesabu Maamuzi Yanayopishana
Lebo huanza na mshumaa wa kwanza wa dakika moja baada ya kila uamuzi, hivyo kuzuia kuangalia data ya baadaye. Ikiwa mshumaa mmoja unagusa lengo na stop, lebo huhesabiwa kama stop. Hata hivyo, maamuzi yanayofuatana yanaweza kuwa na upeo unaopishana, hivyo idadi ghafi ya sampuli inaweza kukadiria kupita kiasi uhuru wa kitakwimu. README inapendekeza kusubiri maamuzi yenye lebo mia kadhaa kwa kila alama kabla ya kufikia hitimisho.
Kagua Ulinganifu
Tumia majaribio ya kurudia kupima uthabiti wa matokeo na majaribio ya kioo kubaini ikiwa kubadilisha vipengele vya soko vya kukuza na kushuka hubadilisha jibu la modeli ipasavyo. Pia kagua ulinganifu kati ya nafasi ndefu na fupi badala ya kutegemea kipimo kimoja kilichotengwa.
Hamisha Ripoti
Kutoka EVAL, tumia EXPORT MINARA REPORT kuandika ripoti ya Markdown iliyo na matokeo ya tathmini. Chuja kwa modeli, uendeshaji, alama, seti ya maswali, au muda kabla ya kutafsiri ulinganisho.
Dhibiti Alama na Uendeshaji
Amri ya UNIV huorodhesha hadi perpetual 100 za juu za USDT kwa mauzo ambazo pia zina orodha za testnet. Inajumuisha taarifa za kina na spread, na huashiria vitabu vyembamba pamoja na perpetual za hisa au bidhaa. Unaweza kuchagua hadi alama 30, kulingana na bajeti ya maombi ya modeli. Huduma hujianzisha upya ili kutumia mabadiliko ya jumla ya alama.
Kila uamuzi na biashara hupewa uendeshaji unaotumika. Ili kuunda uendeshaji kwa njia ya programu, tuma POST /api/runs/start wakati hakuna biashara ya bot iliyofunguliwa. Kuanzisha uendeshaji tofauti ni muhimu unapobadilisha modeli, maswali, kanuni za hatari, au mipangilio ya utekelezaji.
Fanya Kazi kwenye Kiolesura
Baada ya kuvuta mabadiliko au kuhariri frontend, jenga upya toleo tuli:
cd web-next && npm run build
Pakia upya kivinjari baadaye; seva ya Python haihitaji kuanzishwa upya.
Kwa uundaji wenye upakiaji wa moja kwa moja, iache seva ya Python ikiendelea na uanzishe Next.js kando:
cd web-next && npm run dev
Fungua http://localhost:3000. Kiolesura cha uundaji huwasiliana na API na WebSocket kwenye 127.0.0.1:8800.
Kagua aina za frontend kwa:
cd web-next && npx tsc --noEmit
Mbinu za Usalama na Uendeshaji
- Thibitisha kuwa hosti bado ni
api-testnet.bybit.com; mradi huu kwa makusudi hautoi swichi ya biashara ya mainnet. - Anza katika hali ya kutazama pekee na kagua makosa ya modeli kabla ya kuwezesha oda za testnet.
- Tumia vitambulisho vya Bybit visivyo na ruhusa ya kutoa fedha.
- Weka
.envna saraka yadata/nje ya udhibiti wa matoleo. - Fuatilia tofauti za venue, uwiano wa kujazwa, muda wa kusubiri, slippage, na sababu za kutoka badala ya kuzingatia P&L pekee.
- Weka utaratibu wa kill-switch mahali panapofikika kabla ya kujaribu utekelezaji.
- Endesha majaribio ya Python na ukaguzi wa aina za frontend kabla ya kuwasilisha mabadiliko.
Hitimisho
Calibrain Harness hutoa njia iliyopangwa ya kubaini ikiwa modeli ya uainishaji wa kasi inaongeza taarifa inayopimika kwenye utabiri wa masoko ya perpetual. Inachanganya maswali yenye malengo, viwango vya kihistoria vya msingi, usawazishaji wa uwezekano, uthibitishaji madhubuti, utekelezaji wa testnet, na tathmini ya kina katika terminal moja ya ndani.
Anza kwa kusakinisha huduma, kusanidi Kairos au Jev, na kukusanya maamuzi ya uchunguzi pekee. Baada ya data na mchakato wa modeli kuwa thabiti, jaribu utekelezaji kwa uangalifu kwenye testnet ya Bybit, tenga majaribio, na tathmini modeli dhidi ya viwango vyake vya msingi kwa kutumia sampuli kubwa badala ya kutegemea P&L ya muda mfupi.
