TypeScript yordamida Polymarket copy-trading botini yaratish va sozlash

Polymarket CodeX CopyTrading Boti nima qiladi

Polymarket CodeX CopyTrading Boti bir yoki bir nechta kuzatilayotgan hamyonlarning faolligini nazorat qiluvchi va tegishli Polymarket buyurtmalarini yaratuvchi TypeScript ilovasidir. U hamyon faolligini ochiq Data API orqali o‘qiydi va Polymarket markaziy limitli orderlar kitobi orqali jonli savdo qilish uchun @polymarket/clob-client-v2 dan foydalanadi.

Bot xaridlar va sotuvlarni qat’iy USD summalari yoki foiz asosidagi hajmlar yordamida nusxalashi mumkin. Shuningdek, u ko‘rilgan savdolar, yaratilgan buyurtmalar, bajarilgan yoki simulyatsiya qilingan buyurtmalar hamda taxminiy token pozitsiyalarining mahalliy qaydini yuritadi.

Xavf haqida ogohlantirish: Bu savdo dasturidir. Foyda kafolatlanmaydi. Har doim avval simulyatsiyani ishga tushiring, barcha konfiguratsiya qiymatlarini tekshiring va jonli ijroni ko‘rib chiqishdan oldin juda kichik summalardan foydalaning.

Asosiy imkoniyatlar

• Bir nechta kuzatilayotgan hamyonlarni nazorat qiladi.
• Qat’iy summa va foiz asosidagi nusxalash rejimlarini qo‘llab-quvvatlaydi.
• npm run test orqali simulyatsiya qilingan ijroni taqdim etadi.
• npm start orqali jonli bozor ijrosini taqdim etadi.
• Bot mahalliy kuzatib boradigan pozitsiya yordamida sotuv faolligini ham kuzatishi mumkin.
• Minimal buyurtma, maksimal buyurtma, pozitsiya va kunlik nominal limitlarni qo‘llaydi.
• Fill-and-kill va fill-or-kill buyurtma xatti-harakatlarini qo‘llab-quvvatlaydi.
• Kuzatilayotgan savdoning bajarilish narxiga nisbatan ixtiyoriy narx himoyasini taklif etadi.
• Holatni mahalliy JSON faylida saqlaydi.

Talablar

Botni sozlashdan oldin quyidagi dasturlarni o‘rnating:

• Node.js 20.10 yoki undan yangi versiyasi.
• npm.

Loyiha manba kodini oling, uning katalogida terminalni oching va paket bog‘liqliklarini o‘rnating:

npm install

Bot buyurtmalarni bajarish uchun beta bo‘lmagan @polymarket/clob-client-v2 paketiga, hamyon faolligini so‘rov orqali tekshirish uchun esa ochiq Polymarket Data API ga tayanadi.

Jonli savdo ma’lumotlarini sozlash

Loyihaning .env faylini yarating yoki tahrirlang. CLOB hosti, Polygon tarmoq ID raqami, imzo turi, maxfiy kalit va depozit hamyonini qo‘shing:

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

Haqiqiy maxfiy kalit yoki credential faylini hech qachon versiyalarni boshqarish tizimiga yuklamang. Maxfiy kalit va har qanday CLOB credential ma’lumotlarini sir saqlang.

To‘g‘ri imzo turini tanlang

POLYMARKET_SIGNATURE_TYPE quyidagi qiymatlarni qabul qiladi:

• EOA
• POLY_PROXY
• POLY_GNOSIS_SAFE
• POLY_1271

Loyiha hujjatlariga ko‘ra, POLY_1271 odatda yangi depozit hamyoni foydalanuvchilari uchun mos keladi. Tashqi egalik qilinadigan hisob orqali to‘g‘ridan-to‘g‘ri savdo qilganda EOA ni tanlang; bu holatda POLYMARKET_DEPOSIT_WALLET ni kiritmaslik mumkin.

Mavjud L2 credential ma’lumotlaridan foydalaning

Bot ishga tushirilganda credential ma’lumotlarini hosil qilishi mumkin. Bu bosqichni chetlab o‘tish uchun mavjud L2 credential ma’lumotlarini .env fayliga kiriting:

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

Jonli ijroda createAndPostMarketOrder ishlatiladi. Jonli savdoni boshlashdan oldin savdo hamyoni mablag‘ bilan ta’minlanganiga va zarur Polymarket ruxsatlariga ega ekaniga ishonch hosil qiling. Bot hamyonlarni yaratmaydi va token sarflashni avtomatik ravishda tasdiqlamaydi.

Nusxalash hajmini sozlash

Ilova ikki xil nusxalash rejimini qo‘llab-quvvatlaydi. Bot qancha ekspozitsiya olishi kerakligiga mos rejimni tanlang.

Qat’iy summa rejimi

