Ketika Anda menambahkan API key exchange, Freya memeriksanya sebelum menyimpan — dan jika ada yang tidak beres, Freya memberi tahu apa yang harus diperbaiki. Panduan ini membantu Anda membaca hasil tersebut dan memperbaikinya. (Jika key Anda sudah terhubung dengan baik tetapi bot kemudian berhenti, itu masalah yang berbeda — lihat Mengapa Bot Saya Berhenti Sementara atau Berhenti?.)
Untuk langkah-langkah setup pertama kali, mulailah dengan Cara Menghubungkan Exchange Anda; artikel ini membahas apa yang harus dilakukan ketika koneksi tersebut gagal.
Poin Penting
- Ketika Anda menambahkan key, Freya memeriksa bahwa key terhubung dan memiliki izin yang tepat sebelum menyimpannya — jika ada yang gagal, pesan error memberi tahu apa yang harus diperbaiki.
- "Invalid API Key/Secret" biasanya berarti kesalahan salin/tempel atau key yang telah dibuat ulang; error "IP" berarti pembatasan IP pada key tidak cocok dengan yang dibutuhkan Freya.
- Key Anda harus memiliki izin baca dan trade (jangan pernah penarikan) dan diaktifkan untuk pasar yang tepat — spot atau futures — agar cocok dengan bot Anda.
- Key OKX memerlukan passphrase yang harus cocok persis; untuk key futures, Freya secara otomatis menyiapkan akun Anda agar bot dapat trading dengan benar.
- "Connection Failed" yang umum sering kali hanya gangguan jaringan atau exchange sesaat — cukup coba lagi.
Ketika Key Tidak Mau Terhubung
Menambahkan key bukanlah penyimpanan tanpa pemeriksaan — Freya memverifikasi bahwa key berfungsi dan memiliki izin yang tepat sebelum disimpan secara terenkripsi. Jika ada yang tidak beres, pesan error langsung mengarahkan Anda ke penyebabnya — biasanya key atau secret, pembatasan IP, atau izin yang hilang. Bagian-bagian di bawah ini menelusuri setiap error dan cara memperbaikinya.
"Invalid API Key" atau "Invalid Secret Key"
Error koneksi yang paling umum, dan biasanya yang paling sederhana:
- Kesalahan salin/tempel — spasi yang terselip atau karakter yang hilang. Salin ulang key dan secret dengan hati-hati.
- Secret hanya ditampilkan sekali. Exchange menampilkan secret key satu kali saja saat Anda membuatnya. Jika Anda tidak menyimpannya, Anda tidak dapat memulihkannya — buat key baru.
- Key dihapus atau dibuat ulang di exchange, sehingga tidak lagi cocok.
Perbaikan: masukkan kembali key dan secret dengan tepat, atau buat key baru dan coba lagi.
Error Pembatasan IP
Freya terhubung dari servernya sendiri, jadi pengaturan IP pada key itu penting. Ada dua kasus yang berbeda:
- "IP Not Whitelisted" — key Anda dibatasi berdasarkan IP, tetapi alamat server Freya tidak ada di allow-list-nya. Layar Add API Key menampilkan alamat IP yang harus ditambahkan (dengan tombol salin) — tambahkan alamat tersebut ke whitelist key di exchange.
- "Unrestricted" — key Anda tidak memiliki pembatasan IP sama sekali. Demi keamanan Anda, Freya meminta Anda untuk mengaktifkan pembatasan IP dan menambahkan alamat yang ditampilkannya, lalu coba lagi.
Dalam kedua kasus, ide perbaikannya sama: batasi key ke IP yang ditampilkan Freya di modal.
Error Izin
Key terhubung, tetapi tidak dapat melakukan apa yang dibutuhkan bot Anda:
- Baca dinonaktifkan — aktifkan izin baca/lihat pada key.
- Izin trade hilang — aktifkan trading (spot dan/atau futures, sesuai bot Anda).
- Ketidakcocokan Spot vs Futures — bot futures membutuhkan key dengan trading futures yang diaktifkan; bot spot membutuhkan trading spot. Jika Anda menambahkan key spot-saja untuk bot futures (atau sebaliknya), Freya menandainya. Pastikan pasar yang diaktifkan pada key cocok dengan bot yang Anda bangun.
Ingat: Freya hanya pernah membutuhkan izin baca dan trade — tidak pernah penarikan. Key tanpa izin penarikan justru itulah yang Anda inginkan.
Kekhususan per Exchange
- OKX membutuhkan passphrase. Ketika Anda membuat key OKX, Anda menetapkan passphrase — masukkan passphrase yang sama di Freya, persis seperti yang Anda tetapkan. Passphrase yang salah adalah penyebab kegagalan koneksi OKX yang umum.
- Setup futures OKX. Trading futures OKX membutuhkan mode akun tertentu, yang disiapkan Freya untuk Anda secara otomatis — Anda tidak perlu mengonfigurasinya secara manual.
- Mode hedge (futures). Freya menggunakan mode hedge untuk akun futures. Jika Anda sudah memiliki posisi one-way terbuka yang bertentangan, Anda mungkin melihat peringatan alih-alih kegagalan — key tetap tersimpan, dan bot Anda dapat trading setelah posisi yang ada tersebut ditutup.
- Binance dan Bybit tidak menggunakan passphrase — tidak ada kolom passphrase untuk keduanya.
"Connection Failed" Tanpa Alasan yang Jelas
Kegagalan koneksi yang umum sering kali bukan kesalahan Anda — gangguan jaringan sesaat atau exchange yang sedang sibuk sebentar. Tunggu sejenak dan coba lagi. Jika terus gagal setelah beberapa kali percobaan, periksa kembali pengaturan key/secret dan IP di atas.
Masih Bermasalah? Checklist Cepat
- Buat ulang key di exchange dengan baca + trade saja (jangan pernah penarikan).
- Batasi ke IP yang ditampilkan Freya di layar Add API Key.
- Cocokkan pasar — key spot untuk bot spot, key futures untuk bot futures.
- OKX: masukkan passphrase yang tepat.
- Masih gagal? Hubungi [email protected].
Pertanyaan yang Sering Diajukan
Freya mengatakan "Invalid API Key" tetapi saya yakin sudah menyalinnya dengan benar — apa yang salah?
Biasanya ada karakter tersembunyi atau spasi yang menyelinap ke dalam key atau secret, atau key dibuat ulang/dihapus di exchange sehingga tidak lagi cocok. Salin ulang kedua kolom dengan hati-hati, dan ingat bahwa secret hanya ditampilkan sekali saat pembuatan — jika Anda tidak memilikinya, buat key baru.
Apa perbedaan antara "IP Not Whitelisted" dan "Unrestricted"?
"IP Not Whitelisted" berarti key Anda dibatasi berdasarkan IP tetapi alamat server Freya belum diizinkan — tambahkan alamat yang ditampilkan Freya ke whitelist key. "Unrestricted" berarti key tidak memiliki pembatasan IP sama sekali; demi keamanan, Freya meminta Anda untuk mengaktifkan pembatasan IP dan menambahkan alamatnya sebelum menyimpan.
Key OKX saya tidak mau terhubung — apakah saya membutuhkan passphrase?
Ya. Key OKX memiliki passphrase yang Anda tetapkan saat membuat key. Anda harus memasukkan passphrase yang tepat itu di Freya — passphrase yang salah atau hilang adalah penyebab kegagalan koneksi OKX yang umum. Binance dan Bybit tidak menggunakannya.
Freya mengatakan key saya tidak dapat menempatkan trade — bagaimana cara memperbaikinya?
Key Anda tidak memiliki trading yang diaktifkan untuk pasar yang digunakan bot Anda. Di exchange, aktifkan izin trade — trading spot untuk bot spot, trading futures untuk bot futures — lalu hubungkan kembali. Freya membutuhkan izin baca dan trade, tidak pernah penarikan.
Key futures saya membutuhkan setup tambahan (mode akun / mode hedge) — apakah itu masalah?
Tidak. Trading futures membutuhkan mode akun dan mode hedge tertentu, yang disiapkan Freya untuk Anda secara otomatis. Jika Anda memiliki posisi one-way yang ada, Anda mungkin melihat peringatan mode hedge alih-alih error — key tetap tersimpan, dan bot Anda dapat trading setelah posisi tersebut ditutup.
Saya menambahkan key spot tetapi bot futures saya tidak mau menggunakannya (atau sebaliknya) — mengapa?
Sebuah key diaktifkan untuk pasar tertentu. Bot futures membutuhkan key dengan trading futures yang diaktifkan, dan bot spot membutuhkan trading spot. Jika keduanya tidak cocok, Freya menandainya. Hubungkan key yang pasar aktifnya cocok dengan bot yang Anda buat.
Koneksi hanya "gagal" tanpa alasan yang jelas — apakah itu dari saya atau exchange?
Sering kali itu gangguan jaringan atau exchange sesaat, bukan pengaturan Anda. Coba lagi sejenak kemudian. Jika terus gagal, periksa kembali key dan secret untuk kesalahan penyalinan dan pastikan pembatasan IP cocok dengan alamat yang ditampilkan Freya.