Apabila sebuah bot berhenti melakukan apa yang anda jangkakan, hampir selalunya puncanya ialah salah satu daripada segelintir perkara yang boleh dibaiki — biasanya sesuatu di sebelah exchange, seperti dana atau kebenaran API. Panduan ini membincangkan setiap satu, daripada yang paling lazim hingga yang paling jarang.
Tidak sama dengan bot yang tidak membuka trade. Jika bot anda berjalan dengan baik tetapi belum masuk ke posisi, itu biasanya berkenaan syarat kemasukan (entry) — lihat Mengapa Bot Saya Tidak Berdagang?. Artikel ini membincangkan bot yang dijeda, berhenti, atau mengalami ralat.
Perkara Utama
- Sebuah bot bergerak melalui status yang jelas — Aktif (menunggu untuk masuk), Mencetus, Berjalan (posisi terbuka), Dijeda, Menunggu Jeda, dan Ralat — dan panduan ini membincangkan mengapa sebuah bot dijeda, berhenti, atau mengalami ralat.
- Sebab paling lazim sebuah bot berhenti melaksanakan order ialah baki atau margin yang tidak mencukupi pada akaun exchange anda.
- Masalah API key — key yang tidak sah, dibatalkan, atau salah kebenaran, atau sekatan IP-whitelist — juga menghentikan bot; menyambung semula dengan key read-and-trade yang baharu akan membaikinya.
- Pada futures, leveraj yang terlalu tinggi untuk pair tersebut atau ketidakpadanan mod posisi boleh menyekat order.
- Banyak ralat exchange (rate limit, timeout, jam/timestamp) bersifat sementara; Freya memberitahu anda apabila sebuah bot gagal supaya anda boleh bertindak.
Status Bot Sekilas Pandang
- Aktif — hidup dan memerhati pasaran untuk syarat kemasukannya; belum ada posisi terbuka.
- Mencetus — syarat kemasukan telah dipenuhi; bot sedang membuka posisinya.
- Berjalan — sebuah posisi terbuka dan bot sedang mengurus deal (safety order, take-profit, exit).
- Dijeda — anda menjedanya; bot tidak akan membuka posisi baharu sehingga anda menyambungnya semula.
- Menunggu Jeda — anda menjedanya semasa posisi masih terbuka; bot menyelesaikan pengendalian posisi itu dengan selamat, kemudian menjadi Dijeda.
- Ralat — bot cuba bertindak tetapi exchange atau satu semakan menolaknya; bot berhenti dan menandakan masalahnya.
- Menutup / Ditutup — bot sedang menyelesaikan deal; setelah selesai, deal disimpan ke sejarah anda.
(Untuk rujukan status penuh dengan perbezaan AKTIF-lawan-BERJALAN, lihat Mengapa Bot Saya Tidak Berdagang?.)
Apabila sebuah bot menghadapi masalah yang tidak dapat dipulihkannya sendiri, bot berpindah ke keadaan ralat dan anda menerima notifikasi "bot gagal" (jika anda telah menyediakan notifikasi) supaya anda boleh membaikinya dengan cepat.
Punca Paling Lazim: Baki atau Margin Tidak Mencukupi
Setakat ini, sebab paling kerap sebuah bot berhenti meletakkan order ialah baki tidak mencukupi (spot) atau margin tidak mencukupi (futures) pada akaun exchange anda. Bot anda cuba meletakkan order — base order, averaging order, atau take-profit — dan exchange menolaknya kerana dananya tiada.
Pembaikan: pastikan akaun exchange anda mempunyai cukup baki/margin bebas untuk menampung keseluruhan rancangan bot — termasuk setiap averaging order dalam grid-nya. (Inilah sebabnya membiayai keseluruhan grid itu penting; lihat Order Kemasukan & Grid.)
Masalah API Key
Jika Freya tidak lagi boleh bertindak bagi pihak anda, bot berhenti. Punca lazim berkaitan API key:
- Key tidak sah, dibatalkan, atau dijana semula — jika anda memadam atau memutar (rotate) key di exchange, salinan milik Freya tidak lagi berfungsi.
- Kebenaran yang salah — key memerlukan kebenaran read dan trade (jangan sekali-kali withdrawal). Key read-only tidak boleh meletakkan order.
- Sekatan IP whitelist — jika anda menghadkan key kepada IP tertentu, IP pelayan Freya mestilah dibenarkan (IP ini dipaparkan semasa anda menyambungkan exchange).
Pembaikan: sambung semula dengan key read-and-trade yang baharu. Lihat Cara Menyambungkan Exchange Anda dan Mengurus API Key Anda.
Order Terlalu Kecil
Setiap exchange mempunyai saiz order minimum (nilai notional minimum). Jika jumlah order anda — atau satu order grid individu — jatuh di bawahnya, exchange menolak order tersebut.
Pembaikan: tingkatkan jumlah dagangan anda (atau volume setiap order) supaya setiap order melepasi minimum exchange.
Khusus Futures: Leveraj dan Mod Posisi
Pada futures, dua tetapan boleh menyekat order:
- Leveraj terlalu tinggi — leveraj yang anda tetapkan melebihi yang dibenarkan exchange untuk pair tersebut. Turunkannya ke tahap yang dibenarkan.
- Ketidakpadanan mod posisi — akaun exchange anda berada dalam mod posisi yang berbeza (hedge lawan one-way) daripada yang dijangka bot. Selaraskan mod posisi di exchange dengan cara bot berdagang.
Isu Exchange Sementara
Sesetengah ralat bukan kesalahan anda dan sering kali pulih dengan sendirinya:
- Rate limit — terlalu banyak request dalam tempoh singkat.
- Timeout / ralat rangkaian — masalah sambungan sekejap dengan exchange.
- Ralat timestamp — isu penyegerakan jam antara sistem dan exchange.
- Exchange sibuk / maintenance — exchange itu sendiri terlebih beban atau sedang down.
Pembaikan: ini biasanya selesai dengan sendirinya. Jika sebuah bot mengalami ralat kerana salah satu daripadanya, anda biasanya boleh menyambungnya semula sebaik sahaja exchange bertindak balas normal semula.
Apa yang Perlu Dilakukan: Senarai Semak Ringkas
- Semak baki/margin exchange anda — punca nombor satu. Isi semula jika rendah.
- Semak API key anda — masih sah, kebenaran read-and-trade, IP Freya dibenarkan.
- Semak saiz order — melebihi minimum exchange.
- Pada futures, sahkan leveraj berada dalam had dan mod posisi sepadan.
- Jika ia ralat sementara, tunggu exchange pulih dan sambung semula bot.
- Masih tersekat? Hubungi [email protected].
Soalan Lazim
Mengapa bot saya dijeda atau berhenti?
Paling kerap kerana exchange menolak sebuah order — biasanya baki atau margin tidak mencukupi, masalah API key, atau order di bawah saiz minimum exchange. Pada futures, tetapan leveraj atau mod posisi juga boleh menyekat order. Isu exchange sementara (rate limit, timeout) juga boleh menghentikan bot, tetapi itu biasanya pulih dengan sendirinya.
Apakah maksudnya apabila bot saya berada dalam keadaan ralat?
Bot cuba bertindak tetapi sesuatu menolak tindakan itu, jadi bot berhenti dan menandakan masalahnya dan bukannya terus melaju secara membuta tuli. Anda akan menerima notifikasi "bot gagal" (jika notifikasi dihidupkan). Baiki punca asasnya — biasanya baki atau API key — dan anda boleh menjalankannya semula.
Bot saya menyatakan baki tidak mencukupi — apa yang perlu saya lakukan?
Tambahkan dana ke akaun exchange anda supaya ada cukup baki bebas (spot) atau margin (futures) untuk menampung order bot, termasuk grid averaging order-nya. Bot tidak dapat meletakkan order kerana dananya tidak tersedia di exchange.
Mungkinkah API key saya yang menjadi masalah?
Ya — ini punca yang lazim. Jika key dipadam, dijana semula, atau ditetapkan kepada read-only, atau jika ia dihadkan IP dan IP pelayan Freya tidak dibenarkan, bot tidak boleh berdagang. Sambung semula dengan key baharu yang mempunyai kebenaran read dan trade (jangan sekali-kali withdrawal).
Bot futures saya tidak mahu meletakkan order — mungkinkah kerana leveraj atau mod posisi?
Ya. Jika leveraj anda lebih tinggi daripada yang dibenarkan exchange untuk pair tersebut, atau mod posisi akaun anda (hedge lawan one-way) tidak sepadan dengan cara bot berdagang, order akan ditolak. Turunkan leveraj ke tahap yang dibenarkan dan selaraskan mod posisi di exchange.
Adakah saya akan diberitahu jika bot saya gagal?
Ya — jika anda telah menyediakan notifikasi, Freya menghantar amaran "bot gagal" apabila sebuah bot masuk ke keadaan ralat, supaya anda boleh bertindak dengan cepat. Lihat Cara Menyediakan Notifikasi.
Bot saya berjalan tetapi belum membuka sebarang trade — adakah itu perkara yang sama?
Tidak. Bot yang berjalan tetapi belum masuk ke posisi biasanya cuma belum memenuhi syarat kemasukannya — itu dibincangkan dalam Mengapa Bot Saya Tidak Berdagang?. Artikel ini membincangkan bot yang dijeda, berhenti, atau mengalami ralat.
