Jenga na Usanidi Boti ya Copy-Trading ya Polymarket kwa TypeScript

Kile Bot ya Polymarket CodeX CopyTrading Inafanya

Bot ya Polymarket CodeX CopyTrading ni programu ya TypeScript inayofuatilia shughuli kutoka kwenye pochi moja au zaidi zinazofuatwa na kuunda oda zinazolingana za Polymarket. Husoma shughuli za pochi kupitia Data API ya umma na hutumia @polymarket/clob-client-v2 kufanya biashara ya moja kwa moja kupitia kitabu cha oda cha Polymarket cha central limit order book.

Bot inaweza kunakili ununuzi na mauzo kwa kutumia kiasi maalum cha USD au ukubwa unaotegemea asilimia. Pia huhifadhi rekodi ya ndani ya biashara zilizoonekana, oda zilizozalishwa, oda zilizotekelezwa au kuigwa, na makadirio ya nafasi za tokeni.

Onyo la hatari: Hii ni programu ya biashara. Faida haihakikishwi. Anza kila mara kwa kuendesha uigaji, kagua kila thamani ya usanidi, na utumie kiasi kidogo sana kabla ya kufikiria utekelezaji wa moja kwa moja.

Vipengele Muhimu

• Hufuatilia pochi nyingi zinazofuatwa.
• Inasaidia hali za kunakili kwa kiasi maalum na kwa asilimia.
• Hutoa utekelezaji wa kuigwa kupitia npm run test.
• Hutoa utekelezaji wa moja kwa moja wa soko kupitia npm start.
• Inaweza kufuata shughuli za mauzo kwa kutumia nafasi inayofuatiliwa ndani na bot.
• Hutekeleza viwango vya chini na vya juu vya oda, nafasi, na thamani ya kila siku.
• Inasaidia tabia za oda za fill-and-kill na fill-or-kill.
• Hutoa ulinzi wa bei kwa hiari kulingana na bei ya utekelezaji wa biashara inayofuatwa.
• Huhifadhi hali katika faili la ndani la JSON.

Mahitaji

Kabla ya kusanidi bot, sakinisha programu zifuatazo:

• Node.js toleo la 20.10 au jipya zaidi.
• npm.

Pata chanzo cha mradi, fungua terminali katika saraka yake, kisha sakinisha vitegemezi vya kifurushi:

npm install

Bot inategemea kifurushi kisicho cha beta cha @polymarket/clob-client-v2 kwa utekelezaji wa oda na Polymarket Data API ya umma kwa ajili ya kupiga kura kwa shughuli za pochi.

Sanidi Taarifa za Kuingia za Biashara ya Moja kwa Moja

Unda au hariri faili la .env la mradi. Ongeza mwenyeji wa CLOB, kitambulisho cha mnyororo wa Polygon, aina ya sahihi, ufunguo binafsi, na pochi ya amana:

POLYMARKET_CLOB_HOST=https://clob.polymarket.com
POLYMARKET_CHAIN_ID=137
POLYMARKET_SIGNATURE_TYPE=POLY_1271
POLYMARKET_PRIVATE_KEY=0x...
POLYMARKET_DEPOSIT_WALLET=0x...

Usiwahi kuweka ufunguo halisi binafsi au faili la taarifa za kuingia kwenye udhibiti wa matoleo. Chukulia ufunguo binafsi na taarifa zozote za CLOB za kuingia kama siri.

Chagua Aina Sahihi ya Sahihi

POLYMARKET_SIGNATURE_TYPE inakubali thamani zifuatazo:

• EOA
• POLY_PROXY
• POLY_GNOSIS_SAFE
• POLY_1271

Kulingana na nyaraka za mradi, POLY_1271 kwa kawaida inafaa kwa watumiaji wapya wa pochi za amana. Unapofanya biashara moja kwa moja kupitia akaunti inayomilikiwa nje, chagua EOA; katika hali hiyo, POLYMARKET_DEPOSIT_WALLET inaweza kuachwa.

Tumia Taarifa Zilizopo za L2 za Kuingia

Bot inaweza kupata taarifa za kuingia wakati wa kuanzisha. Ili kuepuka hatua hiyo, toa taarifa zilizopo za L2 za kuingia katika .env:

CLOB_API_KEY=...
CLOB_SECRET=...
CLOB_PASS_PHRASE=...

Utekelezaji wa moja kwa moja hutumia createAndPostMarketOrder. Kabla ya kuanza biashara ya moja kwa moja, hakikisha pochi ya biashara imefadhiliwa na ina idhini zinazohitajika za Polymarket. Bot haitengenezi pochi wala kuidhinisha matumizi ya tokeni kiotomatiki.

