Használati útmutató

Minden, amit a bot üzemeltetéséről tudni kell

A telepítéstől a napi üzemig: beállítások, a vezérlőpult minden eleme, Telegram parancsok, párváltás és hibaelhárítás. 10 perc olvasás, aztán a bot dolgozik helyetted.

01Telepítés, nulláról futó botig

OKX számlaHa még nincs, regisztrálj: my.okx.com/join/AFFILION. Végezd el a személyazonosítást (KYC), és tölts fel USDC-t a Trading accountba. A grid vételi oldalához alapbeállításon ~250-300 USDC az ideális.
Python telepítéseTöltsd le a python.org-ról, telepítéskor pipáld be az "Add python.exe to PATH" opciót. Ennyi, más nem kell.
API kulcs létrehozásamy.okx.com → Profil → API → Create API key. Jogosultság: Trade igen, Withdraw SOHA. A passphrase-t te adod meg, jegyezd fel pontosan. Így a kulcs akkor sem alkalmas pénzkivonásra, ha bármi történne.
ZIP kicsomagolás és configCsomagold ki a letöltött ZIP-et pl. a C:\okx-grid\ mappába, és a grid_config.json-ban töltsd ki az okx blokk három mezőjét a kulcsoddal.
IndításDupla katt a start_grid.bat-ra. Az első indításnál magától telepíti az egyetlen függőséget (ccxt), aztán elindul. A vezérlőpult: http://127.0.0.1:8093 a böngésződben. A bot papír (DRY) módban indul, éles pénzt nem mozgat, amíg te nem kapcsolod át.
Mikor élesíts? Futtasd papíron 1-2 napig, nézd meg a vezérlőpulton, hogyan viselkedik, aztán a "Váltás ÉLES-re" gombbal élesíthetsz. Az éles mód valódi ordereket tesz ki a valódi egyenlegedből.

02A grid_config.json mezői

Mindent a vezérlőpultról is állíthatsz, a fájlt csak az első beállításnál kell megnyitnod.

MezőAlapértékMit csinál
modedrydry = papír kereskedés (szimuláció), live = éles. A váltás a dashboardról is megy.
pairETH/USDCa kereskedett spot pár. A dashboardon választható: ETH, BTC, SOL, XRP, DOGE, LTC mind USDC ellenében.
grid.auto_range_pct6.0ha az alsó/felső ár 0, a sáv az aktuális ár ±ennyi százaléka lesz.
grid.lower / upper0 / 0kézi sávhatárok. 0 = automatikus a fenti százalékból.
grid.levels13hány szintre osztja a sávot. 13 szint = 12 grid lépés.
grid.order_quote_usd40ennyi dollár értékű order ül minden szinten. Ez határozza meg a tőkeigényt is.
grid.spacinggeometricgeometrikus (százalékosan egyenlő) vagy aritmetikus (dollárban egyenlő) szintközök.
auto_seedtrueha nincs elég coin az eladási szintekhez, induláskor bevásárolja a hiányzót.
stop_out_of_rangefalseha az ár elhagyja a sávot: false = értesít és vár, true = értesít és szünetel.
telegram.token / chat_idüresopcionális: @BotFather-től bot token, @userinfobot-tól a saját chat_id-d.

03A vezérlőpult elemei

ElemMit látsz / mit tehetsz
Fejléc badge-ekÉLES/DRY állapot, MOTOR heartbeat (zöld pötty = a kereskedő ciklus él, a szám mutatja, hány másodperce futott), uptime.
KPI sorélő ár, TELJES KÉP (nettó + lebegő együtt), nettó realizált, mai eredmény, összes fee, könyvben ülő orderek száma.
Grid létraminden szint egy sor: ár, BUY/SELL, mennyiség és dollárérték, státusz (zöld pötty = könyvben), távolság az ártól, ki/be gomb szintenként. Az AKTUÁLIS ÁR sáv mutatja, hol jár a piac.
Legközelebbi vétel / eladása két kártya mutatja, hány százalékra van az ár a következő filltől mindkét irányban.
Egyenlegek és készletcoin és USDC szabad/összes egyenleg élőben, plusz a párosításra váró készlet átlagárral.
Vezérlés gombokPause/Folytatás, Orderek kihelyezése, Grid újraépítés (új sáv az aktuális ár körül), Stop (minden order vissza), mód váltás, Telegram teszt, körök CSV export.
Paraméterekpár, sáv, szintek, USD/szint, loop sebesség, osztás, auto seed, élőben szerkesztve. A becslő mutatja: egy lépés hány %, egy kör várható nettója, és a vételi oldal tőkeigénye. "Mentés + újraépítés" = azonnal az új beállításokkal.
Eredmény, tételesenbruttó → fee → nettó → lebegő → TELJES KÉP levezetés, plusz átlag/legjobb/legrosszabb kör.
Napi bontás / Volumen füleknaponta hány kör és mennyi nettó, illetve napi/heti/havi/összes kereskedett volumen 14 napos diagrammal.
Fillek, Lezárt körök, Eseményekminden kitöltés, minden lezárt kör nettóval, és a bot teljes eseménynaplója.