Qat’iy summa rejimi nusxalangan xarid va sotuv faolligiga oldindan belgilangan USD summasini tayinlaydi:

COPY_MODE=fixed
FIXED_BUY_AMOUNT_USD=5
FIXED_SELL_AMOUNT_USD=5

Ushbu misolda mos keladigan nusxalangan xarid va sotuvlar besh AQSh dollariga sozlangan qiymat asosida hajmlanadi.

Foiz rejimi

Foiz rejimi buyurtma hajmlarini kuzatilayotgan hamyon faolligidan hisoblaydi:

COPY_MODE=percentage
COPY_PERCENTAGE=0.10

Xaridlar uchun bot kuzatilayotgan savdoning USD nominal qiymatidan sozlangan foizni nusxalaydi. Sotuvlar uchun esa kuzatilayotgan hamyon sotgan ulushlarning sozlangan foizini nusxalaydi. Sotuv botning mahalliy holatida hozir kuzatilayotgan pozitsiya bilan cheklanadi.

Masalan, 0.10 o‘n foizni bildiradi. Haqiqiy buyurtma baribir sozlangan xavf nazoratlaridan o‘tishi kerak.

Xavf nazoratlarini belgilang

Simulyatsiya qilingan yoki jonli savdoni ishga tushirishdan oldin .env faylida buyurtma va ekspozitsiya limitlarini belgilang:

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 ruxsat etilgan buyurtma qiymatining eng kam miqdorini belgilaydi.
• MAX_ORDER_USD bitta buyurtma qiymatini cheklaydi.
• MAX_POSITION_USD_PER_TOKEN har bir token uchun taxminiy ekspozitsiyani cheklaydi.
• DAILY_MAX_NOTIONAL_USD kunlik umumiy nominal faollikni cheklaydi.
• ORDER_TYPE bajarilish xatti-harakatini boshqaradi.
• PRICE_PROTECTION_BPS ixtiyoriy ravishda ijroni kuzatilayotgan bajarilish narxiga nisbatan cheklaydi.

FAK va FOK buyurtmalarini tushuning

ORDER_TYPE=FAK bo‘lganda buyurtma qisman bajarilishi mumkin, shundan so‘ng bajarilmagan qismi bekor qilinadi. ORDER_TYPE=FOK bo‘lganda esa butun buyurtma bajarilishi kerak; aks holda buyurtma muvaffaqiyatsiz bo‘ladi.

Qisman ijro maqbul bo‘lsa, FAK mos kelishi mumkin. FOK qat’iyroq, ammo to‘liq likvidlik mavjud bo‘lmaganda ko‘proq buyurtmalar bajarilmay qolishi mumkin.

Narx himoyasini qo‘llang

PRICE_PROTECTION_BPS=0 bo‘lganda CLOB mijozi bozorda bajarilishi mumkin bo‘lgan eng yomon narxni hisoblaydi. Nolga teng bo‘lmagan qiymat sozlanganda bot xaridlar uchun kuzatilayotgan bajarilish narxidan yuqori, sotuvlar uchun esa undan past bo‘lgan eng yomon narx limitini hisoblaydi.

Narxni himoyalash ruxsat etilgan narx o‘zgarishini cheklashi mumkin, biroq README ushbu sozlama yoqilganda buyurtma bajarilishini kafolatlamaydi.

Avval simulyatsiyani ishga tushiring

Loyihaning test buyrug‘i bilan boshlang:

npm run test

Bu rejim real bozor buyurtmalari o‘rniga simulyatsiya qilingan buyurtmalarni yaratadi. Undan hamyonlarni kuzatish, hajmni belgilash xatti-harakati, risk cheklovlari va muhit sozlamalarini real savdolarni darhol yubormasdan tekshirish uchun foydalaning.

Test davomida quyidagilarni tekshiring:

1. Ko‘zda tutilgan hamyonlar kuzatilayotganini.
2. Xarid va sotuv hodisalari to‘g‘ri normallashtirilayotganini.
3. Tanlangan nusxalash rejimi kutilgan hajmlarni yaratishini.
4. Buyurtmalar minimal, maksimal, pozitsiya va kunlik cheklovlarga rioya qilishini.
5. Sotuv hajmlari mahalliy kuzatilayotgan pozitsiyadan oshmasligini.
6. Holat ./data/state.json ostida qayd etilishini.

Real savdoni boshlang

Simulyatsiya natijalari, hamyon mablag‘lari, tasdiqlar, hisob ma’lumotlari va barcha risk sozlamalarini ko‘rib chiqqaningizdan so‘ng, real ijroni quyidagi buyruq bilan boshlang:

npm start

Bu buyruq real bozor buyurtmalarini yoqadi. Juda kichik hajmlardan boshlang va terminal chiqishi hamda Polymarket hisobini kuzatib boring. Simulyatsiya natijalari real bajarilishlar, likvidlik yoki narx o‘zgarishlariga aynan mos keladi, deb o‘ylamang.