Sanidi Ukubwa wa Kunakili

Programu inasaidia hali mbili za kunakili. Chagua hali inayolingana na kiwango cha uwekezaji unachotaka bot ichukue.

Hali ya Kiasi Maalum

Hali ya kiasi maalum huweka thamani ya USD iliyobainishwa awali kwa shughuli za ununuzi na mauzo zinazonakiliwa:

COPY_MODE=fixed
FIXED_BUY_AMOUNT_USD=5
FIXED_SELL_AMOUNT_USD=5

Katika mfano huu, ununuzi na mauzo yanayostahili kunakiliwa hupimwa kwa thamani iliyosanidiwa ya dola tano za Marekani.

Hali ya Asilimia

Hali ya asilimia huhesabu ukubwa wa oda kutokana na shughuli za pochi inayofuatwa:

COPY_MODE=percentage
COPY_PERCENTAGE=0.10

Kwa ununuzi, bot hunakili asilimia iliyosanidiwa ya thamani ya USD ya biashara inayofuatwa. Kwa mauzo, hunakili asilimia iliyosanidiwa ya hisa zilizouzwa na pochi inayofuatwa. Uuzaji unawekewa kikomo na nafasi inayofuatiliwa kwa sasa katika hali ya ndani ya bot.

Kwa mfano, 0.10 inawakilisha asilimia kumi. Oda halisi bado lazima ipite vidhibiti vya hatari vilivyosaniwa.

Weka Vidhibiti vya Hatari

Weka viwango vya oda na uwekezaji katika .env kabla ya kuendesha biashara ya kuigwa au ya moja kwa moja:

MIN_ORDER_USD=1
MAX_ORDER_USD=25
MAX_POSITION_USD_PER_TOKEN=100
DAILY_MAX_NOTIONAL_USD=250
ORDER_TYPE=FAK
PRICE_PROTECTION_BPS=0

• MIN_ORDER_USD huweka thamani ya chini inayoruhusiwa ya oda.
• MAX_ORDER_USD huweka kikomo cha thamani ya oda binafsi.
• MAX_POSITION_USD_PER_TOKEN huweka kikomo cha makadirio ya uwekezaji kwa kila tokeni.
• DAILY_MAX_NOTIONAL_USD huweka kikomo cha jumla ya shughuli za thamani ya kila siku.
• ORDER_TYPE hudhibiti tabia ya utekelezaji.
• PRICE_PROTECTION_BPS huweka kwa hiari kikomo cha utekelezaji kulingana na bei ya utekelezaji inayofuatwa.

Elewa Oda za FAK na FOK

Kwa ORDER_TYPE=FAK, oda inaweza kutekelezwa kwa sehemu, kisha sehemu ambayo haijatekelezwa hughairiwa. Kwa ORDER_TYPE=FOK, oda nzima lazima itekelezwe; la sivyo, oda inashindikana.

FAK inaweza kufaa wakati utekelezaji wa sehemu unakubalika. FOK ni kali zaidi, lakini inaweza kusababisha oda nyingi zaidi kushindwa wakati ukwasi kamili haupatikani.

Tumia Ulinzi wa Bei

Wakati PRICE_PROTECTION_BPS=0, mteja wa CLOB hukadiria bei mbaya zaidi inayoweza kuuzwa sokoni. Thamani isiyo sifuri inapowekwa, bot huhesabu kikomo cha bei mbaya zaidi kilicho juu ya bei ya utekelezaji inayofuatwa kwa ununuzi na chini yake kwa mauzo.

Ulinzi wa bei unaweza kuzuia mabadiliko ya bei yanayovumiliwa, lakini README haihakikishi kwamba oda itajazwa mpangilio huu unapowashwa.

Endesha Uigaji Kwanza

Anza kwa amri ya majaribio ya mradi:

npm run test

Hali hii huzalisha oda za majaribio badala ya oda za moja kwa moja za soko. Itumie kuthibitisha ufuatiliaji wa pochi, tabia ya ukubwa wa oda, vikomo vya hatari, na mipangilio ya mazingira bila kuwasilisha miamala ya moja kwa moja mara moja.

Wakati wa majaribio, thibitisha kwamba:

1. Pochi zilizokusudiwa zinafuatiliwa.
2. Tukio la ununuzi na uuzaji linasawazishwa kwa usahihi.
3. Hali ya kunakili iliyochaguliwa inazalisha ukubwa unaotarajiwa.
4. Oda zinaheshimu vikomo vya chini, vya juu, vya nafasi, na vya kila siku.
5. Ukubwa wa mauzo hauzidi nafasi inayofuatiliwa ndani ya mfumo.
6. Hali inahifadhiwa chini ya ./data/state.json.