04Telegram vezérlés

Ha kitöltöd a tokent és a chat_id-t, a bot értesít minden körről és napi riportokat küld (7:00 és 19:00 UTC), plusz parancsokkal távolról is irányíthatod:

/statusteljes állapot: ár, sáv, orderek, körök, profit
/pausefill-kezelés szünetel, az orderek a könyvben maradnak
/resumefolytatás
/rebuildúj grid az aktuális ár körül
/stopminden order visszavonása és leállás
/helpparancslista

05Párváltás: ETH-ról bármire

A Paraméterek közt a Kereskedett pár lenyíló: ETH/USDC, BTC/USDC, SOL/USDC, XRP/USDC, DOGE/USDC, LTC/USDC. A váltás menete:

Válaszd ki az új párta lenyílóban, majd nyomj Mentést. A rendszer rákérdez, mert párváltáshoz újraépítés kell.
A bot elvégzi a többitvisszavonja a régi pár összes orderét, kiüríti a készlet-sort, és az új pár aktuális ára körül felhúzza az új gridet. Telegramon is jelez.
Fontos: a régi pár párosításra váró készlete (ha épp volt) a számládon marad coin formában, azt kézzel tudod eladni az OKX-en, a bot az új páron tiszta lappal indul. Ezért érdemes olyankor váltani, amikor a készlet-sor üres.

06Paraméter-tippek

Sáv szélesség

A ±6% nyugodt piacra való. Ha az ár sokszor kiszalad a sávból, szélesítsd (±8-10%), ha alig mozdul, szűkítsd (±4%), így sűrűbben zárnak a körök. A "Grid újraépítés" gomb bármikor újrahúzza a sávot az aktuális ár köré.

Szintek és order méret

Több szint = kisebb lépések = gyakoribb, kisebb körök. A becslő megmutatja a matekot: egy kör nettója akkor egészséges, ha a grid lépés jóval nagyobb, mint a két maker fee (0.16%) együtt. 0.5% alá ne vidd a lépésközt, mert a fee megeszi a profitot.

Tőkeigény

Vételi oldal: kb. USD/szint × szintek fele USDC-ben. Eladási oldal: ugyanennyi értékű coin, amit az auto seed magától bevásárol. 13 szint × 40$ mellett ez ~240 USDC + ~240$ értékű coin.

Mikor jó a grid, és mikor nem

A grid oldalazó, hullámzó piacon termel. Erős trendben az egyik oldala kifogy: emelkedésben eladja a készletet és USDC-ben ül (lemarad a rally-ról), esésben veszi a coint lefelé (lebegő mínusz gyűlik, amíg vissza nem pattan). Ez nem hiba, hanem a stratégia természete, ezért érdemes a Volumen és a Teljes kép mutatókat együtt nézni.

07Hibaelhárítás

TünetOk és megoldás
50119 API key doesn't exista kulcs a globális OKX-en készült, nem a my.okx.com-on, vagy elgépelt passphrase, vagy IP whitelist. A configban a "site": "eu" maradjon.
a port foglalt, kilépekmár fut egy példány (a 8093-as port egyben zárolás). Zárd be a másik ablakot. A portot a configban átteheted.
order_quote_usd túl kicsiaz adott pár minimum order értéke nagyobb. Emeld a USD/szint értéket a jelzett minimum fölé.
nem jön Telegram üzeneta Telegram teszt gombbal ellenőrizd. 404 = hibás token (BotFather formátum: 123456:ABC...), csend = rossz chat_id.
az ár kiment a sávbólnem hiba, a bot értesít és vár. "Grid újraépítés" gombbal új sávot húzol az aktuális ár köré.
sokáig nincs környugodt piacon normális. Szűkebb sáv vagy több szint sűríti a köröket, de a lépésköz ne menjen 0.5% alá.
a gép leállt, mi lesz az orderekkel?semmi, a limit orderek az OKX szerverén élnek. Újraindításkor a bot egyezteti és folytatja a meglévő gridet.
Jogi nyilatkozat: ez a szoftver és útmutató oktatási célú, nem pénzügyi jellegű ajánlás. A kriptokereskedés a befektetett összeg teljes elvesztésével járhat. Csak olyan összeggel használd, aminek az elvesztése nem fáj.
⭳ BOT LETÖLTÉSE (ZIP) ← VISSZA A FŐOLDALRA