Mahalliy holatni tushuning

Bot o‘zining mahalliy holatini quyidagi manzilda saqlaydi:

./data/state.json

Bu faylda ko‘rilgan savdolar, simulyatsiya qilingan yoki bajarilgan buyurtmalar va taxminiy pozitsiyalar qayd etiladi. U avval qayta ishlangan faoliyatning yangi sifatida ko‘rilishining oldini olishga yordam beradi hamda sotuvni kuzatish mantiqiga mavjud pozitsiyalar haqida mahalliy ma’lumot beradi.

Bozor buyurtmalari qisman bajarilishi mumkinligi sababli pozitsiyalar faqat taxminiy hisoblanadi. Shu bois mahalliy holat amaldagi hisobdagi mablag‘lardan farq qilishi mumkin.

Ilg‘or operatsion maslahatlar

Pozitsiyalarni muvofiqlashtirishni qo‘shing

Ishlab chiqarish muhitida foydalanish uchun README davriy muvofiqlashtirish vazifasini qo‘shishni tavsiya qiladi. Vazifa Data API’ning /positions endpoint’idan POLYMARKET_DEPOSIT_WALLET uchun ma’lumot so‘rashi va qaytarilgan pozitsiyalarni mahalliy holat bilan taqqoslashi kerak.

Bu, ayniqsa, qisman bajarilishlar, muvaffaqiyatsiz buyurtmalar, qo‘lda amalga oshirilgan savdolar, qayta ishga tushirishlar yoki botdan tashqarida bajarilgan har qanday faoliyatdan keyin muhimdir.

Holat faylini himoyalang

Yangilash yoki operatsion o‘zgarishlardan oldin ./data/state.json faylining zaxira nusxasini yarating. Bot ishlayotgan paytda uni tahrirlashdan saqlaning. U ko‘rilgan faoliyat va taxminiy pozitsiyalarni qayd etgani sababli, uni o‘chirish yoki buzish dublikatlarni aniqlash va sotuv hajmini belgilashga ta’sir qilishi mumkin.

Ehtiyotkor cheklovlardan foydalaning

Dastlab MAX_ORDER_USD, MAX_POSITION_USD_PER_TOKEN va DAILY_MAX_NOTIONAL_USD qiymatlarini past darajada belgilang. Ularni faqat botni real bozor sharoitlariga yaqin muhitda kuzatganingizdan keyin oshiring. Risk cheklovlari ta’sirni cheklaydi, biroq ijro, likvidlik, bozor yoki dasturiy ta’minot risklarini bartaraf etmaydi.

Tegishli manba fayllarini ko‘rib chiqing

Repozitoriy konfiguratsiya, so‘rov yuborish, strategiya, ijro va holat uchun javobgarliklarni alohida qismlarga ajratadi:

• src/config.ts muhit o‘zgaruvchilarini tahlil qilish va xavfsizlik tekshiruvlarini bajaradi.
• src/index.ts asosiy so‘rov yuborish siklini o‘z ichiga oladi.
• src/polymarket/dataApi.ts ochiq Data API’dan ma’lumotlarni o‘qiydi.
• src/watchers/walletWatcher.ts bir nechta hamyonlar faoliyatini so‘rovlar orqali kuzatadi.
• src/polymarket/tradeParser.ts faoliyat hodisalarini normallashtiradi.
• src/strategy/copyStrategy.ts belgilangan va foiz asosidagi hajmni belgilashni amalga oshiradi.
• src/strategy/riskManager.ts buyurtma, kunlik va pozitsiya cheklovlarini qo‘llaydi.
• src/polymarket/orderExecutor.ts simulyatsiya qilingan va real ijroni boshqaradi.
• src/storage/stateStore.ts mahalliy JSON holatini boshqaradi.

Real ishga tushirishdan oldin ushbu fayllarni ko‘rib chiqish foydali, ayniqsa so‘rov yuborish xatti-harakati, xavfsizlik tekshiruvlari, hodisalarni normallashtirish yoki buyurtma hajmini belgilashni tushunishingiz kerak bo‘lsa.

Xulosa

Polymarket CodeX CopyTrading Bot bir nechta hamyonlarni kuzatish va belgilangan yoki foiz asosidagi hajm yordamida mos keladigan xaridlar hamda sotuvlarni nusxalash uchun TypeScript asosidagi ish jarayonini taqdim etadi. Hisob ma’lumotlarini ehtiyotkorlik bilan sozlang, konservativ risk cheklovlarini qo‘llang, xatti-harakatni npm run test orqali tekshiring va real savdolar uchun npm start buyrug‘iga tayanishdan oldin mahalliy pozitsiyalarni muvofiqlashtiring.