Anza Uuzaji wa Moja kwa Moja

Baada ya kukagua matokeo ya uigaji, ufadhili wa pochi, idhini, vitambulisho, na mipangilio yote ya hatari, anza utekelezaji wa moja kwa moja kwa:

npm start

Amri hii huwasha oda za moja kwa moja za soko. Anza kwa ukubwa mdogo sana na ufuatilie matokeo ya terminali pamoja na akaunti ya Polymarket. Usidhani kwamba matokeo ya uigaji yatalingana kikamilifu na ujazaji wa oda, ukwasi, au mabadiliko ya bei ya moja kwa moja.

Elewa Hali ya Ndani

Bot huhifadhi hali yake ya ndani kwenye:

./data/state.json

Faili hii hufuatilia miamala iliyoonekana, oda zilizoigizwa au kutekelezwa, na nafasi za takriban. Husaidia kuzuia shughuli zilizochakatwa awali kuchukuliwa kuwa mpya na kuipa mantiki ya kufuata mauzo mtazamo wa ndani kuhusu nafasi zinazopatikana.

Nafasi ni za takriban pekee kwa sababu oda za soko zinaweza kujazwa kwa sehemu. Kwa hiyo, hali ya ndani inaweza kutofautiana na salio halisi la akaunti.

Vidokezo vya Juu vya Uendeshaji

Ongeza Upatanishaji wa Nafasi

Kwa matumizi ya uzalishaji, README inapendekeza kuongeza kazi ya upatanishaji wa mara kwa mara. Kazi hiyo inapaswa kuuliza endpoint ya /positions ya Data API kwa POLYMARKET_DEPOSIT_WALLET na kulinganisha nafasi zilizorejeshwa na hali ya ndani.

Hili ni muhimu hasa baada ya ujazaji wa sehemu, oda zilizoshindwa, miamala ya mikono, kuwashwa upya, au shughuli yoyote iliyofanywa nje ya bot.

Linda Faili ya Hali

Hifadhi nakala ya ./data/state.json kabla ya masasisho au mabadiliko ya uendeshaji. Epuka kuihariri bot inapofanya kazi. Kwa kuwa huhifadhi shughuli zilizoonekana na nafasi za takriban, kuifuta au kuiharibu kunaweza kuathiri utambuzi wa nakala na ukubwa wa mauzo.

Tumia Vikomo vya Tahadhari

Anza na MAX_ORDER_USD, MAX_POSITION_USD_PER_TOKEN, na DAILY_MAX_NOTIONAL_USD za chini. Ziongeze tu baada ya kuichunguza bot katika hali halisi za soko. Vikomo vya hatari huzuia ukubwa wa uwekezaji, lakini haviondoi hatari ya utekelezaji, ukwasi, soko, au programu.

Kagua Faili Husika za Msimbo

Hifadhi ya msimbo hutenganisha majukumu ya usanidi, upigaji kura, mkakati, utekelezaji, na hali:

• src/config.ts hushughulikia uchanganuzi wa mazingira na ukaguzi wa usalama.
• src/index.ts ina mzunguko mkuu wa upigaji kura.
• src/polymarket/dataApi.ts hufanya usomaji wa Data API ya umma.
• src/watchers/walletWatcher.ts hupiga kura ya shughuli za pochi nyingi.
• src/polymarket/tradeParser.ts husawazisha matukio ya shughuli.
• src/strategy/copyStrategy.ts hutekeleza upangaji wa ukubwa wa kudumu na wa asilimia.
• src/strategy/riskManager.ts hutekeleza vikomo vya oda, kila siku, na nafasi.
• src/polymarket/orderExecutor.ts hushughulikia utekelezaji wa majaribio na wa moja kwa moja.
• src/storage/stateStore.ts husimamia hali ya ndani ya JSON.

Kukagua faili hizi ni muhimu kabla ya kusambaza mfumo moja kwa moja, hasa ikiwa unahitaji kuelewa tabia ya upigaji kura, ukaguzi wa usalama, usawazishaji wa matukio, au upangaji wa ukubwa wa oda.

Hitimisho

Polymarket CodeX CopyTrading Bot hutoa mtiririko wa kazi wa TypeScript wa kufuatilia pochi nyingi na kunakili manunuzi na mauzo yanayostahili kwa ukubwa wa kudumu au unaotegemea asilimia. Sanidi vitambulisho kwa uangalifu, tekeleza vikomo vya tahadhari vya hatari, thibitisha tabia kupitia npm run test, na upatanishe nafasi za ndani kabla ya kutegemea npm start kwa uuzaji wa moja kwa moja.